superspecs

Quick Start

Install

# Install globally
npm install -g superspecs
 
# Run in your project to symlink skills into all your AI agents
cd your-project
superspecs install
 
# Or without a global install
npx superspecs install

Then open your agent and say: "Tell me about your superspecs"

Command format by agent

  • Claude Code / Cursor: /superspecs:techstack
  • OpenCode / Aider: /superspecs-techstack

Wiki as Obsidian vault — after superspecs install, open superspec/wiki/ in Obsidian as a vault. Graph view, backlinks, and tag search work out of the box.

First Feature

/superspecs:techstack    Define stack, get skill & library recommendations
/superspecs:discuss      What are we building and why?
/superspecs:spec         Write the spec
/superspecs:grill        Stress-test spec against wiki + techstack
/superspecs:pick-spec    Confirm it fits a clean context
/superspecs:branch       Create worktree
/superspecs:subagent     Start execution (TDD runs inside each task)
/superspecs:tdd          Standalone: enforce RED-GREEN-REFACTOR outside subagent
/superspecs:code-review  Check between tasks
/superspecs:check-tests  Verify everything passes
/superspecs:wiki         Distill to knowledge base
/superspecs:ship         PR + archive