Docflow
Description
ADR-driven documentation workflow for the Claude Code and pi coding agents: scaffold and manage Architecture Decision Records (ADRs), a plan queue, and AGENTS.md conventions — a bootstrap skill plus lifecycle skills to author, queue, ship, and audit ADRs.
Installation
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open the source below and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
README
docflow
A plugin for **ADR-driven, documentation-led projects**, working on **Claude Code, Claude Cowork, pi, Codex, and OpenCode** from the same skill files (see [Install](#install)). It installs a `bootstrap` skill that scaffolds (or retrofits) an **Architecture Decision Record (ADR)** catalogue, a plan queue, and `AGENTS.md` conventions into any repository, plus a set of **lifecycle skills** that author, queue, ship, and audit ADRs — so the project can be driven by both humans and coding agents from a small set of canonical files. For the formal definition of the conventions — why they help and where they fall short — see the [methodology](https://evolvehq.github.io/docflow/methodology/).
Skills
Slash commands below are the **Claude Code** form. On the **pi** coding agent the same skills are invoked as `/skill:` (e.g. `/skill:bootstrap`, `/skill:new-adr`). See [Install](#install).
| Skill | Slash command | Purpose |
|---|---|---|
| bootstrap | /bootstrap |
Scaffold or retrofit the whole convention set. Start here. |
| new-adr | /new-adr |
Author one ADR — next contiguous number, right shape, INDEX + domain wiring, supersede linkage. |
| new-plan | /new-plan |
Add a plan/todo item tracing to its owning ADR(s). |
| ship-item | /ship-item |
Run the completion event: verify → integrate → todo→done → ADR Accepted→Implemented → INDEX/WORKLOG. |
| add-convention | /add-convention |
Assess whether a convention is worth codifying, route it to the right home (or to an ADR), then add it. Use it to enable optional practices (e.g. TDD) on demand — see USAGE §5a. |
| audit | /audit |
Lint the repo against its own conventions — numbering, INDEX sync, plan coverage, ADR-privacy leaks, more. |
| brainstorm | /brainstorm |
Decompose a problem into candidate ADRs + plan items (proposes drafts; writes nothing until approved). |
| agent-wave |
Related Skills
Doc Co-authoring
Guide users through structured workflow for co-authoring documentation
Docx
Create, edit, and analyze Word documents with tracked changes, comments, and formatting
Extract text, create PDFs, merge/split documents, and handle forms
Pptx
Create, edit, and analyze PowerPoint presentations with layouts and templates
Xlsx
Create, edit, and analyze Excel spreadsheets with formulas, formatting, and visualization
mcp-server-fetch
Fetch and convert web pages to markdown.
