feat: add target repo examples and file layout guidance
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user