1.3 KiB
1.3 KiB
Documentation Guide
Documentation Files
| File | Purpose | When to Update |
|---|---|---|
AGENTS.md |
Code conventions, commands, architecture, AI agent workflow | Adding patterns, changing conventions, modifying structure, updating agent workflow |
README.md |
Setup instructions, API reference, features list | New endpoints, config changes, new features, technology stack changes |
project.md |
Requirements, data model, functional specifications | Business logic changes, new entities, validation rules, UI requirements |
DOCS.md |
Documentation standards and index | Documentation process changes, new documentation files |
Documentation Standards
- Use Markdown formatting
- Keep entries concise and actionable
- Use code blocks for commands and examples
- Match existing tone and style
- Maintain logical ordering in lists
Maintenance Rules
AI Agents Must Update Documentation When:
- Adding new code patterns or conventions
- Modifying API endpoints or configuration
- Changing business logic or data models
- Adding new features or entities
Review Checklist
- Documentation reflects code changes
- Examples are accurate and tested
- Formatting is consistent
- No outdated information remains