AGENTS.md Refactor
Goal
Restructure agent instruction files into a small, universal root plus linked, self-contained topic docs.
Guardrails
- Resolve contradictions before reorganizing content.
- Keep root file short (target under ~80 lines).
- Put specifics (language, testing, style) in linked docs, not the root.
- Prefer a hidden folder
.agents/unless the repo already uses another convention.
Workflow (short)
- Scan for contradictions and ask for precedence.
- Extract root essentials and links only.
- Group remaining guidance into 3–8 topic docs.
- Create files and link from root.
- Prune vague or redundant statements.
- Verify links, coverage, and self-contained topics.
References (load when needed)
agents-md-refactor/references/templates.md: root and topic doc templates.agents-md-refactor/references/checklist.md: execution and verification checklist.agents-md-refactor/references/triage.md: contradiction patterns and resolution prompts.