Inject Spec-Driven Development into AI coding tools without building a new UI.

spec-driven-steroids is a CLI plus template bundle for running a strict workflow inside AI coding tools:

requirements → design → tasks → implementation

It injects:

• Platform-specific agents, commands, or workflows
• Universal writing/implementation skills
• CLI validation commands for spec structure and traceability
• A knowledge graph for architectural decisions and business rules

npm install -g spec-driven-steroids

Requirements:

• Node.js >=20
• pnpm for local development

The CLI provides two command names:

• sds (short alias - recommended)
• spec-driven-steroids (full name)

# Interactive injection (prompts for platform and scope)
sds inject

# Validate spec folder structure
sds validate structure <slug>

# Validate EARS requirements
sds validate requirements <path>

# Validate design structure and Mermaid
sds validate design <path>

# Validate task structure and traceability
sds validate tasks <path>

# Full end-to-end validation
sds validate spec <slug>

# Clean globally injected steroids
sds clean --global

# Show version
sds --version

# Show help
sds --help

Manage a knowledge graph of architectural decisions, business rules, and workflow conventions extracted from spec files:

# Report available stewardship capabilities
sds stewardship capabilities

# Search for rules in the knowledge graph
sds stewardship retrieve <query> --domain architecture [--scope <project-id>] [--global]

# Persist a project-scoped rule by default
sds stewardship store architecture --content "Use hexagonal architecture"

# Persist a truly universal rule
sds stewardship store workflow --content "Run typecheck before completion" --global

# Extract decision candidates from a design.md or requirements.md
sds stewardship extract .specs/changes/my-feature/design.md

# Show rule provenance and version history
sds stewardship trace <ruleId> [--scope <project-id>] [--global]

# Retrieve context for a spec phase
sds stewardship inject design [--scope <project-id>] [--global]

# List, deprecate, archive, or move rules
sds stewardship manage list
sds stewardship manage deprecate --ruleId <ruleId> [--scope <project-id>] [--global]
sds stewardship manage move --ruleId <ruleId> --scope <project-id>

Rules are project-scoped by default and only fall back to global rules during retrieval. Use --global only for memories that are safe across unrelated repositories.

The CLI injects these universal skills that work across all platforms:

Spec-Driven planning writes artifacts to:

.specs/changes/<slug>/
├── requirements.md
├── design.md
└── tasks.md

1. Requirements - EARS-syntax requirements with stable IDs
2. Design - Mermaid diagrams, architecture sections
3. Tasks - Atomic implementation tasks with traceability
4. Implementation - Task execution with verification

1. Inject platform files into a repository:

sds inject

2. Generate project guidance:

/inject-guidelines

This creates: AGENTS.md, CONTRIBUTING.md, STYLEGUIDE.md, TESTING.md, ARCHITECTURE.md, SECURITY.md

3. Start the spec flow:

• GitHub Copilot: @spec-driven Add a rate limiter
• OpenCode: use the Spec-Driven agent
• Cline: use the Spec-Driven agent or /spec-driven
• Antigravity: /spec-driven
• Codex: select the spec-driven skill with /skills or mention $spec-driven

4. Approve each planning phase, then move to implementation.

For complex long-running tasks, SDS injects long-running-work-planning. It keeps agents working through durable artifacts, task status updates, checkpoints, and verification.

packages/
├── cli/                    # Main CLI package
│   ├── src/
│   │   ├── cli/           # Injection commands
│   │   ├── core/validate/ # Validation modules
│   │   └── context-stewardship/ # Knowledge graph
│   └── templates/          # Platform templates & skills
├── test-utils/             # Test fixtures and mocks
└── landing-page/         # Documentation site

pnpm install
pnpm build
pnpm test

Useful commands:

• pnpm typecheck - Type check all packages
• pnpm lint - Lint all packages
• pnpm test:coverage - Run tests with coverage
• pnpm changeset - Create a changeset
• pnpm changeset:version - Version bump

• AGENTS.md - AI agent guidance
• CONTRIBUTING.md - PR process
• STYLEGUIDE.md - Code conventions
• TESTING.md - Testing strategy
• ARCHITECTURE.md - System architecture
• SECURITY.md - Security policy

MIT