codecruise

Structured workflow layer for Claude Code. OODA-based execution, TDD-enforced, state-tracked.

Install

npx codecruise install

Copies workflow config to ~/.claude/. Backs up existing config if present.

Usage

cd your-project
claude
/init                    # Setup project
/run                     # Execute TODOs

What It Does

OODA execution — Observe → Orient → Decide → Act loop, not blind execution.

State in files — progress.yaml tracks everything, survives sessions.

TDD enforced — Hooks block implementation until tests exist.

Quality gates — Can't mark done until tests/lint/typecheck pass.

Guardrails — Max retries, max replans, cost limits prevent runaway loops.

Core Commands

| Command | Purpose | |---------|---------| | /init | Setup project (detects existing structure) | | /run | OODA execution loop with pattern detection | | /run "add auth" | New feature (generates plan first) | | /status | Show progress | | /pause | Pause OODA loop | | /resume | Re-enter at OBSERVE phase | | /companion | Pattern analysis and insights |

Full reference: docs/COMMANDS.md

OODA Loop

OBSERVE → ORIENT → DECIDE → ACT → loop
   │         │        │       │
   │         │        │       └── TDD cycle, commit
   │         │        └── Route: execute/skip/replan/escalate
   │         └── Pattern detection, confidence calculation
   └── Sense environment, check deps

• Tempo profiles: ship-fast, balanced, careful
• Pattern detection: Retry spikes, module failures, blockers
• Guardrails: Max 3 retries/TODO, max 2 replans/module

Enforcement

Hooks in ~/.claude/hooks/ enforce:

| Hook | Enforces | |------|----------| | enforce-tdd.sh | Tests must exist before implementation | | verify-todo-completion.sh | Quality gates must pass before done | | enforce-state-machine.sh | Valid state transitions only |

Configure in .claude/settings.json:

{
  "codecruise": {
    "enforce": "strict"   // strict | ask | off
  }
}

Project Structure

After /init:

your-project/
├── CLAUDE.md           # Project context
├── progress.yaml       # State (single source of truth)
└── roadmap/
    └── phase-01.yaml   # TODOs

Customization

Edit files directly in ~/.claude/:

~/.claude/
├── commands/    # Add/edit slash commands
├── agents/      # Add/edit agents
├── hooks/       # Add/edit enforcement hooks
├── rules/       # Add/edit rules
└── skills/      # Add/edit domain skills

How It Works

See docs/ARCHITECTURE.md.

License

MIT