document-canon-cleanup

name	document-canon-cleanup
description	Use when organizing repository documents, finding non-canonical docs, separating source canon from generated reports, eval results, closed issues, duplicate headings, or stale document paths.

Document Canon Cleanup

Tool Commands

Use the command packet before applying this skill's workflow:

python3 tools/agent_tools/skill_tool_commands.py show --skill document-canon-cleanup --format text

Execute the required and task-matching conditional commands that the packet prints.

1. Read agents/skills/document-canon-cleanup.md.
2. Prefer the Rust structured-analysis command:

agent-canon structured-analysis document-inventory \
  --root . \
  --json-out reports/noncanonical-documents.json \
  --markdown-out reports/noncanonical-documents.md

1. If an old document-inventory command is observed in a caller chain, migrate that caller to the Rust command before returning to the original task.
2. Treat the report as triage, not deletion authority.
3. Edit canonical sources, not generated evidence:
   • .agent-canon/log-archive/eval-results/* -> edit eval definitions, workflow prompts, or generator logic.
   • reports/* -> regenerate or cite as run evidence.
   • issues/closed/* -> open/update a new issue for new scope.
4. For missing dependency headers, either add the manifest or move the file out of source docs.
5. For duplicate headings, merge, retitle, or document why both active docs remain distinct.
6. Re-run the inventory and dependency review before closeout.