Skip to content

README.md

Latest commit

 

History

History
56 lines (42 loc) · 2.92 KB

README.md

File metadata and controls

56 lines (42 loc) · 2.92 KB
Raw

ControlFlow for Claude Code

Version: 0.2.0

ControlFlow is a portable workflow system for non-trivial coding tasks. This is the standalone, hand-maintained Claude Code plugin: a deliberately lightweight surface that brings ControlFlow's planning, plan-verification, and review discipline to Claude Code without the token cost of dedicated subagents. All verification runs inline, in the main context, with adversarial framing built into the skill. It is designed to coexist with Claude Code's native toolset (/code-review, security-review, Explore, agent dispatch) without conflict or overload.

This plugin is not generated by the shared-source generator (sync-plugin-assets.ps1). The codex and cursor siblings are generated; this one is maintained in place as the source-of-truth for the Claude Code host.

Design Principles

  • 3 skills, 0 subagents. No per-verifier agent contexts. One skill (controlflow-verify) runs structural audit, assumption/mirage check, and executability cold-start inline.
  • Native-tool coexistence. Mechanical/style review is delegated to native /code-review and security-review; controlflow-review adds only the ControlFlow layer (plan-vs-implementation scope drift, evidence discipline, proactive vulnerability/error search) on top.
  • Schema-sourced planning. controlflow-plan reads the shared schemas/planner.plan.schema.json and plans/templates/plan-document-template.md at invoke time, so it tracks the canonical format without a frozen copy.
  • Lazy loading. Skill bodies and references load only on invoke. The repo CLAUDE.md is the only always-on surface, and it has been slimmed to a routing stub that preserves the drift anchors.

Skills

Skill Invocation Purpose
controlflow-plan /controlflow-claude-code:controlflow-plan Generate a high-quality plan in the shared ControlFlow format (schema-sourced, tier-gated)
controlflow-verify /controlflow-claude-code:controlflow-verify Inline adversarial verification: structural audit + assumption/mirage check + executability cold-start (zero subagents); writes plans/artifacts/<task-slug>/verify-verdict.md
controlflow-review /controlflow-claude-code:controlflow-review Evidence-backed implementation review: a thin layer over native /code-review, adding plan-vs-implementation scope drift and proactive vulnerability/error search

Routing for MEDIUM/LARGE tasks is defined in the repo CLAUDE.md: plan → verify → review.

Installation

See USAGE.md for local development installation and validation commands.

Requirements

  • Claude Code with plugin support
  • No external runtime dependencies

Related

  • Codex sibling: standalone repo at github.com/Smithbox-ai/ControlFlowCodex
  • Generated cursor sibling: plugins/controlflow-cursor
  • Shared source of truth: plugins/controlflow-shared-source
  • ControlFlow repo