A Spec Kit extension that provides a structured 7-step workflow for building new projects from scratch with AI assistants — from vision through implementation.

AIDE implements the AI-Driven Development Approach as a set of Spec Kit commands. It guides you through a repeatable process that transforms an idea into a production-ready application:

1. Vision — Define the overall goal (docs/aide/vision.md)
2. Roadmap — Break down the vision into staged delivery (docs/aide/roadmap.md)
3. Progress — Track completion status (docs/aide/progress.md)
4. Queue — Generate next batch of prioritized work items (docs/aide/queue/queue-NNN.md)
5. Work Item — Create detailed specification from a queue item (docs/aide/items/NNN-*.md)
6. Execute — Implement the work item and update progress
7. Feedback Loop — Reflect, adjust, and improve the process (usable at any step)

The work cycle: Steps 1–3 once at start, then repeat 4–6 until done. Step 7 whenever you need to intervene.

specify extension add aide

1. /speckit.aide.create-vision "describe your project idea here"
2. [NEW CHAT] /speckit.aide.create-roadmap
3. [NEW CHAT] /speckit.aide.create-progress
4. [NEW CHAT] /speckit.aide.create-queue
5. [NEW CHAT] /speckit.aide.create-item        (auto-picks next item, or pass a number)
6. [NEW CHAT] /speckit.aide.execute-item        (auto-picks next item, or pass a number)
7. Repeat steps 5-6 until queue is empty, then repeat from step 4

Tip: Start a fresh chat session for each step. This keeps the AI focused on the specific task at hand.

/speckit.aide.create-vision "a web-hosted platform for personal health tracking
with public blog content and private health metrics, meal planning, and recipes.
Multi-user with preference-based personalization. Built with .NET Core on Linux,
PostgreSQL, hosted on Azure App Service."

When the feedback loop updates vision, roadmap, or progress, those changes cascade into the next queue. The queue command reads directly from these documents, so any update is automatically reflected the next time you generate a queue.

The workflow creates and maintains these living documents:

your-project/
├── docs/
│   └── aide/
│       ├── vision.md            # Product vision and scope
│       ├── roadmap.md           # Staged development plan
│       ├── progress.md          # Feature tracking (📋 → 🚧 → ✅)
│       ├── queue/
│       │   ├── queue-001.md     # Prioritized work items (batch 1)
│       │   └── queue-002.md     # Next batch
│       └── items/
│           ├── 001-feature.md   # Detailed work item specs
│           └── 002-bugfix.md

Status icons: 📋 Planned · 🚧 In Progress · ✅ Complete · ⏸️ Deferred · ❌ Excluded

flowchart TD
    A[1. Create Vision] --> B[2. Create Roadmap]
    B --> C[3. Create Progress]
    C --> D[4. Create Queue<br/>~10 items per batch]
    D --> E[5. Create Item<br/>Pick item & create spec]
    E --> F[6. Execute Item<br/>Implement & update progress]

    F -->|More items<br/>in queue| E
    F -->|Queue empty| D
    F -->|All stages<br/>complete| End[Project Complete]

    A -.-> G[7. Feedback Loop]
    B -.-> G
    C -.-> G
    D -.-> G
    E -.-> G
    F -.-> G
    G -.-> A
    G -.-> B
    G -.-> C
    G -.-> D
    G -.-> E
    G -.-> F

• One Project = One Vision + One Roadmap + One Progress — these are living documents that are updated, never recreated
• Changes cascade into the next queue — updated documents are automatically reflected in the next queue generation
• Queues are sequential batches — each queue holds ~10 items; when exhausted, generate the next one
• Each step is independent — use fresh chat sessions to keep the AI focused
• The feedback loop is always available — use it at any step when you need to intervene
• Trust but verify — review AI outputs, run tests, commit incrementally

• Spec Kit >= 0.2.0

MIT