Skip to main content

Prerequisites

  • Node.js 18+ installed
  • An AI coding tool (Claude Code, Cursor, GitHub Copilot, etc.)
  • A feature idea to spec out

Installation

Select Simple when prompted for the SDLC flow. The installer will:
  1. Detect available agentic coding tools (Claude Code, Cursor, Kiro, etc.)
  2. Install the spec agent and skills
  3. Set up slash commands for your tools

Your First Spec

Step 1: Create a New Spec

Open your AI coding tool and invoke the agent:
The agent will:
  1. Derive a feature name (todo-app)
  2. Generate a requirements document
  3. Ask for your approval

Step 2: Review Requirements

The agent generates:
To approve: Say “yes”, “approved”, or “looks good” To revise: Provide specific feedback

Step 3: Review Design

After approval, the agent generates a technical design:

Step 4: Review Tasks

After design approval:

Step 5: Execute Tasks

Once tasks are approved:
The agent executes one task, then waits for your review.

Commands Reference


File Structure

After installation:

Tips for Success

Good: “User auth with email/password and session management”Too vague: “Login feature”The more specific you are, the better the generated specs.
Checkpoint tasks run the test suite. Don’t skip them—they catch issues early.
The agent pauses after each task for review. If you’re happy with progress, tell it to keep going (e.g., “continue until done”, “go yolo”).

Troubleshooting

The agent is stateless—it reads spec files at startup. Ensure documents are saved after each step.
Run /specsmd-agent without arguments to see all specs and choose which to work on.
Delete the spec folder:
If your feature idea is too vague, the agent will ask a clarifying question before generating. Provide more specific details.

Next Steps

Three Phases

Deep dive into Requirements, Design, and Tasks

Compare with AI-DLC

When to use Simple Flow vs full AI-DLC