kaisa-kucherenko/claude-code-flow

My working Claude Code setup — the output style, hooks, skills, and agents I
use daily as a tech lead doing AI-heavy development. Published as-is from my
own ~/.claude, sanitized of project specifics.
The problem all of this attacks: cognitive load. When AI writes the code,
you spend the whole day reading, verifying, and deciding — and the model's
default verbosity makes every one of those decisions more expensive. These
files are how I fight that.
Some files mix English instructions with Ukrainian examples — I work
bilingually. The mechanics are language-agnostic; adapt the examples to
yourself.
## What's here
| Component | What it does | Docs |
| Output style | BLUF, hard cut-pass, no closing summaries, colleague-not-assistant. Roy Kent from Ted Lasso as the persona. | output-styles/ |
| Persona re-inject hook | Fights persona drift on long contexts: re-injects a short style reminder into every prompt. | hooks/ |
| Development-cycle skills | adr → spec → implement → twix: decide with an explicit yes each, cut into phases, run one phase per commit, review with a neutral panel. | skills/ |
| Handoff / pickup skills | Deliberate session switching instead of /compact: you decide what survives, the next session verifies it against reality. | skills/ |
| Status line | The context-% number that drives the whole workflow, with traffic-light thresholds (green <30%, yellow 30–39%, red at 40+). | statusline/ |
| Agents | Implementers (Geralt/Lyutik), a three-model review panel (Agatha/Arthur/Dash), specialists (Jobs/Lauda/Gilfoyle), a diagram drawer (Ariel), a test pair (Sam writes, Dean breaks) with a shared pytest-quality skill. | agents/ |
| Precogs workflow | Orchestrates the panel: three reviewers in parallel, then a synthesis that dedupes and cross-votes findings. | workflows/ |
| Personas | Claude Code dressed as a character, one plugin each: a HUD above the prompt, sounds, themes, spinner lines, status line, and a /timer break reminder that opens a break screen. Two so far: AFC Richmond (Ted Lasso) and The Witcher 3. Linux, Ukrainian texts. | plugins/richmond/, plugins/witcher/ |
Each folder's README has the install steps and the reasoning; everything
targets ~/.claude. Run all install commands from the repo root. The personas
are a plugin marketplace instead:
claude plugin marketplace add kaisa-kucherenko/claude-code-flow
claude plugin install richmond@claude-code-flow