docflow logo docflowHQ

docflow is governance for agent-led software.

Keep decisions, conventions, plans, audits, and rollups inside the repo — readable by humans, checkable by machines.

A plugin for your coding agent — Claude Code, Codex, Copilot CLI, pi, omp, OpenCode, Cursor, Grok · docs ↗ Now shipping: Docflow 0.10.0 — fourteen skills for eight coding agents · Clarity in development · join the waitlist
01 RATIONALE

The repo should remember.

docflow starts from a simple belief: the repository should not only contain code. It should contain the reasons the code exists, the rules that shape it, the work still in motion, and the checks that keep the system honest.

Everything docflow writes is plain text, versioned with the work it governs. Reviewable in a pull request. Diffable in an audit. Readable in ten years, with or without us.

02 WHY DOCFLOW EXISTS

Prompts were never the operating system.

AI coding doesn't fail because prompts are bad. It fails because intent, decisions, constraints, and follow-through drift — across chats, branches, tickets, and whichever tool held the conversation that mattered.

docflow is the durable layer underneath that motion. Decisions recorded. Plans queued. Conventions visible. Audits repeatable. Progress legible — without inventing another software factory.

01 Agent-led work moves fast, but context disappears.
02 Decisions have to survive the chat window.
03 Work needs a plan queue, not just a backlog.
04 Conventions are executable guidance, not tribal memory.
05 Audits are repeatable, local, and versioned.
06 The operating record lives where the work lives: in the repo.
03 GET DOCFLOW · AVAILABLE NOW

Get Docflow.

Docflow helps your coding agent record project decisions, plan work and check what is complete. You use its skills through prompts in your agent — there is no Docflow terminal CLI. The results live in ordinary files in your repositories: plain markdown, versioned with the code, checkable by machines.

INSTALL FOR YOUR AGENT v0.10.0
Claude CodeCodexCopilot CLIpiomp
IN YOUR AGENT copy
/plugin marketplace add EvolveHQ/docflow /plugin install docflow@evolvehq
Then open a repository in your agent and invoke /bootstrap. Guided mode with a plan queue is the recommended start. Nothing leaves your machine.
What docflow gives you
Fourteen skills — nine for a repository, five for a workspace. Each one writes ordinary files.
bootstrap Scaffold or retrofit the whole convention set: agent instructions, conventions, ADR template and INDEX. Start here.
new-adr Decision records — one ADR per choice: why it was made, how success is checked, what it supersedes.
add-convention Conventions — assess whether a rule is worth codifying, then put it where agents will follow it.
new-plan · ship-item Plan queue — bounded plan/todo items tracing to their ADR; shipping moves them to done and marks the ADR Implemented.
audit Audits — lint the repo against its own conventions: numbering, INDEX sync, plan coverage, privacy leaks.
brainstorm · agent-wave Decompose a problem into candidate ADRs and plan items; run a bounded queue wave within recorded authority.
rollup Rollups — aggregate every member repo’s ADRs into one derived, product-wide view.
workspace-* Workspaces — setup, status, scope, dispatch, sync: shared memory across independent repos, without a companion app.
MIT licensed · maintained by EvolveHQ · Node.js 22+ for workspace validation · no account required
04 WHAT DOCFLOW IS NOT

Not another agent runtime.

docflow doesn't try to become the place where coding happens. It complements coding agents, spec tools, CI, issue trackers, and internal developer portals — the governance substrate beneath them.

The record is plain files in your repo. If a tool disappears tomorrow, the record survives.

A central docflow record exchanging state with the surrounding tools
one record · many consumers — agents, CI, portals, people
05CLARITY · THE DESKTOP COMPANION · IN DEVELOPMENT

Clarity is coming.

Clarity is the desktop companion for docflow. Open a repo, inspect its decision system, browse plans, review audits, and understand the current state — without writing back to the repository.

Clarity is in active development. Builds for macOS, Windows, and Linux are on the way; the first release will be announced to the waitlist below.

local-first · read-only · offline-capablebuilt for private repositories
Join the waitlist in development · macOS, Windows, Linux
Clarity catalogue preview: the Local-first index record selected, with its proposed status, file path, and links to the plan and graph.
Clarity docflow product 3 repos
Search records, docs, and actions ⌘K
Open repository
Search
Catalogue4
Graph
Snapshot
Docs5
Plan queue1
Audit
Settings
FEDERATION
clarity-demo4 ADRs
field-notes1 ADR
contractsunverified
↻Reindex
Indexed 4 ADRs · 9:14:25 AM
Catalogue
STATUS
Any ▾
DOMAIN
Any ▾
0001 Record decisions as markdown capability
0002 Single-window shell capability
0003 Local-first index capability
0004 Split-pane shell capability
.docflow/adr · 4 records · derived from files
0003 Proposed capability 0 of 3 repos Trace impact Focus in graph Open in editor
Local-first index
Sample Author 2026-07-02 .docflow/adr/0003-local-first-index.md
Decision Acceptance criteria Revision history Approvals
Everything is derived from files on disk; nothing leaves the machine.
Related federation notes live in field notes.
TRACE TO IMPACT 3 links
UPSTREAM — DEPENDS ON
0001 Record decisions as markdown
.docflow/adr/0001-record-decisions.md
DOWNSTREAM — AFFECTED
plan 0001 Build the local-first index
.docflow/plan/todo/0001-local-first-index.md
INDEX.md Generated catalogue row
INDEX.md
Clarity · preview of the catalogue Clarity · preview build · interactive demo — try the sidebar, click a record
06CONTACT

Tell us what you are governing.

Docflow is the product. If you want the record inside a repo you care about, write. Name is optional. A message is optional. Email is how we reply.

The check has to pass before this is sent.
07WAITLIST

A note when there is something to say.

Product news, and a line when Clarity is ready. Email only.

EMAIL
The check has to pass before this is stored.