dici-spec

Intent-driven development toolkit — structured workflows, constraint enforcement, blind testing, and AI-powered spec compliance for any project.

Installation

npm install -g dici-spec
# or
npx dici-spec

Usage

Initialize a Project

dici-spec init my-project --ai cursor --stack nestjs

Creates a project with slash commands, agent files, IDE rules, and constraint YAML configured for your chosen AI agent and tech stack.

| Flag | Default | Description | |---|---|---| | --ai <agent> | cursor | AI agent (cursor, claude, copilot, codex, generic) | | --stack <preset> | generic | Tech stack preset (generic, nestjs, nextjs) | | --no-git | — | Skip git initialization | | --force | — | Force merge into non-empty directory | | --dry-run | — | Show what would be created without writing |

Add Capabilities

dici-spec add observability   # Traces + logs (Tempo/Loki)
dici-spec add gitnexus        # Code knowledge graph
dici-spec add db              # Database inspection MCP
dici-spec add spec-review     # LLM-powered spec review

Update Existing Projects

dici-spec update                  # Auto-detects agent, updates everything
dici-spec update --dry-run        # Preview changes without writing
dici-spec update --no-workflows   # Only update commands and IDE rules
dici-spec update --ai cursor      # Explicit agent override

Updates slash commands, workflow agents, and IDE rules to the latest version. Auto-detects the AI agent from your existing command files. Never touches your constitution, constraints, specs, systems, or MCP config.

| Flag | Default | Description | |---|---|---| | --ai <agent> | auto-detect | AI agent (auto-detected from existing commands) | | --no-commands | — | Skip updating slash commands | | --no-workflows | — | Skip updating workflow agents | | --no-rules | — | Skip updating IDE rules | | --dry-run | — | Show what would change without writing |

Drive from Source Document

# In your IDE, invoke the slash command with a source document attached via @:
# /dici.drive @docs/product-spec.md
# /dici.drive @docs/product-spec.md just specify and clarify
# /dici.drive @docs/product-spec.md only auth and billing features

Check Setup

dici-spec check

Export Specs

dici-spec export --mode comprehensive
dici-spec export --mode lite
dici-spec export --feature auth
dici-spec export --system payments

Requirements

• Node.js >= 18

License

MIT