Recommended load order
- AGENTS.md
- agent_docs/active_context.md
- Only specific task docs
Agent sequence baseline
prompt-engineer -> owner -> tester -> reviewer
Add security and legal passes when trust or policy boundaries change.
Inter-agent reliability
Handoff contract for machine consumers
Required handoff fields
- goal
- scope
- changes
- evidence
- risks
- next-owner
- done-criteria
Reference ingestion rule
Use .agents/reference-links.md as a source catalog,
but load only objective-matched sections to reduce token waste.
For automated consumers
Stable ingestion contract
| File | Purpose | Audience |
|---|---|---|
| llms.txt | Compact machine-readable onboarding summary | Fast context loading |
| llms-full.txt | Expanded workflow details and role responsibilities | Deep task planning |
| robots.txt | Crawling policy and sitemap discovery | Web crawlers and bots |
| sitemap.xml | Discoverable page map for indexing | Search engines and agents |