Ge Song
0987c0bf0e
Restructure SKILL.md with clear triage workflow and reference selection guide. Add dedicated linking-patterns.md reference with preferred patterns and anti-patterns. Update root-agents-template.md and refactor-checklist.md to match new structure. Expand agent interface description to include refactoring and cleanup scope.
1.2 KiB
1.2 KiB
Refactor Checklist
Use this checklist after changing the root AGENTS.md or any file in agent-docs/.
- Does each covered document own one clear topic?
- Does each filename clearly express the document's purpose?
- Does each opening explain purpose, trigger, and that the document must be followed in scope?
- Is the root
AGENTS.mdstill the starting point for requiredagent-docs? - Does every active
agent-docs/file have an explicit path from the root? - Does each child doc use the right shape for its job: rule doc versus inventory doc?
- Did you remove stale references, filenames, and replaced paths?
- Did you delete or update any
agent-docsfile that is no longer referenced from the rootAGENTS.md? - Did you avoid duplicating the same rule across multiple active docs?
- Did you avoid mixing long entry inventories into rule docs when a separate inventory would be clearer?
- Is the default path basis still the root of the current Git working tree unless explicitly overridden?
- Are repository-wide constraints still in the root file?
- Are topic-specific constraints still in child docs?
- Did you keep reference depth minimal?
- If the repository has a validation command, did you run it?