Setup Turbocharge

One-time audit and cleanup to make turbocharge your single orchestration system.

Announce: "Running turbocharge setup — auditing your config for conflicts."

The Goal

Turbocharge replaces ad-hoc agents, scattered skills, and custom commands with one pipeline. This setup finds and removes the overlap so Claude doesn't get confused about which system to use.

Audit Steps

1. Check for Competing Agents

Scan ~/.claude/agents/ for agent definitions that overlap with turbocharge agents:

Also check for: session-wrapper, session-wrap, build-error-resolver (covered by turbocharge:debug)

Action: List conflicts and offer to delete them. Explain what turbocharge agent replaces each one.

2. Check for Duplicate Skills/Commands

Scan .claude/commands/ (project level) for commands that overlap with turbocharge skills:

Action: List conflicts with file paths. Offer to delete duplicates. Flag any that have unique functionality turbocharge doesn't cover (recommend keeping those).

3. Check agents.md Rule

Read ~/.claude/rules/common/agents.md (if exists):

• Does it reference turbocharge as the primary system? Good.
• Does it list phantom agents (agents not in ~/.claude/agents/)? Bad — offer to rewrite.
• Does it reference both turbocharge AND other agent systems? Bad — offer to consolidate.

Action: If agents.md doesn't point to turbocharge, offer to replace it with the turbocharge-aware version:

# Agent Orchestration
## Primary System: Turbocharge Plugin
All orchestration goes through the turbocharge plugin...

4. Check for Plugin Conflicts

Run claude plugin list --json to enumerate installed plugins and their enable state, then read ~/.claude/settings.json enabledPlugins:

• Are there disabled plugins cluttering the config? Offer to remove.
• Scan the installed-plugins list for competing orchestration plugins (e.g. superpowers, everything-claude-code) enabled alongside turbocharge — not just duplicate definitions in ~/.claude/agents/. Warn about conflicts and explain the overlap.

5. Validate Turbocharge Plugin Health

Run claude plugin details turbocharge to confirm the plugin is installed, enabled, and to see its standing token cost. Then run the validation script if available:

./scripts/validate.sh

Or manually check:

• All 10 skills have SKILL.md files
• All 5 agents have .md files
• hooks/hooks.json exists
• .claude-plugin/plugin.json exists and has correct version

6. Check Global Rules Alignment

Scan ~/.claude/rules/common/ for rules that conflict with turbocharge's iron laws:

• Testing rules should include "never ask permission to run tests"
• Development workflow should include "verify understanding before coding"
• Coding style should include a completion gate
• Reviews should require comprehensive scope by default

Action: List missing rules and offer to add them.

7. Check for Global Rules / Turbocharge Overlap

Scan ~/.claude/rules/common/ for files that duplicate what turbocharge skills already enforce:

Action: For each overlap found, show the user what's duplicated and offer to trim. Don't delete files — trim the overlapping sections and keep unique content.

Why this matters: Every global rule file is loaded into context on every turn (~4 bytes/token). Duplicate instructions between rules and turbocharge skills waste ~2,000 tokens per session and can cause conflicting guidance.

CLAUDE.md Phase

Run this phase after the conflict audit completes and before the final report.

1. Auto-Detect (no questions)

Probe the project root for these files and extract values:

Do not ask the user about anything detectable.

2. Interview (≤5 questions, each skippable)

Ask at most these five, each with [skip] producing the template default:

1. Test discipline — Strict TDD / Tests-alongside / Tests-when-reasonable
2. File-header convention — ABOUTME / JSDoc-style / None
3. Naming style — camelCase / snake_case / mixed-by-language
4. Debug protocol strictness — Always 4-phase / Non-trivial only
5. Project-specific domain terms — free text; empty skips the block

The interview must be completable in under 90 seconds.

3. Render and Append

Read ${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE-turbocharge.md. Substitute answers (test command, naming style, file-header convention, domain terms). Each block is delimited by <!-- turbocharge:NAME --> and <!-- /turbocharge:NAME -->. Versions 3.0–3.1 wrote the same blocks under <!-- turboflow:NAME --> / <!-- /turboflow:NAME -->: treat those as the same block — replace it in place and rewrite its markers to turbocharge; never append a duplicate. If both a turbocharge:NAME and a turboflow:NAME block exist (3.x setup appended a copy), update the turbocharge block and remove the turboflow duplicate.

CLAUDE.md here means ./CLAUDE.md, or ./.claude/CLAUDE.md when the project keeps it there — edit the one that exists, never create a second. Imports resolve relative to the file that contains them, so inside .claude/CLAUDE.md the import is @../AGENTS.md: write that form wherever the bullets below say @AGENTS.md, and treat either form as the import already being present.

• If CLAUDE.md exists, AGENTS.md also exists, and CLAUDE.md has no @AGENTS.md line → offer to add @AGENTS.md as its first line. Claude Code ignores AGENTS.md whenever a CLAUDE.md exists, so without the import its instructions never load. Leave the file unchanged if the user declines.
• If CLAUDE.md exists and contains a block with the same marker → replace between markers, leave surrounding content untouched.
• If CLAUDE.md exists and does not contain that block → append to end of file.
• If CLAUDE.md does not exist but AGENTS.md does → create CLAUDE.md with @AGENTS.md as its first line, then append the rendered blocks below it. Claude Code reads AGENTS.md only while no CLAUDE.md exists, so this import is what keeps AGENTS.md loading once CLAUDE.md is created.
• If neither CLAUDE.md nor AGENTS.md exists → suggest /init first, do not create a bare CLAUDE.md from the template alone.

4. Show Diff, Confirm, Write

Always show the diff and ask for confirmation before writing. Never modify CLAUDE.md silently.

5. Size Guard

After writing, if CLAUDE.md exceeds 180 lines, warn the user and suggest extracting personal rules to ~/.claude/CLAUDE.md.

6. Chain Forward

If ATLAS.md does not exist, offer: /turbocharge:atlas to generate the navigation index. This closes the bootstrap loop: /init → /turbocharge:setup → /turbocharge:atlas.

Report Format

TURBOCHARGE SETUP AUDIT
=======================

Plugin Health: ✅ OK (10 skills, 5 agents, hooks configured)

Conflicts Found:
  🔴 ~/.claude/agents/session-wrapper-agent.md → covered by turbocharge:wrap
  🔴 .claude/commands/story-author.md → covered by turbocharge:story
  🟡 agents.md references phantom agents, not turbocharge

Recommendations:
  1. Delete ~/.claude/agents/session-wrapper-agent.md
  2. Delete .claude/commands/story-author.md
  3. Rewrite agents.md to reference turbocharge

No Conflicts:
  ✅ .claude/commands/epic-author.md — unique, keep
  ✅ .claude/commands/consistency-review.md — unique, keep

Apply fixes? [list specific changes, ask for confirmation]

After Setup

Offer to chain:

• /turbocharge:brainstorm if user has an idea to explore
• /turbocharge:plan if user has requirements ready
• Nothing if user just wanted the audit

Red Flags

Do NOT:

• Delete files without listing them first and getting confirmation
• Modify CLAUDE.md without showing the diff
• Assume any file is "safe to delete" — always explain what replaces it
• Skip the audit steps to "save time"