Braddock

An AI squad operating system for Claude Code. Governance, pipeline, and memory — so your agents don't just yell in the jungle.

Getting Started

1 Install Braddock in your project

Run inside any existing project directory:

# install in current directory
npx @vitorbritto/braddock init

# or specify a path
npx @vitorbritto/braddock init /path/to/your/project

Braddock scaffolds a .braddock/ and .claude/ folder. Existing files are never overwritten.

2 Define your product vision

Open .braddock/memory/vision.md and describe what you're building. One paragraph is enough. Without this file, the squad has no mission.

Tip: Be specific. The vision feeds the PRD, which feeds the spec, which feeds the code. Vague input = vague output.

3 Fire up the squad in Claude Code

Open Claude Code in your project, paste the content of .braddock/PROMPT.md and hit enter. That's it — the squad initializes itself and runs the pipeline from there.

You are operating inside a virtual squad system called Braddock. Read first, in this order: - .claude/CLAUDE.md - .braddock/memory/vision.md - .braddock/memory/status.md Your mission is to initialize the project and prepare the squad for execution. Rules that cannot be broken: - Never skip steps in the pipeline - Never implement code before an approved PRD and spec exist - Never assume a business rule without recording it in .braddock/memory/decisions.md - Always maintain traceability: vision → PRD → spec → task → code Default pipeline: /kickoff → /create-prd → /create-spec → /breakdown-work → /implement-task → /review-delivery Start now with /kickoff.

From there, each skill points to the next when it finishes. The squad is self-guided.

Pipeline

No mission starts in the middle. Each step produces an artifact that feeds the next.

/kickoff → /create-prd → /create-spec → /breakdown-work → /implement-task → /review-delivery
SkillWhat it does
/kickoffInitializes the operation, prepares the ground
/create-prdPM defines the mission objective
/create-specTech Lead + Architect + UI/UX build the plan
/breakdown-workPlanner breaks into epics, stories, and small bets
/implement-taskExecutes the next eligible task
/review-deliveryQA + Tech Lead validate what was delivered

The Squad

Each agent has a fixed role and never acts outside it.

AgentRole
pmTransforms vision into PRD
tech-leadArchitecture, trade-offs, risks
architect-specialistStructure, modules, boundaries
backend-seniorImplements business rules
frontend-seniorInterface, flows, integration
ui-uxExperience, clarity, conversion
plannerBreaks work into epics and tasks
qaValidates, flags gaps, reviews

Code of Honor