AGENTS.md (Plans)
Folder Map (edit when requested)
docs/plans/
├── inventory/
├── sales/
├── finance/
└── ...
Spec-Driven Development
All work starts from a spec. Use a structured spec to guide implementation, review, and testing.
spec.md Format
# Title
## Summary
[One paragraph describing the change]
## Goals
- [Goal 1]
- [Goal 2]
## Non-Goals
- [Explicit exclusions]
## Design
[Architecture and flow]
## Data & API Impact
- Tables/fields touched
- Endpoints added/changed
## Security & Privacy
- Threats
- Mitigations
## Testing
- Unit tests
- Integration tests
- Manual checks
## Rollout
- Migration steps
- Feature flags
- Backout plan
Workflow
- Draft spec and get approval
- Implement in small, traceable commits
- Update docs and AGENTS if needed
- Validate against the spec before merge
Plan Grouping
Specs are grouped by module using subdirectories:
docs/plans/
├── inventory/
├── sales/
├── finance/
└── ...
Add new module folders as needed and update the module list in docs/plans/AGENTS.md.