Skip to main content

The gate between 'I did the work' and 'the work is done' — 10-phase forge pipeline, 3 independent reviewers, 3 oracle auditors, zero override flags.

Crucible refuses to let the session end until 19 commands execute cleanly, 10 agents produce real-system evidence, 3 reviewers unanimously PASS, and 3 oracle auditors APPROVE the result.

Install the plugin ↗

Crucible is a Claude Code plugin that converts task execution into a scientific procedure: every change-producing run produces a reproducible evidence/ package, and the plugin refuses to declare completion until every Mandatory Success Criterion is backed by an inspectable artifact, three independent reviewers unanimously PASS, and a quorum of three Oracle auditors APPROVE.

Inventory in canonical labels: 19 commands, 10 agents, 11 skills, 4 hooks, 4 rules.

Pipeline label: 10-phase forge — codebase-analysis → documentation-research → planning → oracle-review → execute → validation → evidence-indexing → 3-reviewer consensus → 3-oracle quorum → completion-gate.

Reviewer model label: UNANIMOUS PASS or REFUSED — three reviewers (A=completeness, B=integrity, C=iron-rule compliance) must all return PASS; no majority path, no 2/3 shortcut.

10-Phase Forge Pipeline

codebase-analysis → documentation-research → planning → oracle-review → execute → validation → evidence-indexing → 3-reviewer consensus → 3-oracle quorum → completion-gate. Pipeline halts at the first refusal.

UNANIMOUS PASS or REFUSED

Three reviewers (A/B/C) cover orthogonal dimensions — completeness, integrity, iron-rule compliance. All three must return PASS. No majority path, no 2/3 shortcut.

Structural Refusal, Not Advisory

The Stop hook mechanically blocks completion unless report.json overall=COMPLETE. Iron Rule violations (mocks, test files, fixtures) are blocked at the PreToolUse hook with exit 2.

Composes with VF / OMC / Superpowers

ValidationForge builds validation, OMC orchestrates, Superpowers does TDD — Crucible sits at the completion claim and refuses to let 'Done!' leave the session without proof.

# install via Claude Code marketplace
claude plugin marketplace add krzemienski/crucible
claude plugin install crucible@crucible-local

# set up Crucible in the current project
/crucible:setup --local

# run the full 10-phase forge pipeline
/crucible:forge

# check completion-gate status (MSC table + consensus + quorum + overall)
/crucible:status

# autopilot: forge in a refusal-driven retry loop (default 3 attempts)
/crucible:autopilot
  1. 01claude plugin marketplace add krzemienski/crucible
  2. 02claude plugin install crucible@crucible-local
  3. 03Run /crucible:setup --local to install the CLAUDE.md rule block and create .crucible/active
  4. 04Run /crucible:doctor to verify the 9-check installation + activation health audit
  5. 05Run /crucible:forge to execute the full 10-phase pipeline
  6. 06Run /crucible:status to inspect MSC verdicts, reviewer consensus, oracle quorum, and overall gate
10-phase forge pipeline
Halts at first refusal
3-reviewer consensus
A/B/C unanimous PASS
3-oracle quorum
≥2 APPROVE, 0 critical blockers
Iron-rule PreToolUse hook
Exit 2 on mocks/test files
Completion-gate Stop hook
Blocks unless overall=COMPLETE
Refusal protocol
No override flags
Composes with VF/OMC
Gates the completion claim
Documentation
Read the Crucible docs
crucible.withagents.dev
GitHub
Source code
krzemienski/crucible
Changelog
v0.4.0 release notes
Commit a417efe
Deep Dive
How it works
Read the build post