Contractor is a npx-installable, delegation-driven workflow that configures a multi-agent pipeline (research, plan, execute, review) in a repo, with branch safety and parallel task waves. It copies CLAUDE.md and a .claude/ folder into the target repo and provides placement for placeholders and vault configuration.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
A disciplined, delegation-driven workflow for Claude. Drop it into any repo and Claude starts working like a senior engineering contractor: it researches before it builds, plans before it executes, delegates grunt work to a builder swarm, reviews everything adversarially, and never touches your default branch directly.
How it works
- Core flow: Research → Plan → Execute → Review. Branch safety ensures changes occur on separate branches behind PRs.
- Roles: orchestrator → task-manager → architect → builder swarm → independent reviewers. No agent both writes code and approves it.
- Task management: task-manager releases multiple independent tasks in parallel; builder swarm executes in parallel; reviewers gate diffs before merge.
- Inputs: can match a reference (legacy app, API contract, design) or a fresh goal (planning mode).
- Guardrails: secret scanning, dangerous-command blocking, file protection, and large-file warnings via hooks.
- Knowledge persistence: decisions and plans persist in a vault for cross-session use.
- Configurability: supports mapping orchestrator/thinking/builder to models; defaults are provided.
Getting started
Install into a repo (npx):
# Published on npm — the short name just works:
npx contractor-kit
# Or run straight from GitHub (no npm needed):
npx github:chrstian6/contractor
Both copy CLAUDE.md and .claude/ into the target repo and overwrite by design, with prompts and backup options. Then configure once:
cp contractor.config.example contractor.config # edit owner, vault, spec/design source
npx contractor-kit fill # fills placeholders + creates the vault
# set the orchestrator model in your client:
# /model claude-fable-5
git checkout -b chore/adopt-contractor && git add -A && git commit -m "chore: adopt Contractor"
No npm install needed —
npxdownloads and runs it on demand. You can also run it straight from GitHub:npx github:chrstian6/contractor.
Getting started (continued)
After installation, you drive Contractor through the task-manager to create a backlog, release parallel waves, and keep the pipeline fed as tasks complete. You interact by giving goals, addressing the task-manager by name, or pointing to a reference to align done criteria. The flow ensures parallelism and gated reviews before merges.
Recent releases
- None
Traction
- Stars: 18
License
MIT