v/flow

A loop based workflow & skills conductor for Claude Code.

XP applied to Agents.

Skills that story-map a feature, RED/GREEN/REFACTOR each increment, enforce Hexagonal Architecture, and refactor by smell 👃.

v = value: build products driven by small slices of value.

One way in — not a catalogue to learn. Why it stays small →

SHELL

# install from the private repository (current beta)
git clone https://github.com/dschinkel/vflow.git
claude plugin marketplace add ~/vflow
claude plugin install vflow@vflow -s user

TIPRestart Claude Code after installing. You need collaborator access to the private repository.

The root .claude directory is unnecessary. The repository root is the Claude marketplace; .claude-plugin/marketplace.json points Claude to the plugin inplugins/vflow automatically.

Use -s project instead of -s user to enable it in one repo only — it commits to that repo and travels to teammates. Once vflow-installis published to npm, the clone step can be replaced by the installer path.

IDEA → STORY MAP → SLICE →

RED · GREEN · REFACTOR → SHIP

the loop runs on every slice

BROWSE SKILLS→STAR ON GITHUB↗

NOW IN CODEX

Use v/Flow with Codex

The same small-slice discipline now has a Codex-native front door. Point $vflow-feature at planned work and run one real RED → GREEN → REFACTOR increment against the shared story map and board.

HOW CODEX WORKS→Claude keeps /vflow-feature. Codex uses $vflow-feature.

Coming soon.