Flw

flw

A spec-driven workflow for coding agents, and the tool that keeps it current across them.

It takes intent to a versioned contract, works against that contract, and refuses to let the work drift from what was agreed. It also installs itself into every host you use, runs whatever checks your project declares, and extends the same way it ships — so adding your own skill is copying the shape of an existing one.

Host-agnostic: flw installs as [Agent Skills](https://agentskills.io) into Claude Code, Codex and OpenCode. Language-agnostic: it bakes in no toolchain, no test runner and no manifest — a project declares its own commands and flw runs them.

**Status: in construction.** The schemas, the four skills, the scout, the check runner and the CLI work and are tested. What running flw against a real host and a real repository has found is recorded as a comment at the code each finding explains, not in a separate document. See `plans/design-v3.md` for the full design, `specs/current.toml` for what "done" means, and its `applied` list for the order it was built in.

The idea

An agent asked to build something will happily build something adjacent to it, and the gap only becomes visible later. flw closes that gap by making the agreement a file:

• The contract is the source of truth. One per project, complete and current, stating what exists when the work is done and how you will know it works.
• The contract is edited, not operated on. Ordinary edits, so git diff is the review surface. Change only what was agreed and the diff shows exactly that.
• Gaps surface as proposals. When work hits something the contract does not cover, it stops and asks rather than inventing. That refusal is the whole product.
• Every version leaves a record. One file per version under specs/versions/, carrying what changed, why, and the reasoning behind the plan. Size follows the change: a one-line correction is a four-line file. A record is add