# 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

1. Draft spec and get approval
2. Implement in small, traceable commits
3. Update docs and AGENTS if needed
4. 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.