crucible

Scaffold a new Crucible subagent at agents/<name>.md with role-appropriate frontmatter and tool grants. Roles: planner, reviewer, oracle, validator, analyst, generic.

Run the Final Oracle evidence audit independently against the current evidence/ tree. Convenes 3 Oracle auditors, computes quorum, writes decision.md. Idempotent — safe to re-run. PRD §1.16.2 CMD-3.

/crucible:forge in a refusal-driven retry loop. Runs forge; on REFUSED, parses REFUSAL.md, invokes /crucible:remediate, re-gates. Stops on COMPLETE or after --max-attempts (default 3). Iron Rule preserved at every iteration.

Scaffold a new Crucible slash command at commands/<name>.md with proper frontmatter (name, description, allowed-tools), pipeline section, and refusal-modes section.

Verify Crucible installation health. Compares the plugin manifest (plugin.json) against the Claude Code plugin record and reports drift. Verifies SDK reachability. Read-only diagnostic. PRD §1.16.2 CMD-5.

Use this subagent to build repo-wide context before any modification in Crucible's planning mode. Activate whenever a planning task starts, whenever the planner subagent needs a module map, or whenever a refactor task requires understanding existing code. Read-only — never modifies source. Always runs before the planner builds the executable plan. Outputs a structured evidence/codebase-analysis/ directory.

Use this subagent to fetch and cite current upstream documentation for every external dependency in scope. Activate before writing code against any SDK/framework/API/CLI, whenever training data may be outdated, or whenever a fact must be sourced rather than recalled. Produces evidence/documentation-research/ with raw markdown sources, ISO-8601 fetch timestamps, and a SUMMARY.md citing 3-5 verified facts per source pointing to local sources/ filenames. Refuses memory-only references.

Use this subagent as the FIRST of at least three Final Oracle auditors in Crucible's quorum-gated final evidence audit (VG-14). Oracle 1's emphasis is COMPLETENESS-AND-CITATION — do reviewer-consensus + every MSC have approved verdicts and citations? Activate when the final evidence audit phase begins. Read-only access to evidence/. Issues APPROVE or BLOCK with cited blockers. Never shares context with Oracle 2 or 3. Quorum requires ≥2 APPROVE.

Use this subagent as the SECOND of at least three Final Oracle auditors in Crucible's quorum-gated final evidence audit (VG-14). Oracle 2's emphasis is STRUCTURAL INTEGRITY — does every directory have README.md + INDEX.md, are gate-receipt files (vg0-* through vg15-*) all present, and does the report.json schema parse? Activate when the final evidence audit phase begins. Read-only access to evidence/. Issues APPROVE or BLOCK with cited blockers. Never shares context with Oracle 1 or 3.

Use this subagent as the THIRD of at least three Final Oracle auditors in Crucible's quorum-gated final evidence audit (VG-14). Oracle 3's emphasis is ADVERSARIAL SKEPTICISM — try to find what a hostile reviewer would point at to BLOCK completion. Activate when the final evidence audit phase begins. Read-only access to evidence/. Issues APPROVE or BLOCK with cited blockers. Never shares context with Oracle 1 or 2. Designed to catch what completeness/integrity audits miss.

Build repo-wide context before any modification. Use this skill whenever starting a planning task in a real codebase, refactoring across multiple files, surveying module boundaries, identifying hot paths, or understanding existing code before changing it. Produces a structured evidence/codebase-analysis/ artifact (file inventory, module map, dependency manifests, hot-path identification). Read-only — never modifies source. Always runs before the planning skill in comprehensive mode.

Evaluate the completion gate — refuse on any missing criterion. Use this skill ONLY when invoked as the final step of a Crucible run, when VG-15 executes, or when a user attempts to claim completion. Reads the entire evidence/ tree, evaluates every Mandatory Success Criterion (MSC-1..MSC-21) against cited evidence, AND requires three-reviewer consensus PASS plus Oracle quorum APPROVED. Emits machine-readable evidence/completion-gate/report.json. Has NO override flag. NO force-complete. Refusal is a feature.

Deactivate Crucible enforcement in the current project. Use this when Crucible's hooks are blocking a session in a project that is not actively running a Crucible workflow, or when you want to step out of enforcement temporarily. This is the explicit opt-out — Crucible's hooks become silent no-ops. Removes the .crucible/active sentinel. Reversible via /crucible:enable. Does not delete any evidence/ artifacts.

Fetch and cite current upstream documentation for every external dependency in scope. Use this skill before writing any code that calls an external SDK, framework, API, or CLI. Use whenever training data might be outdated. Use whenever a fact must be sourced rather than recalled. Produces evidence/documentation-research/ with raw markdown sources, ISO-8601 fetch timestamps, and a SUMMARY.md citing 3-5 verified facts per source pointing to local sources/ filenames. Refuses memory-only references — every fact must cite a sources/ file.

Activate Crucible enforcement in the current project. Use this when you intentionally want Crucible's hooks (PreToolUse, PostToolUse, Stop) to enforce evidence-gated completion. Without activation, Crucible is silent in this project. This is the explicit opt-in step before starting any /crucible:planning or /crucible:validation workflow. Creates a sentinel file at .crucible/active in the project root. Reversible via /crucible:disable. Safe to invoke multiple times — idempotent.

4 hooks across 4 events