Name: docs:sync
Author: helalifaker

Prompt file imported from helalifaker/budfin (.codex/prompts/docs.sync.md). Copyright stays with the author.

Load .claude/skills/docs-governance/SKILL.md and follow it.

Parse the arguments:

--audit: inventory and recommendations only; do not modify files
--deep: spend extra time reading candidate duplicates before deciding
path: optional scope, defaults to docs

If no path is provided, use docs.

Step 1: Build inventory

Run:

python3 .claude/skills/docs-governance/scripts/inventory_docs.py --root . --scope [path]

If --audit is present, stop after reporting findings and recommendations.

Step 2: Confirm the policy inputs

Read:

docs/README.md
docs/tdd/00_document_governance.md
.claude/skills/docs-governance/references/doc-taxonomy.md

Then read only the candidate files needed to confirm:

archive candidates
misclassified documents
exact or similar duplicates
broken or stale links caused by moves

If --deep is present, inspect every duplicate group before applying changes.

Step 3: Apply only safe cleanup changes

Allowed changes:

move a clearly misplaced document into the correct live folder
move a clearly superseded working document to docs/archive/<category>/<year>/
update links or indexes that break because of a move
update docs/README.md if examples or taxonomy notes need to stay accurate

Do not:

delete documentation files
archive docs/prd/, docs/tdd/, docs/adr/, docs/specs/, or docs/ui-ux-spec/ unless the user explicitly asks
merge ambiguous duplicates without confirming which document is authoritative

Step 4: Re-run the inventory

Run the inventory again for the same scope and confirm the cleanup improved the result.

Step 5: Report

Always report:

inventory summary
files moved or archived
duplicate groups left unresolved
any legacy naming or taxonomy issues that should be handled later

{ "prompt": "Load `.claude/skills/docs-governance/SKILL.md` and follow it.\n\nParse the arguments:\n\n- `--audit`: inventory and recommendations only; do not modify files\n- `--deep`: spend extra time reading candidate duplicates before deciding\n- `path`: optional scope, defaults to `docs`\n\nIf no path is provided, use `docs`.\n\n## Step 1: Build inventory\n\nRun:\n\n```bash\npython3 .claude/skills/docs-governance/scripts/inventory_docs.py --root . --scope [path]\n```\n\nIf `--audit` is present, stop after reporting findings and recommendations.\n\n## Step 2: Confirm the policy inputs\n\nRead:\n\n1. `docs/README.md`\n2. `docs/tdd/00_document_governance.md`\n3. `.claude/skills/docs-governance/references/doc-taxonomy.md`\n\nThen read only the candidate files needed to confirm:\n\n- archive candidates\n- misclassified documents\n- exact or similar duplicates\n- broken or stale links caused by moves\n\nIf `--deep` is present, inspect every duplicate group before applying changes.\n\n## Step 3: Apply only safe cleanup changes\n\nAllowed changes:\n\n- move a clearly misplaced document into the correct live folder\n- move a clearly superseded working document to `docs/archive/<category>/<year>/`\n- update links or indexes that break because of a move\n- update `docs/README.md` if examples or taxonomy notes need to stay accurate\n\nDo not:\n\n- delete documentation files\n- archive `docs/prd/`, `docs/tdd/`, `docs/adr/`, `docs/specs/`, or `docs/ui-ux-spec/` unless the user explicitly asks\n- merge ambiguous duplicates without confirming which document is authoritative\n\n## Step 4: Re-run the inventory\n\nRun the inventory again for the same scope and confirm the cleanup improved the result.\n\n## Step 5: Report\n\nAlways report:\n\n1. inventory summary\n2. files moved or archived\n3. duplicate groups left unresolved\n4. any legacy naming or taxonomy issues that should be handled later", "variables": [], "notes": "Audit and maintain BudFin documentation using the repo-local docs-governance skill. Inventories docs, classifies misplaced files, flags duplicates, archives clearly superseded working docs, and updates links or indexes as needed. Use `--audit` for a read-only pass or omit it to apply only safe cleanup changes. Usage - /docs:sync [--audit] [--deep] [path] Tools: Read, Edit, Bash, Grep, Glob. Arguments: [--audit] [--deep] [path].", "metadata": { "source": { "provider": "github-codex-prompts", "repository": "https://github.com/helalifaker/budfin", "path": ".codex/prompts/docs.sync.md", "ref": "0ae459d12324d9c929baa7b09f783f5bc53911c6", "url": "https://github.com/helalifaker/budfin/blob/0ae459d12324d9c929baa7b09f783f5bc53911c6/.codex/prompts/docs.sync.md", "key": "helalifaker/budfin/.codex/prompts/docs.sync.md" } } }

docs:sync

About

Step 1: Build inventory

Step 2: Confirm the policy inputs

Step 3: Apply only safe cleanup changes

Step 4: Re-run the inventory

Step 5: Report

Use it

Manifest

Reviews