turbocharge

Turbocharge streamlines your development process with a unified pipeline of skills and agents.

<p align="center"> <img src="images/hero-banner-v2.svg" alt="turbocharge — one plugin, one pipeline, no conflicts" width="100%"> </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square&color=58a6ff&labelColor=0d1117" alt="MIT License"></a> <img src="https://img.shields.io/badge/claude_code-plugin-7c3aed.svg?style=flat-square&labelColor=0d1117" alt="Claude Code Plugin"> <img src="https://img.shields.io/badge/skills-10-3b82f6.svg?style=flat-square&labelColor=0d1117" alt="10 Skills"> <img src="https://img.shields.io/badge/agents-6-8b5cf6.svg?style=flat-square&labelColor=0d1117" alt="6 Agents"> </p>

You have 6 agents in ~/.claude/agents/, 4 custom commands, 3 rule files that contradict each other, and a planner-actually-good.md you wrote at 2 AM. Claude picks whichever it finds first. You can't remember which is current. Neither can Claude.

Turbocharge replaces all of it with a single opinionated pipeline: 10 skills, 6 agents, 2 hooks. One system to install, nothing to maintain.

Install

claude plugin marketplace add nicodiansk/turbocharge
claude plugin install turbocharge@turbocharge

Restart Claude Code, then start building:

/turbocharge:brainstorm I want to build a CLI tool that manages git worktrees
<details> <summary>Other install methods</summary>

Local development (per-session):

claude --plugin-dir ./turbocharge

Update:

claude plugin update turbocharge@turbocharge
</details>

The Pipeline

brainstorm → story → plan → build → review → ship
                                ↑
                              debug

Enter at any step. Each skill gates the next. debug loops under build when bugs surface.

wrap stands alone — run it any time to capture session state, decisions, and a resume prompt for your next session.

atlas stands alone — generates ATLAS.md domain map from the actual codebase. Pre-loaded every session for zero-tool-call navigation.

SkillCommandWhat it does
setup/turbocharge:setupAudits config for conflicting agents/skills/rules. Bootstraps CLAUDE.md.
atlas/turbocharge:atlasGenerates ATLAS.md domain map. Pre-loaded every session.
brainstorm/turbocharge:brainstormSocratic requirements discovery before implementation
story/turbocharge:storyINVEST-compliant story breakdown with acceptance criteria
plan/turbocharge:planBite-sized task decomposition — 2-5 min tasks, exact paths, complete code
build/turbocharge:buildPlan execution with builder → spec-reviewer → quality-reviewer chain
review/turbocharge:reviewHolistic pre-merge code review against the original plan
debug/turbocharge:debugSystematic 4-phase root-cause investigation — no fix until cause is proven
ship/turbocharge:shipTest verification, then merge / PR / keep / discard
wrap/turbocharge:wrapSession continuity — captures state, generates resume prompt

How Build Works

Every task goes through a mandatory review chain. You can't mark a task complete without passing both reviewers.

builder → spec-reviewer → quality-reviewer
             ↓ issues?        ↓ issues?
        back to builder   back to builder
         (max 2 cycles)    (max 2 cycles)

Every 3 tasks, the pipeline checkpoints with you for feedback.

Multi-track mode — independent tasks can run in parallel with coordinated builders. Requires Agent Teams (experimental):

claude config set env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 1

Agents

Dispatched by skills. You never invoke them directly.

AgentRoleProperties
builderTDD implementation in isolated worktreeFull tool access, isolation: worktree
plannerTask breakdown, verifies entity names against codebaseRead-only
researcherFast codebase explorationRead-only, model: haiku, background: true
spec-reviewerVerifies implementation matches specRead-only, doesn't trust builder reports
quality-reviewerCode quality and production readinessRead-only, categorized issue reporting
code-reviewerHolistic pre-merge assessmentRead-only, runs after all tasks complete

All agents have memory: project for persistent codebase knowledge across sessions.

Hooks

HookWhenWhat
SessionStartStart of sessionLoads ATLAS.md Where to Look table, restores session snapshot, flags missing files, checks ATLAS staleness
StopEnd of sessionReminds you to run /turbocharge:wrap before closing

Quick Start Examples

# Full pipeline from scratch
/turbocharge:brainstorm I want to build a REST API for managing bookmarks

# Jump to planning with existing requirements
/turbocharge:plan docs/plans/my-feature-stories.md

# Debug a specific issue
/turbocharge:debug The auth middleware is rejecting valid tokens

# Wrap up your session
/turbocharge:wrap

See examples/ for sample outputs from each stage.

What to Remove After Installing

Turbocharge replaces scattered config. /turbocharge:setup handles this, but in short:

  • Agents in ~/.claude/agents/ (planner, code-reviewer, tdd-guide, session-wrappers)
  • Commands in .claude/commands/ for story-authoring, task-breakdown, session-wrap
  • Rule files that reference competing agents

Project Structure

turbocharge/
├── .claude-plugin/
│   ├── plugin.json              # Plugin manifest
│   └── marketplace.json         # Distribution config
├── skills/                      # 10 skill definitions
│   └── <skill-name>/SKILL.md
├── agents/                      # 6 agent definitions
│   └── <agent-name>.md
├── hooks/
│   ├── hooks.json               # Hook registration
│   └── *.md                     # Hook content files
├── scripts/
│   ├── validate.sh              # Plugin health check
│   └── tests/                   # Content-shape tests
├── examples/                    # Sample pipeline outputs
├── settings.json
├── CHANGELOG.md
└── README.md

Validate

./scripts/validate.sh

License

MIT — see LICENSE.


<p align="center"> <sub>Built by <a href="https://github.com/nicodiansk">@nicodiansk</a> — one pipeline to replace them all.</sub> </p>