superclaude

Bootstrap specialist AI agents into any project, then launch Claude Code.

Install

npm install -g superclaude

Usage

cd your-project/
superclaude

That's it. superclaude creates the agent files in your project directory and launches claude.

All arguments are passed through to claude:

superclaude "fix the login bug"      # launch with a prompt
superclaude --resume                 # resume a previous session
superclaude --model opus             # pick a model

What it creates

your-project/
  CLAUDE.md              ← Orchestrator rules (how agents coordinate)
  PROJECT_BIBLE.md       ← Living knowledge base
  .agents/
    drift.md             ← Drift Detective
    dependency.md        ← Dependency Sentinel
    bible.md             ← Project Bible keeper

Safe to run repeatedly — existing files are never overwritten.

The Agents

Drift Detective

Detects configuration drift between your intended state (code, config, docker-compose) and the actual running environment. Run it before deploys or after infrastructure changes.

"Run the Drift Detective on the current environment."

Dependency Sentinel

Audits dependency health across all services — security vulnerabilities, outdated packages, license issues. Supports npm, pip, Go modules, Cargo, Bundler, Composer, and more.

"Run the Dependency Sentinel across all services."

Project Bible

Maintains PROJECT_BIBLE.md as a living record of architecture decisions, completed features, incidents, and conventions. Keeps institutional knowledge from getting lost.

"Update the Project Bible based on what was just done."

Orchestrator Rules

The generated CLAUDE.md enforces these rules across all agents:

1. Never modify production databases without explicit confirmation
2. Never push to git without running tests first
3. If a task is ambiguous, write a CLARIFY.md listing questions — don't guess
4. Log all significant actions to PROJECT_BIBLE.md via the Bible agent
5. Prefer reversible changes; flag irreversible ones
6. Each agent stays within its defined scope

Requirements

• Claude Code (npm install -g @anthropic-ai/claude-code)
• Node.js >= 18

License

MIT