From f0d2fa1978a71c41534355f9c7581bcb6c4d640c Mon Sep 17 00:00:00 2001
From: Research Assistant <research@example.com>
Date: Fri, 24 Apr 2026 18:06:55 +0800
Subject: [PATCH] docs(phase-10): add consistency checklist

- Add docs/CONSISTENCY-CHECKLIST.md for manual soft-constraint review
- Covers terminology, commands, cross-references, version references
- Includes style, branding, and platform notes verification
---
 docs/CONSISTENCY-CHECKLIST.md | 69 +++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 docs/CONSISTENCY-CHECKLIST.md

diff --git a/docs/CONSISTENCY-CHECKLIST.md b/docs/CONSISTENCY-CHECKLIST.md
new file mode 100644
index 00000000..17698a51
--- /dev/null
+++ b/docs/CONSISTENCY-CHECKLIST.md
@@ -0,0 +1,69 @@
+# Consistency Checklist
+
+> Manual review checklist for soft constraints that cannot be fully automated.
+> Run this before each release, alongside `scripts/consistency_audit.py`.
+
+---
+
+## Terminology
+
+- [ ] "PaperForge Lite" used correctly (product name, not "Paperforge" or "Paper Forge")
+- [ ] "Zotero" capitalized correctly
+- [ ] "Obsidian" capitalized correctly
+- [ ] "PaddleOCR" capitalized correctly
+- [ ] "Better BibTeX" capitalized correctly
+- [ ] Chinese terms consistent (e.g., "精读" not "深度阅读" in one place and "精读" in another)
+
+## Commands
+
+- [ ] All CLI examples use `paperforge` (not `paperforge_lite`)
+- [ ] All Agent examples use `/pf-*` (not `/LD-*` or `/lp-*`)
+- [ ] Old commands only appear in migration guide (`docs/MIGRATION-v1.2.md`) and historical docs (`.planning/`)
+- [ ] `python -m paperforge` fallback documented where relevant
+
+## Cross-References
+
+- [ ] All internal links work (verified by `scripts/consistency_audit.py` Check 3)
+- [ ] All `command/*.md` files linked from `docs/COMMANDS.md`
+- [ ] `docs/ARCHITECTURE.md` referenced from `README.md`
+- [ ] `docs/MIGRATION-v1.2.md` referenced from `README.md` or `AGENTS.md`
+- [ ] `AGENTS.md` referenced from all command docs
+
+## Version References
+
+- [ ] All docs reference v1.2 (not v1.1 or v1.0)
+- [ ] Setup instructions reference current version
+- [ ] `paperforge status` output example uses v1.2
+
+## Style
+
+- [ ] Headers use consistent capitalization (sentence case or title case, not mixed)
+- [ ] Code blocks have language tags (```bash, ```python, ```markdown)
+- [ ] Tables are properly formatted (aligned columns, consistent delimiters)
+- [ ] Frontmatter in generated notes uses consistent field names
+- [ ] Callouts use consistent syntax (`> [!NOTE]`, `> [!WARNING]`)
+
+## Branding
+
+- [ ] README.md uses correct product name "PaperForge Lite"
+- [ ] `AGENTS.md` uses correct product name
+- [ ] Command docs use correct product name
+- [ ] No references to deprecated package name `paperforge_lite` in user-facing docs
+
+## Platform Notes
+
+- [ ] All `command/*.md` files have "Platform Notes" section
+- [ ] OpenCode-specific instructions are present
+- [ ] Codex/Claude Code future support is noted where applicable
+
+## Review Sign-Off
+
+| Reviewer | Date | Result |
+|----------|------|--------|
+|          |      | [ ] Pass / [ ] Fail |
+
+**Notes:**
+
+---
+
+*PaperForge Lite | Consistency Checklist | For maintainers and release managers*