correctless

Composable Claude Code skills that enforce a correctness-oriented development workflow. Spec before you code. Test before you implement. Never let an agent grade its own work.

The Problem

AI coding assistants are fast but sloppy. They write code that works for the happy path, skip edge cases, and silently introduce bugs that don't surface until production. The same model that wrote the code will review it and say "looks good" — because it's confirming its own decisions.

Correctless fixes this by structuring the workflow so that every phase is executed by a different agent with a different lens:

• The spec agent asks "what does correct mean?" and researches current best practices before any code exists
• The review agent reads the spec cold and checks for security gaps, unstated assumptions, and untestable rules
• The test agent writes tests from the spec without knowing the implementation plan
• The test auditor checks whether those tests would actually catch bugs or just pass against mocks
• The implementation agent makes the tests pass without having written them
• The QA agent hunts for bugs with neither the test author's nor the implementer's blind spots
• The verification agent checks spec-to-code correspondence without insider knowledge

Same model — but the framing determines what the agent finds.

Quick Start

You need Claude Code and a Claude Max subscription ($100-200/mo).

Install

/plugin marketplace add joshft/correctless
/plugin install correctless
/csetup

git clone https://github.com/joshft/correctless.git .claude/skills/workflow
.claude/skills/workflow/setup
/csetup

Standard intensity by default. To increase: add "intensity": "high" or "critical" to the workflow section of .correctless/config/workflow-config.json.

First Feature

git checkout -b feature/my-feature
/cspec

Update

/plugin uninstall correctless
/plugin marketplace remove correctless
/plugin marketplace add joshft/correctless
/plugin install correctless

Then restart Claude Code. Git clone users: cd .claude/skills/workflow && git pull && ./setup

One Plugin, Three Intensity Levels

Correctless ships as a single plugin with 26 skills. You choose the intensity that matches your project's risk profile. Seven skills are gated behind intensity thresholds — they check your project's workflow.intensity setting and warn if invoked below their minimum.

Skills like /cpostmortem and /cdevadv are available at all intensity levels — they're about learning from the past, not adding rigor to the present.

Put another way: Standard intensity is like having someone next to you going through a checklist to make sure your project has some sanity. Critical intensity is like taking your Claude Max subscription tokens, setting them on fire, collecting the ash, and using it to create a tiny diamond.

How It Works

The Standard Workflow

graph LR
    A["/cspec<br/>Write spec"] --> B["/creview<br/>Skeptical review"]
    B --> C["/ctdd"]
    C --> D["/cverify<br/>Rule coverage"]
    D --> E["/cdocs<br/>Update docs"]
    E --> F["Merge"]

    subgraph "/ctdd — Enforced TDD"
        direction LR
        C1["RED<br/>Write tests"] --> C2["Test Audit<br/>Would tests catch bugs?"]
        C2 --> C3["GREEN<br/>Implement"]
        C3 --> C4["/simplify"]
        C4 --> C5["QA<br/>Hostile review"]
        C5 -.->|"Issues found"| C3
    end

    C --- C1