Why it is worth attention

It distills a battle-tested agent setup into a reusable template that automates multi-agent delegation (orchestrator, architect, builder swarm, reviewers), enforces adversarial review gates, and works with any repo via a single npx command.

Who it is for

Developers using Claude for AI-assisted coding
Teams wanting structured, multi-agent AI workflows
Open-source maintainers seeking automated PR review
Engineering managers exploring AI-powered development pipelines

Use cases

Automating feature implementation with AI-managed parallel tasks
Refactoring or porting legacy code using parity mode with reference specs
Running adversarial code review across multiple independent reviewers
Adopting a safe branch-only workflow for AI-generated changes

Strengths

Works out-of-the-box on any repo via npx contractor-kit without npm install
Enforces separation of concerns (architect designs, builders implement, reviewers gate)
Includes safety hooks for secret scanning, dangerous command blocking, and file protection
Supports configurable model tiers to match available AI models

Considerations

Overwrites existing CLAUDE.md and .claude/ files by design (with prompts and backups)
Requires manual placeholder configuration (contractor.config) and model setup
Complex pipeline may be overkill for small or single-file changes

README quick start

=16" />

npx contractor-kit — install a senior-contractor workflow into any repo in one command.

Contractor

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.

Contractor is a project-agnostic distillation of a battle-tested CLAUDE.md and .claude/ setup — the personal paths, names, and one-project specifics stripped out and replaced with {{PLACEHOLDERS}} you fill once.

What's inside

bin/cli.js                      # the npx installer (`contractor` / `contractor fill`)
package.json                    # npm package manifest (bin, files, MIT)
template/                       # the payload copied into a target repo:
  CLAUDE.md                     #   Claude's instructions (Research → Plan → Execute → Review)
  contractor.config.example     #   the placeholders to fill, once per project
  .claude/
    agents/                     #   task-manager, architect, builder, reviewer, code-reviewer,
                                #   security-reviewer, pr-test-analyzer, performance-reviewer, silent-failure-hunter
    hooks/                      #   secret scan, dangerous-command block, file protection, session context
    rules/code-quality.md       #   naming, markers, anti-defaults
    settings.json               #   wires the hooks + a safe permission allow/deny list

Core ideas (full detail in template/CLAUDE.md):

Research → Plan → Execute → Review — never execute first.
Branch Safety — every change on its own branch, PR + independent review before merge, no direct commits to the default branch.
The Delegation Org — orchestrator (owns strategy + git) → task-manager → architect (design only) → builder swarm (5+, parallel) → independent reviewers. No agent both writes and self-approves.
Spec Engine — a named source of truth is the executable spec; nobody invents behavior.
Model tiers — map orchestrator / thinking / builder to whatever models you run.

Features

Delegation org, not a lone agent. Work flows through a fixed chain — orchestrator (owns strategy + git) → task-manager (backlog) → architect (design only) → builder swar

Description

A disciplined, delegation-driven operating system for AI coding agents. npx contractor-kit.

Related repositories

Similar projects matched by category, topics, and programming language.

jamesob

Featured

local-llm

A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.

AI & Machine LearningLarge Language Models

1,660

bjan

Featured

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI & Machine LearningAI Agents

AARomanov1985

Audio-Cassette-Simulation

A set of bash scripts using ffmpeg to simulate vintage cassette tape audio profiles with noise, wow/flutter, bandwidth limits, and EQ.

Shell

373