AGENTS.md Update

agent_docs/

Core Rule

Section Mapping

scripts/

agent_docs/code_conventions.md

agent_docs/code_conventions.md

agent_docs/code_conventions.md

agent_docs/code_conventions.md

agent_docs/git_workflow.md

agent_docs/building_the_project.md

agent_docs/git_workflow.md

agent_docs/building_the_project.md

agent_docs/code_conventions.md

agent_docs/code_conventions.md

agent_docs/code_conventions.md

agent_docs/building_the_project.md

plans/ROADMAPS/ROADMAP_ACTIVE.md

Workflow

1. Read Current State

• Read AGENTS.md and relevant agent_docs/ files
• Check Section Mapping table
• For complex changes, use

  goap-agent

  skill to decompose

2. Move Content (Not Delete!)

• Find target location from mapping
• Add full content with examples
• Ensure standalone usability

3. Update AGENTS.md

• Replace with brief summary + reference link
• Keep under 140 LOC

4. Validate

wc -l AGENTS.md  # Must be ≤140
ls agent_docs/   # Verify all files exist

Quality Checks

• wc -l AGENTS.md

  ≤ 140
• All sections mapped to agent_docs/
• agent_docs/ files have code examples
• Can follow agent_docs/ instructions independently
• Cross-References table lists all agent_docs/

Best Practices

• Follow agentskills.io spec
• Keep SKILL.md under 250 LOC
• agent_docs/ files must be usable as standalone instructions