whatisgithub

What is contractor?

chrstian6/contractor — explained in plain English

Analysis updated 2026-05-18

38ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A one-command installer that sets up a structured multi-agent workflow for Claude, where sub-agents research, plan, build, and independently review code before it ever merges.

Mindmap

mindmap
  root((Contractor))
    What it does
      Installs Claude agent workflow
      Research plan execute review
      Never commits to main branch
    Agent roles
      Orchestrator
      Task manager
      Architect
      Builder swarm
      Reviewers
    Tech stack
      npx installer
      CLAUDE.md config
      Claude Code hooks
    Use cases
      Multi-agent coding pipeline
      Adversarial code review
    Audience
      Claude Code users
      AI-assisted developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install a disciplined research-plan-execute-review workflow into an existing repo for Claude to follow.

USE CASE 2

Delegate coding tasks to a swarm of builder agents while independent reviewers check each change.

USE CASE 3

Point the workflow at a legacy app or spec so Claude works toward matching it exactly.

What is it built with?

Node.jsnpxClaude CodeShell

How does it compare?

chrstian6/contractor1061700625/github_vpshandrovermeulen/obsidian-dashboard
Stars383838
LanguageShellShellShell
Setup difficultymoderatemoderatehard
Complexity3/52/53/5
Audiencedeveloperops devopsvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires editing a config file with project-specific values and setting the orchestrator model before it works fully.

Free to use, modify, and distribute for any purpose, including commercial, as long as you keep the copyright notice.

So what is it?

Contractor installs a structured workflow for Claude into any code repository with a single command, so instead of writing code directly, Claude works more like a senior contractor managing a small team. It researches a task before building it, plans before executing, hands off the actual coding work to a group of specialized sub-agents, has other agents review everything before it merges, and never commits directly to your main branch. The install drops in a CLAUDE.md instructions file and a .claude folder containing several defined roles: an orchestrator that owns overall strategy and git operations, a task-manager that keeps a backlog of work, an architect that only designs and never writes code, a swarm of builder agents that carry out the actual coding in parallel, and independent reviewers that check correctness, security, performance, and silent failures before anything merges. No single agent both writes and approves its own work. It also installs safety hooks that scan for secrets, block dangerous commands, and protect certain files from being touched, plus a persistent knowledge vault so decisions and gotchas carry over between sessions instead of being forgotten. You install it by running a single npx command from the root of your repository, which copies in the instructions and agent files, backing up anything it overwrites. After that, you copy an example config file, fill it in with your project's details, and run a fill command to complete setup. From there, you interact with the task-manager rather than individual agents: you describe a goal in plain language, address the task-manager directly to plan work, or point it at an existing reference like a legacy app or a spec file so it can work toward matching that reference. The task-manager then releases batches of independent tasks that run through the pipeline together rather than one at a time. The project is distributed on npm and GitHub under the MIT license.

Copy-paste prompts

Prompt 1
Run npx contractor-kit in my repo and explain what files it installs.
Prompt 2
Walk me through filling out contractor.config after installing Contractor.
Prompt 3
Explain the difference between Contractor's parity mode and planning mode.
Prompt 4
Describe the review gate Contractor puts every code change through before merging.

Frequently asked questions

What is contractor?

A one-command installer that sets up a structured multi-agent workflow for Claude, where sub-agents research, plan, build, and independently review code before it ever merges.

What language is contractor written in?

Mainly Shell. The stack also includes Node.js, npx, Claude Code.

What license does contractor use?

Free to use, modify, and distribute for any purpose, including commercial, as long as you keep the copyright notice.

How hard is contractor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is contractor for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.