CoriChui/yolo

README preview

# YOLO

**Reasoning-first development for Claude Code. Git is the source of truth; status is derived, never stored.**

YOLO turns "I want X" into a planned, executed, verified, and landed change, driven by conversation and git rather than tracked status files.

## Core ideas

- **Git is the source of truth.** A feature is a **brief** (`workspace/features/<slug>/brief.md`)
  plus a **branch** (`feature/<slug>`). Progress is recorded as commit trailers
  (`YOLO-Task`, `YOLO-Verified`, `YOLO-Feature`) and a `yolo/done/<slug>` tag at landing.
- **Status is derived, never stored.** Every "where do things stand" is recomputed from git
  and the briefs on demand, so it can't drift. There is no `state.yaml`.
- **The methodology lives in skills.** The workflow has no slash commands and no scripts —
  each act is a `yolo-*` skill that Claude routes to from plain intent. (The lone
  `.claude/commands/yolo-validate.md` is maintainer tooling, explicit-invoke only, not part
  of the workflow.)
- **Cheap is free; billed is reviewed at two gates.** Capturing intent and drafting a brief
  run freely; YOLO then confirms at exactly two points — the **plan gate** (before any code
  is written) and the **ship gate** (before the irreversible merge) — and lets everything

View full repository on GitHub →