whatisgithub

What is claude-architect?

pythoughts-labs/claude-architect — explained in plain English

Analysis updated 2026-05-18

14TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A Claude Code plugin that delegates coding to untrusted outside AI tools, verifies their work independently, and lets only a human approve merging it.

Mindmap

mindmap
  root((claude-architect))
    What it does
      Delegates coding to outside tools
      Freezes and verifies output
      Human approves merge
    Tech stack
      TypeScript
      Node.js
      Claude Code plugin
    Workflow
      Versioned spec
      Isolated worktree
      Independent verification
      Human decision
    Guarantees
      Isolation
      Evidence over claims
      No self approval
    Audience
      Claude Code developers
      Teams delegating AI code

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

Delegate a coding task to Codex, OpenCode, Pi, or Pythinker while Claude reviews the result.

USE CASE 2

Verify a delegated tool's test claims by rerunning checks independently in a clean worktree.

USE CASE 3

Review a frozen candidate patch and its verification evidence before approving a merge.

USE CASE 4

Keep outside AI coding tools isolated to a limited set of files they are allowed to change.

What is it built with?

TypeScriptNode.jsClaude CodeGit

How does it compare?

pythoughts-labs/claude-architect0xbebis/hyperpayalfredxw/nova
Stars141414
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity4/55/53/5
Audiencedeveloperdeveloperwriter

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 22+ and at least one supported coding CLI (Codex, OpenCode, Pi, or Pythinker) installed and authenticated.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Claude Architect is a Claude Code plugin that lets Claude delegate the actual writing of code to other AI coding tools, such as Codex, OpenCode, Pi, or Pythinker, while Claude itself stays in charge of the specification, the review, and the final judgment call. Each of those outside tools is treated as untrusted: they run in an isolated Git worktree with no memory of the surrounding conversation, and whatever they produce is frozen and checked independently before any of it is allowed to reach the user's actual project files. The plugin enforces three guarantees directly in its code rather than by just asking the AI models to behave a certain way. Every outside tool runs in its own detached worktree with a sanitized environment and a limited list of files it is allowed to touch, so changes outside that scope get rejected. If a tool claims its tests passed, the plugin does not just take its word for it, it reruns the approved verification commands itself in a clean copy of the work and records the real output. And no tool is allowed to approve its own work: review, the human's decision, and the actual merging of code into the project are kept as separate steps, with a person always making the final call. The core workflow moves from a written specification, to one of the outside tools producing code in its isolated worktree, to a frozen candidate version of that code, to independent verification of any tests or checks, to a review step, and finally to a human decision on whether to accept it, reject it, or ask for changes. The project ships as a Claude Code plugin, installed through Claude's plugin marketplace system, and requires Node.js 22 or newer along with at least one of the supported outside coding tools already installed and logged in. It is currently labeled a public beta, and the project explicitly warns against using it without supervision for production, destructive, or security-sensitive work. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Use /claude-architect:delegate to have Codex add a feature and show me the verified candidate before integrating.
Prompt 2
Explain how this plugin keeps outside coding tools from approving their own work.
Prompt 3
Walk me through installing this plugin and setting up a supported Producer CLI.
Prompt 4
Describe what the reviewCandidate and decideCandidate MCP tools do in this workflow.

Frequently asked questions

What is claude-architect?

A Claude Code plugin that delegates coding to untrusted outside AI tools, verifies their work independently, and lets only a human approve merging it.

What language is claude-architect written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Claude Code.

What license does claude-architect use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-architect to set up?

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

Who is claude-architect for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.