Correctless

Correctness-oriented development workflow for Claude Code

29 skills · 8 hooks · 3 intensity levels · enforced TDD with agent separation

---

The Problem

AI coding agents are fast but unreliable. They skip tests, grade their own work, silently drop edge cases, and ship bugs that pass CI but fail in production. The speed advantage disappears when you spend hours debugging what the agent “completed.”

The Solution

Correctless enforces a structured workflow where no agent grades its own work. Separate agents write specs, review specs, write tests, implement code, and audit quality. Hooks gate every file operation — you can’t write source code during the test phase, and you can’t skip review.

graph LR
    S["/cspec<br/>Write spec"] --> R["/creview<br/>Skeptical review"]
    R --> T["/ctdd<br/>RED → GREEN → QA"]
    T --> V["/cverify<br/>Verification"]
    V --> D["/cdocs<br/>Documentation"]
    D --> M["Merge"]

    style S fill:#4caf50,color:#fff
    style R fill:#9c27b0,color:#fff
    style T fill:#ff9800,color:#fff
    style V fill:#2196f3,color:#fff
    style D fill:#607d8b,color:#fff
    style M fill:#2196f3,color:#fff

At high+ intensity, the pipeline expands with 6-agent adversarial spec review, architecture maintenance, and convergence auditing.

---

Agent Separation

Every phase uses a different agent. The test writer doesn’t implement. The implementer doesn’t review. The reviewer didn’t write the spec.

Phase Gating

Hooks block file operations that violate the current phase. During RED, you can only write tests. During QA, everything is blocked. No shortcuts.

Configurable Intensity

Standard (~15 min/feature) covers core TDD. High adds adversarial review and convergence auditing. Critical adds formal modeling.

Self-Improving

Post-merge bugs feed back as antipatterns. QA findings calibrate intensity. The workflow learns from its mistakes.

---

Quick Start

# Install the plugin
git clone https://github.com/joshft/correctless.git \
  ~/.claude/plugins/correctless

# In your project directory, run setup
/csetup

# Start building a feature
/cspec "Add user authentication"

Getting Started View on GitHub

---

Skills at a Glance

Category	Skills	What they do
Core Workflow	/csetup /cspec /creview /ctdd /cverify /cdocs /carchitect /cauto /crelease	The spec-to-merge pipeline
Code Quality	/cquick /crefactor /cdebug /cpr-review /cexplain	Fixes, refactoring, and exploration outside the pipeline
Observability	/cstatus /chelp /csummary /cmetrics /cwtf	See what’s happening and what the workflow caught
High+ Intensity	/cmodel /creview-spec /caudit /cupdate-arch /cpostmortem /cdevadv /credteam /cmodelupgrade	Adversarial review, formal modeling, convergence auditing
Open Source	/ccontribute /cmaintain	Contributing to and maintaining OSS projects