Goal
Update AGENTS.md when the repo changes so guidance stays accurate:
- Golden commands still work
- CI gates reflect current workflows
- Repo map stays correct
When to use
- A workflow file changed under
.github/workflows/ - Build/test scripts changed (package.json, makefiles, dotnet tooling)
- Repo structure changed (new apps/services)
AGENTS.mdcontains stale placeholders or incorrect commands
Process
- Read the current
AGENTS.md(workspace root and/or repo root). - Re-discover:
- Commands from scripts/tooling
- CI gates from
.github/workflows/* - New/removed key folders
- Update the file conservatively:
- Keep the same section structure (unless it's missing key sections)
- Replace incorrect commands; remove duplicates
- Convert vague placeholders into explicit
TODO:items
- Validate locally where possible (at least sanity-check command existence).
- If a critical command cannot be inferred (especially Run/Dev), ask the user for it.
Hard rules
- Do not invent workflows that do not exist.
- Keep it short; link to docs instead of copying.
- Keep security guidance (no secrets; least privilege).
- Ensure the wrap-up checklist exists.
Finish with:
- What changed in AGENTS.md
- Why it changed (what in the repo/CI triggered it)
- Any remaining TODOs/questions