/setup

name: setup
description: "Reconfigure an existing Plan-Build-Run project (models, features, CLAUDE.md)."
allowed-tools: Read, Write, Bash, Glob, AskUserQuestion
argument-hint: "[--models] [--features] [--hooks]"

**STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes tokens. Begin executing Step 1 immediately.**

Step 0 — Immediate Output

**Before ANY tool calls**, display this banner:

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► RECONFIGURE                                ║
╚══════════════════════════════════════════════════════════════╝

Then proceed to Step 1.

/pbr:setup — Plan-Build-Run Reconfigure

You are running the **setup** skill in **reconfigure mode**. This wizard lets existing Plan-Build-Run projects change model profiles, workflow features, and CLAUDE.md integration. It does NOT re-initialize or overwrite project state.

---

Step 1: Detect Project State

Check if `.planning/config.json` exists.

**If `.planning/config.json` does NOT exist:** Display:

No Plan-Build-Run project found in this directory.

/pbr:setup is for reconfiguring existing projects.
To start a new project, run: /pbr:new-project

/pbr:new-project includes everything /pbr:setup used to do, plus deep requirements gathering and roadmap creation.

Stop. Do not proceed further.

**If `.planning/config.json` exists:**

• Read `.planning/config.json`
• Display the current settings summary:

  Current configuration:
  - Model profile: {derived from models block — balanced/quality/budget or custom}
  - Depth: {depth}
  - Mode: {mode}
  - Auto-continue: {features.auto_continue}
  - TDD mode: {features.tdd_mode}
  - Git branching: {git.branching}

• Proceed to Step 2.

---

Step 2: Model Selection

Note: These profiles control agent models, not the orchestrator. The orchestrator uses your Claude Code session model. For cost optimization, consider running your session on Sonnet -- agents with `inherit` will follow. See `references/model-profiles.md` for details.

Use AskUserQuestion: question: "Which model profile should agents use?" header: "Models" options:

• label: "Balanced (Recommended)"

description: "Sonnet for most agents, Haiku for synthesizer. Good quality/cost tradeoff."

• label: "Quality"

description: "Opus for executor and planner, Sonnet for others. Best results, highest cost."

• label: "Budget"

description: "Haiku for most agents. Fastest and cheapest, but lower quality."

• label: "Keep current"

description: "Leave model settings unchanged."

Apply the selected profile to the models block in config.json:

• **Balanced**: executor=sonnet, researcher=sonnet, planner=sonnet, verifier=sonnet, synthesizer=haiku, context_window_tokens=200000, agent_checkpoint_pct=50, extended_context=false
• **Quality**: executor=opus, researcher=sonnet, planner=opus, verifier=sonnet, synthesizer=sonnet, context_window_tokens=1000000, agent_checkpoint_pct=65, extended_context=true
• **Budget**: executor=haiku, researcher=haiku, planner=sonnet, verifier=haiku, synthesizer=haiku, context_window_tokens=200000, agent_checkpoint_pct=50, extended_context=false
• **Keep current**: no change to models block, no change to context_window_tokens

---

Step 3: Workflow Features

Use AskUserQuestion: question: "Which workflow features do you want enabled?" header: "Features" multiSelect: true options:

• label: "Auto-continue"

description: "Automatically chain commands (build → review → next phase) without prompting"

• label: "TDD mode"

description: "Write tests before implementation in executor agents"

• label: "Strict gates"

description: "Require verification AND review to pass before advancing phases"

• label: "Git branching"

description: "Create a branch per phase for cleaner PR history"

Apply selections (others unchanged):

• **Auto-continue**: Set `features.auto_continue: true`
• **TDD mode**: Set `features.tdd_mode: true`
• **Strict gates**: Set `gates.verification: true`, `gates.review: true`, `gates.plan_approval: true`
• **Git branching**: Set `git.branching: "phase"`

---

Step 4: CLAUDE.md Integration

Check if a `CLAUDE.md` file exists in the project root.

**If it exists**: Read it. If it does NOT already contain a "Plan-Build-Run" section, offer to append the integration block. **If it does NOT exist**: Offer to create `CLAUDE.md` with the integration block.

Use AskUserQuestion: question: "Update CLAUDE.md with Plan-Build-Run integration notes?" header: "CLAUDE.md" options:

• label: "Yes"

description: "Add or update the Plan-Build-Run section in CLAUDE.md"

• label: "No"

description: "Skip — leave CLAUDE.md as-is"

If "Yes", append/create:

## Plan-Build-Run

This project uses [Plan-Build-Run](https://github.com/SienkLogic/plan-build-run) for structured development.

- Project state: `.planning/STATE.md` (source of truth for current phase and progress)
- Configuration: `.planning/config.json`
- Run `/pbr:progress` to see current project state and suggested next action.

**After compaction or context recovery**: Read `.planning/STATE.md` (especially the `## Session Continuity` section) before proceeding with any work. The PreCompact hook writes recovery state there automatically.

---

Step 5: Platform Settings

Manage Claude Code platform settings that PBR recommends for optimal token usage.

**Read `.planning/config.json`** (already loaded in Step 1). Check for a `platform_settings` block:

• If absent, treat it as `{}` (no managed settings).

**Check for existing `.claude/settings.json`**:

• If it exists, read its contents. Parse as JSON (or `{}` if empty/missing).
• If it does not exist, start from `{}`.

**Compute the merge**:

• Start with the existing `.claude/settings.js