feat: add target repo examples and file layout guidance

This commit is contained in:
2026-04-29 21:55:22 +08:00
parent c507e52dc1
commit 5c80bc12fd
17 changed files with 253 additions and 3 deletions

View File

@@ -66,6 +66,18 @@ Depending on the request, create or update one or more of:
Prefer short, maintainable files over one giant document.
## Target-repo file roles
Use these roles by default:
- `AGENTS.md`: the shortest practical working guide; key commands, constraints, and major repo structure
- `ai/project-map.md`: directory responsibilities, entrypoints, and important data or control flow notes
- `ai/task-templates.md`: reusable task request formats for bugfix, feature, refactor, migration, and test-writing work
- `ai/risk-guardrails.md`: high-risk areas, forbidden changes, slow validations, generated files, and deployment-sensitive zones
- `ai/harness-health.md`: current harness audit snapshot and next improvement priorities
If the repo is small, keep most content in `AGENTS.md` and delay the extra files until needed.
## Update policy
Prefer targeted edits over full rewrites.