# AI-Assisted Spec-Driven Development

AI tool agnostic Spec Driven Development implementation

## Project Memory
Project memory keeps persistent guidance (steering, specs notes, component docs) so Codex honors your standards each run. Treat it as the long-lived source of truth for patterns, conventions, and decisions.

- Use `{{SDD_DIR}}/steering/` for project-wide policies: architecture principles, naming schemes, security constraints, tech stack decisions, api standards, etc.
- Use local `AGENTS.md` files for feature or library context (e.g. `src/lib/payments/AGENTS.md`): describe domain assumptions, API contracts, or testing conventions specific to that folder. Codex auto-loads these when working in the matching path.
- Specs notes stay with each spec (under `{{SDD_DIR}}/specs/`) to guide specification-level workflows.

## Project Context

### Paths
- Steering: `{{SDD_DIR}}/steering/`
- Specs: `{{SDD_DIR}}/specs/`

### Steering vs Specification

**Steering** (`{{SDD_DIR}}/steering/`) - Guide AI with project-wide rules and context
**Specs** (`{{SDD_DIR}}/specs/`) - Formalize development process for individual features

### Active Specifications
- Check `{{SDD_DIR}}/specs/` for active specifications
- Use `/prompts:sdd-spec-status [feature-name]` to check progress

## Development Guidelines
{{DEV_GUIDELINES}}

## Minimal Workflow
- Phase 0 (optional): `/prompts:sdd-steering`, `/prompts:sdd-steering-custom`
- Phase 1 (Specification):
  - `/prompts:sdd-spec-init "description"`
  - `/prompts:sdd-spec-requirements {feature}`
  - `/prompts:sdd-validate-gap {feature}` (optional: for existing codebase)
  - `/prompts:sdd-spec-design {feature} [-y]`
  - `/prompts:sdd-validate-design {feature}` (optional: design review)
  - `/prompts:sdd-spec-tasks {feature} [-y]`
- Phase 2 (Implementation): `/prompts:sdd-spec-impl {feature} [tasks]`
  - `/prompts:sdd-validate-impl {feature}` (optional: after implementation)
- Progress check: `/prompts:sdd-spec-status {feature}` (use anytime)

## Development Rules
- 3-phase approval workflow: Requirements → Design → Tasks → Implementation
- Human review required each phase; use `-y` only for intentional fast-track
- Keep steering current and verify alignment with `/prompts:sdd-spec-status`
- Follow the user's instructions precisely, and within that scope act autonomously: gather the necessary context and complete the requested work end-to-end in this run, asking questions only when essential information is missing or the instructions are critically ambiguous.

## Steering Configuration
- Load entire `{{SDD_DIR}}/steering/` as project memory
- Default files: `product.md`, `tech.md`, `structure.md`
- Custom files are supported (managed via `/prompts:sdd-steering-custom`)
