Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

Docflow

ADR-driven documentation workflow skill for AI coding agents to scaffold and manage Architecture Decision Records.

EvolveHQ · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add EvolveHQ/docflow

About this skill

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). 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.

Skills

Slash commands below are the Claude Code form. On the pi coding agent the same skills are invoked as /skill:<name> (e.g. /skill:bootstrap, /skill:new-adr). See Install.

SkillSlash commandPurpose
bootstrap/bootstrapScaffold or retrofit the whole convention set. Start here.
new-adr/new-adrAuthor one ADR — next contiguous number, right shape, INDEX + domain wiring, supersede linkage.
new-plan/new-planAdd a plan/todo item tracing to its owning ADR(s).
ship-item/ship-itemRun the completion event: verify → integrate → todo→done → ADR Accepted→Implemented → INDEX/WORKLOG.
add-convention/add-conventionAssess 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/auditLint the repo against its own conventions — numbering, INDEX sync, plan coverage, ADR-privacy leaks, more.
brainstorm/brainstormDecompose a problem into candidate ADRs + plan items (proposes drafts; writes nothing until approved).
agent-wave