> ## Documentation Index
> Fetch the complete documentation index at: https://specs.md/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install specs.md and select your development flow

## Prerequisites

* Node.js 18 or higher
* An AI coding tool (Claude Code, Cursor, GitHub Copilot, or Google Antigravity)

## Install specs.md

> [!NOTE]
>
> Always use npx to get the latest version. Do not install globally with npm.

```bash theme={null}
npx specsmd@latest install
```

## Select Your Flow

During installation, you'll be prompted to select a development flow:

```
? Select a development flow:
  Simple - Spec generation only (requirements, design, tasks)
❯ FIRE - Adaptive execution, brownfield & monorepo ready
  AI-DLC - Full methodology with DDD (comprehensive checkpoints)
```

| Flow | Best For | Agents |
| - | - | - |
| **Simple** | Quick specs, prototypes, handoff | 1 |
| **FIRE** | Adaptive execution, brownfield, monorepos | 3 |
| **AI-DLC** | Full traceability, comprehensive documentation | 4 |

> [!NOTE]
>
> **Not sure which flow?** Check out our [Choose Your Flow](https://specs.md/architecture/choose-flow.md) guide.

The installer automatically detects your AI coding tools and sets up:

> [card] Agent Definitions
>
> Specialized agents for your selected flow

> [card] Standards
>
> Project guidelines and conventions

> [card] Slash Commands
>
> Easy agent invocation commands

## What Gets Installed

After installation, you'll see the following structure based on your selected flow:

> [tab] Simple Flow
>
> ```
> .specsmd/
> ├── manifest.yaml              # Installation manifest
> └── simple/                    # Simple flow
>     └── agents/                # Single agent
>
> specs/                         # Your specs will go here
> └── (feature folders)
> ```

> [tab] FIRE Flow
>
> ```
> .specsmd/
> ├── manifest.yaml              # Installation manifest
> └── fire/                      # FIRE flow
>     ├── agents/                # Orchestrator, Planner, Builder
>     └── skills/                # Agent capabilities
>
> .specs-fire/                   # Project artifacts
> ├── state.yaml                 # Central state tracking
> ├── standards/                 # Project standards
> ├── intents/                   # Intent documentation
> ├── runs/                      # Run logs
> └── walkthroughs/              # Generated documentation
> ```

> [tab] AI-DLC Flow
>
> ```
> .specsmd/
> ├── manifest.yaml              # Installation manifest
> └── aidlc/                     # AI-DLC flow
>     ├── agents/                # Master, Inception, Construction, Operations
>     ├── skills/                # Agent capabilities
>     ├── templates/             # Artifact templates
>     └── memory-bank.yaml       # Memory bank schema
>
> memory-bank/                   # Project artifacts
> ├── standards/                 # Project standards
> ├── intents/                   # Intent documentation
> └── bolts/                     # Bolt tracking
> ```

## Tool-Specific Setup

> [tab] Claude Code
>
> Slash commands are installed in `.claude/commands/`. Type `/` to see available commands:
>
> ![Claude Code Commands](https://mintcdn.com/fabriqa/6LRrPGcNemP1FsGv/images/claude-code-commands.png?fit=max\&auto=format\&n=6LRrPGcNemP1FsGv\&q=85\&s=96b16bd2fde2b591b9e4c2b5f9cb37fa)
>
> **Simple Flow:**
>
> * `/specsmd-agent`
>
> **FIRE Flow:**
>
> * `/specsmd-fire`
> * `/specsmd-fire-planner`
> * `/specsmd-fire-builder`
>
> **AI-DLC Flow:**
>
> * `/specsmd-master-agent`
> * `/specsmd-inception-agent`
> * `/specsmd-construction-agent`
> * `/specsmd-operations-agent`

> [tab] Cursor
>
> Commands are installed in `.cursor/commands/` as `.md` files. Invoke them by typing `/` followed by the command name:
>
> ![Cursor Commands](https://mintcdn.com/fabriqa/kBOZJsPeJXR9TpAl/images/cursor-commands.png?fit=max\&auto=format\&n=kBOZJsPeJXR9TpAl\&q=85\&s=8df163925454300b41f52d3d2e777d15)
>
> **Simple Flow:**
>
> * `/specsmd-agent`
>
> **FIRE Flow:**
>
> * `/specsmd-fire`
> * `/specsmd-fire-planner`
> * `/specsmd-fire-builder`
>
> **AI-DLC Flow:**
>
> * `/specsmd-master-agent`
> * `/specsmd-inception-agent`
> * `/specsmd-construction-agent`
> * `/specsmd-operations-agent`

> [tab] GitHub Copilot
>
> Agents are installed in `.github/agents/` using `.agent.md` format. Type `/` to see available commands:
>
> ![GitHub Copilot Commands](https://mintcdn.com/fabriqa/IJAj_DDKxx_KoXYQ/images/copilot-commands.png?fit=max\&auto=format\&n=IJAj_DDKxx_KoXYQ\&q=85\&s=503b52e5090f91d03b3507f08378e36f)
>
> **Simple Flow:**
>
> * `/specsmd-agent`
>
> **FIRE Flow:**
>
> * `/specsmd-fire`
> * `/specsmd-fire-planner`
> * `/specsmd-fire-builder`
>
> **AI-DLC Flow:**
>
> * `/specsmd-master-agent`
> * `/specsmd-inception-agent`
> * `/specsmd-construction-agent`
> * `/specsmd-operations-agent`

> [tab] Google Antigravity
>
> Workflows are installed in `.agent/workflows/` as `.md` files. Type `/` to see available commands:
>
> ![Google Antigravity Commands](https://mintcdn.com/fabriqa/UeGaXnqiEROgpzxa/images/antigravity-commands.png?fit=max\&auto=format\&n=UeGaXnqiEROgpzxa\&q=85\&s=55c9d92226db01119a73a9f8c75634f8)
>
> **Simple Flow:**
>
> * `/specsmd-agent`
>
> **FIRE Flow:**
>
> * `/specsmd-fire`
> * `/specsmd-fire-planner`
> * `/specsmd-fire-builder`
>
> **AI-DLC Flow:**
>
> * `/specsmd-master-agent`
> * `/specsmd-inception-agent`
> * `/specsmd-construction-agent`
> * `/specsmd-operations-agent`

## Next Steps

> [card] [Simple Quick Start](https://specs.md/simple-flow/quick-start.md)
>
> Generate specs in minutes

> [card] [FIRE Quick Start](https://specs.md/fire-flow/quick-start.md)
>
> Ship your first feature fast

> [card] [AI-DLC Quick Start](https://specs.md/getting-started/quick-start.md)
>
> Full methodology walkthrough


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.