Correctless

https://joshft.github.io/correctless/
Admin
Correctless is a correctness-oriented development workflow plugin for Claude Code that enforces...
Tokens:216,872
Snippets:1,253
Trust Score:9.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Setup script summary output

Source: https://joshft.github.io/correctless/design/correctless

Example of the summary output printed by the setup script after detecting project configuration and registering hooks.

```text
✓ Detected: Go project (go.mod found)
✓ Test command: go test ./...
✓ Structured output: go test -json ./...
✓ Race detector: go test -race -short ./...
✓ Mutation tool: go-mutesting (found in PATH)
✓ Alloy: not found (formal modeling disabled)
✓ External models: codex (found), gemini (not found)
✓ Hooks registered in .claude/settings.json
✓ Commands registered: /cspec /cmodel /creview-spec /ctdd /cverify /caudit /cupdate-arch /cdocs /csetup

Created:
  .correctless/config/workflow-config.json  ← review and adjust
  ARCHITECTURE.md               ← fill in your project's architecture
  AGENT_CONTEXT.md              ← fill in or run /cdocs to auto-generate

Next steps:
  1. Review .correctless/config/workflow-config.json — adjust intensity, enable formal_model if desired
  2. Fill in ARCHITECTURE.md — at minimum, document your trust boundaries and core abstractions
  3. Try it: create a feature branch and run /cspec
```

--------------------------------

### Greenfield project example dialogue

Source: https://joshft.github.io/correctless/skills/csetup

Shows a /csetup session for a new TypeScript project with 4 files. The agent creates a 7-item task list, confirms the project type and package manager, runs setup, and suggests starting a feature branch.

```text
User: /csetup

Agent: [creates task list: 7 items]
       I see a new TypeScript project with 4 files. What are you building?

User: A REST API for a recipe sharing app.

Agent: Got it — REST API project.
       Language: TypeScript, Package manager: pnpm. Looks right?

User: Yes.

Agent: [runs setup, bootstraps minimal docs, quick security check]
       No secrets found, .gitignore looks good. You're set up.
       Start your first feature: git checkout -b feature/my-feature
       then run /cspec.

```

--------------------------------

### Quick Start: Clone and Setup Correctless Skills

Source: https://joshft.github.io/correctless/design/correctless

Commands to add the Correctless skills to a project. Clone the repository into .claude/skills/workflow, run the setup script, then use /csetup to bootstrap configuration and ARCHITECTURE.md. Finally, create a feature branch and start with /cspec.

```bash
# 1. Add to your project (30 seconds)
# Replace joshft/correctless with the actual repo URL
git clone https://github.com/joshft/correctless.git .claude/skills/workflow
cd .claude/skills/workflow && ./setup

# 2. Review the generated config
# setup auto-detects your language, test runner, and available tools

# 3. Fill in your architecture (start small — one trust boundary, one core abstraction)
/csetup  # in Claude Code — interactive config + ARCHITECTURE.md bootstrapping

# 4. Start building
git checkout -b feature/my-feature
/cspec
```

--------------------------------

### Install Correctless workflow

Source: https://joshft.github.io/correctless/design/correctless

Clone the repository and execute the setup script to initialize the environment.

```bash
git clone https://github.com/joshft/correctless.git .claude/skills/workflow
cd .claude/skills/workflow && ./setup
```

--------------------------------

### Initialize Project Setup

Source: https://joshft.github.io/correctless/getting-started.html

Run the setup command in your project directory to detect the stack, create configuration files, and register hooks.

```bash
/csetup
```

--------------------------------

### Install Correctless via Git

Source: https://joshft.github.io/correctless/design/correctless

Clone the repository into the project's .claude/skills/ directory and execute the setup script.

```bash
# Add to your project (replace joshft/correctless with actual repo URL)
git clone https://github.com/joshft/correctless.git .claude/skills/workflow
cd .claude/skills/workflow && ./setup
```

--------------------------------

### Example /chelp command output

Source: https://joshft.github.io/correctless/skills/chelp

Example interaction showing the output of the /chelp command, including the pipeline diagram, command lists, and a note about starting a workflow.

```text
User: /chelp

Correctless — Workflow Pipeline:
  /cspec -> /creview -> /ctdd [RED -> test audit -> GREEN -> /simplify -> QA] -> /cverify -> /cdocs -> merge

Feature workflow:
  /cspec        Write a feature spec with testable rules
  /creview      Skeptical review + security checklist (~3 min)
  /ctdd         Enforced TDD: tests -> implement -> QA
  /cverify      Verify implementation matches spec
  /cdocs        Update documentation

Other:
  /crefactor    Structured refactoring (tests must pass before + after)
  /cpr-review   Review someone else's PR
  /ccontribute  Contribute to someone else's project
  /cmaintain    Review contributions as a maintainer
  /cdebug       Structured bug investigation
  /cstatus      Where am I? What's next?
  /csummary     What did the workflow catch this feature?
  /cmetrics     Project-wide health dashboard
  /cwtf         Audit the workflow — did agents follow instructions?

No active workflow. Start one: git checkout -b feature/my-feature then /cspec
```
Tokens:
Raw