Star200+

Docflow

REVIEW · 68
Community indexed

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.

Verified installs0
Stars10
Version1.0.0
Quality68/100 · Promising
Trust68/100 · Sandbox only
Audit81/100 · Needs review

Supply asset profile

Coding and developer agents

Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.

Browse track

Scenario

Coding agents

I need a coding agent that can understand a repository, edit code, and review pull requests.

Agent fit

Claude Code + OpenAI Agents + CLI

Codex, Claude Code, Cursor, CLI, or custom agents.

Install

Ready

npx skills add EvolveHQ/docflow

Maintenance

fresh

29d since push

Risk

Needs review

Low GitHub adoption signal

GitHub quality

10

68/100 Quality · 76/100 Trust

Coverage tags

CodingCoding agentscoding-agentsadrdocumentation

Review notes

Low GitHub adoption signal · Quality score needs review

Agent adoption scorecard

Trust, audit, and install readiness at a glance

These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.

Quality

Promising
68

Useful candidate, but compare it with alternatives before adopting.

Trust

Sandbox only
68

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

Audit

Needs review
81

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

OpenAgentSkill Trust Score v5

Human review before install

Run only in a sandbox and compare close alternatives before using it for real work.

JavaScriptCodexClaude CodeCursorOpenAgentSkill CLI

Stars

10 GitHub stars

Repo activity

10 stars, 1 forks

Maintenance

29d since push

License

MIT

Install

npx skills add EvolveHQ/docflow

Install safety

standard package or runtime install path

Permission surface

shell or command execution, filesystem or document access

Agent outcomes

No agent outcome data yet

Docs

Strong README/SKILL.md context

Risk summary

Review before production

  • Low GitHub adoption signal
  • Quality score needs review
  • GitHub adoption: 10 GitHub stars
  • Stars/forks activity: 10 stars, 1 forks; issue activity unavailable in current metadata

Install readiness

Install path available

  • Install path is available
  • Repository evidence is available
  • License is declared
  • No Agent Proven outcome evidence yet

Agent-readable metadata

Machine-readable decision data for this skill.

Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.

Open JSON

Suited tasks

  • Coding agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects
  • Inspect source files

Suited agents

JavaScriptCodexClaude CodeCursorOpenAgentSkill CLIOpenAI AgentsCLI

Install decision

Command
npx skills add EvolveHQ/docflow
Policy
review
Human review
yes

Trust and risk

Trust
68/100
Audit
81/100
Risk level
Needs review

Outcome loop

Endpoint
/api/agent/outcome
Event ID
resolve
Outcomes
5

Install command

npx skills add EvolveHQ/docflow
Public auditEval reportResolve APIInstall handoff

Do not use when

  • teams that need a vendor-supported SLA
  • production agents without a repository review
  • Low GitHub adoption signal
  • High-risk permission hints: Shell or command execution
  • Quality score needs review

Alternative

Code Review

168.6K Stars

npx skills add mattpocock/skills --skill code-review

Alternative

Grill With Docs

164.7K Stars

npx skills add mattpocock/skills --skill grill-with-docs

Alternative

To Spec

164.7K Stars

npx skills add mattpocock/skills --skill to-spec

Alternative

To Tickets

176.7K Stars

npx skills add mattpocock/skills --skill to-tickets

Agent safety v2

49/100 · Avoid automatic install

Experimentalreview

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolve via API

high

Shell or command execution

Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.

medium

Browser automation

Skill may drive a browser or interact with web pages.

medium

Network access

Skill likely fetches remote pages, APIs, repositories, or external services.

medium

Filesystem access

Skill may read or write project files, documents, generated artifacts, or local workspace state.

  • High-risk permission hints: Shell or command execution
  • Low GitHub adoption signal

Install targets

Install this skill in your agent workflow

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install evolvehq-docflow

Agent resolve plan

Let an agent verify fit before installing.

The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.

Open text plan

Open JSON

/api/agent/resolve?task=Use%20Docflow%20for%20an%20agent%20workflow&agent=codex&max_risk=medium

Resolve text

/api/agent/resolve?task=Use%20Docflow%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text

Install handoff

/api/skills/evolvehq-docflow/install

Agent should check

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copy prompt

Task: Use Docflow in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Docflow%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/evolvehq-docflow/install
Install command: npx skills add EvolveHQ/docflow
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Agent handoff

Give an agent the install path, not another directory page.

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

Open install API

Install handoff

/api/skills/evolvehq-docflow/install

LLM text format

/api/skills/evolvehq-docflow/install?format=text

Find alternatives

/api/skills/search?q=Docflow&limit=3

Agent prompt

Use Docflow for this task. Review https://www.openagentskill.com/api/skills/evolvehq-docflow/install, then install with: npx skills add EvolveHQ/docflow

Registry metadata

Agent-readable profile for automatic skill selection.

This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.

Open manifest

Manifest

/api/registry/manifest/evolvehq-docflow

LLM text

/api/registry/manifest/evolvehq-docflow?format=text

Install alias

/api/registry/install/evolvehq-docflow

Recommend

/api/registry/recommend?task=Use%20Docflow%20in%20an%20agent%20workflow&limit=3

Agent fit

69/100

Coding agents

Use-case tags

Coding agentsGitHub automationRAG and knowledge

Platforms

JavaScript, Claude Code, OpenAI Agents

Audit report

Needs review · 81/100

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

View audit reportView eval report

Agent decision cockpit

Fallback candidate for Coding agents

Prototype with this skill first; keep a fallback candidate ready.

69
Readiness
Prototype
Stage

Role in stack

Fallback candidate

Primary fit

Coding agents

Trust label

Prototype first

Install path

Command ready

Use when

  • Coding agents workflows
  • Claude Code teams
  • builders willing to evaluate younger projects

Evidence

  • recent repository activity
  • install command or GitHub repo available
  • 68/100 quality profile
  • 4 OpenAgentSkill engagement events

review first

  • Low GitHub adoption signal

Implementation path

  1. 1Install it in a sandbox agent and run one Coding agents task end to end.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Trust profile

Sandbox only

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

68
OpenAgentSkill Trust Score

GitHub adoption

FIX

10 GitHub stars

Stars/forks activity

FIX

10 stars, 1 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

29d since push

License clarity

PASS

MIT

Good signals

  • AI review approved
  • Install path is available
  • Repository evidence is available
  • Recently maintained repository
  • Install command has no obvious high-risk pattern
  • Outcome loop is ready but needs first real agent run

Review before install

  • Low GitHub adoption signal
  • Quality score needs review
  • GitHub adoption: 10 GitHub stars
  • Stars/forks activity: 10 stars, 1 forks; issue activity unavailable in current metadata
  • No real agent outcome reports yet
  • Human review required before unattended installation

Recommended action

Run only in a sandbox and compare close alternatives before using it for real work.

Quality profile

Promising candidate for agent workflows

Useful candidate, but compare it with alternatives before adopting.

68
GitHub stars
10
Freshness
29d ago
Install ready
Yes
License
MIT
Review before install: Low GitHub adoption signal

Workflow fit

Use this skill in these scenarios

Build and ship code

Coding agents

I need a coding agent that can understand a repository, edit code, and review pull requests.

Manage repositories

GitHub automation

I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.

Search private knowledge

RAG and knowledge

I need my agent to build a RAG workflow over documents and retrieve reliable context.

Workflow fit

Add it to a complete workflow

Inspect, patch, and verify code

Coding review agent

A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.

Ingest, retrieve, and cite

RAG knowledge base

A workflow for document-heavy agents that ingest files, create searchable knowledge, retrieve relevant context, and answer with grounded sources.

Turn skills into distribution

Content growth agent

A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.

Alternative shortlist

Compare before you install

Similar skills that may fit this task.

Compare all

Code Review

Review a branch or diff against repository standards and the originating spec in two independent analysis passes.

Adopt
Ready100
Quality100
Stars168.6K

Grill With Docs

A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.

Adopt
Ready100
Quality100
Stars164.7K

To Spec

Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.

Adopt
Ready100
Quality100
Stars164.7K

To Tickets

Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.

Adopt
Ready100
Quality100
Stars176.7K

Overview

# docflow

![docflow — ADR-driven documentation workflow](docs/preview.png)

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:<name>` (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](USAGE.md). | | 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 |

Platform compatibility

javascriptFULL

Technical details

Version
1.0.0
License
MIT
Last updated
Aug 18, 2026
Published
Jul 25, 2026

Frameworks & tools

JavaScript

Decision snapshot

Fallback candidate

69
Ready
Prototype
Stage

recent repository activity

Audit

Install review

Install and adoption review

81
Needs review
Security
86/100
Maintenance
100/100
Install
92/100
Open full auditView eval report

Agent-proven evidence

Agent-proven evidence

Outcome reports after resolve, review, install, and one narrow run.

0
Proven
Needs first agent runAuto-install: review firstLast: Unknown
Success rate
—
Recent failure
—
Outcomes
0
Output quality
—
Failed
0
Not relevant
0
Installs
0
Risk blocked
0
Setup needed
0
Production
0

No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.

Agent-Proven rankingOutcome contract

Install

Add to agent workflow

Free and open source. Review the report before installing into production agents.

Compare AlternativesAuto-resolve PlanView on GitHubDocumentation

Growth loop

Share kit

X

Scenario-led draft for Docflow, ready for a manual X post.

Curator note
Docflow: ADR-driven documentation workflow skill for AI coding agents to scaffold and manage Architect...

10 stars

https://www.openagentskill.com/skills/evolvehq-docflow?ref=x
Open X draft
Optional reply with install command
Listing + install path for Docflow:
https://www.openagentskill.com/skills/evolvehq-docflow?ref=x

Install: npx skills add EvolveHQ/docflow
Open reply draft

Listing source

Community indexed

Claimable

This listing was indexed from public sources and is not marked official until a maintainer claim is approved.

Creator
EvolveHQ
Indexed by
OpenAgentSkill community index

Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.

Claim this skill

Owner claim

Claim this skill listing

This Community indexed listing is attributed to EvolveHQ but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.

Creator backlink kit

Add the evidence badges to your README

Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/evolvehq-docflow?metric=listed&label=Listed)](https://www.openagentskill.com/skills/evolvehq-docflow)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/evolvehq-docflow?metric=trust&label=Trust)](https://www.openagentskill.com/skills/evolvehq-docflow)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/evolvehq-docflow?metric=audit&label=Audit)](https://www.openagentskill.com/skills/evolvehq-docflow/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/evolvehq-docflow?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/evolvehq-docflow)
Preview badge Open audit Creator kit

Author

E

EvolveHQ

@evolvehq

Tags

adrdocumentationworkflowclaude-codepi-agent

Platform fit

Claude CodeOpenAI Agents

Health signals

GitHub stars
10
Quality score
42/100
Last GitHub push
Jul 25, 2026
Framework hints
1
OpenAgentSkill views
2
Install copies
0
Outbound clicks
0

Community signal

Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.

Trust & safety

Sandbox only

68
  • GitHub adoption10 GitHub starsFIX
  • Stars/forks activity10 stars, 1 forks; issue activity unavailable in current metadataFIX
  • Recent maintenance29d since pushPASS
  • License clarityMITPASS
  • README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
  • Dependency/runtime riskno major dependency risk hints in public metadataPASS

Related skills

Code Review

Review a branch or diff against repository standards and the originating spec in two independent analysis passes.

168.6K Stars

Grill With Docs

A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.

164.7K Stars

To Spec

Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.

164.7K Stars

To Tickets

Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.

176.7K Stars
InstallView on GitHub