AGENTS.md Retrospective
Make instruction updates only when the pattern is durable.
Workflow
- Read the relevant local and global instruction files.
- Identify the exact repeated failure or missing rule.
- Add the smallest durable instruction that would have prevented it.
- Avoid duplicating existing rules.
- Validate by grepping the final instruction and checking for conflicts.
Rules
- Do not add secrets or environment-specific sensitive values.
- Do not turn AGENTS.md into a skill body.
- Prefer routing rules and validation commands over broad role prose.
- Respect scoped directory instructions.
Output
- changed instruction file
- rule added or changed
- why it belongs there
- validation command