@evolvehq/docflow 0.6.0 → 0.7.0

package/README.md

@@ -2,8 +2,9 @@
 
 ![docflow — ADR-driven documentation workflow](docs/preview.png)
 
-A plugin for **ADR-driven, documentation-led projects**, working on both
-the **pi** and **Claude Code** coding agents from the same skill files.
+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
@@ -66,9 +67,23 @@ rather than overwriting them).
 
 ## Install
 
-docflow ships for two coding agents from the **same** skill files — only
-the manifest differs (`.claude-plugin/` for Claude Code, `package.json`
-for pi).
+docflow ships from **one `skills/` tree** to five coding agents — only
+the packaging differs. Two surfaces: the scaffolded **output**
+(`AGENTS.md`, the ADR catalogue, `plan/`, `_agent/`) is plain Markdown
+read natively by any agent that loads `AGENTS.md`; the **skills** are
+`SKILL.md` files the host discovers.
+
+| Agent | Output | Skills | Install | Invoke |
+|-------|:------:|:------:|---------|--------|
+| Claude Code | native | ✅ | marketplace (below) | `/bootstrap` |
+| Claude Cowork | native | ✅ | same Claude Code plugin | `/bootstrap` |
+| pi | native | ✅ | `pi install npm:@evolvehq/docflow` | `/skill:bootstrap` |
+| Codex | native | ✅ | copy into `~/.agents/skills/` | `$bootstrap` / `/skills` |
+| OpenCode | native | ✅ | reads `.claude`/`.agents`/`.opencode` skills | auto, by description |
+
+Handy: `~/.agents/skills/` is read by **both Codex and OpenCode**, and
+`~/.claude/skills/` by **both Claude Code and OpenCode** — so one install
+often serves two agents.
 
 ### Claude Code — from this marketplace
 
@@ -80,6 +95,13 @@ for pi).
 Invoke with `/bootstrap`, `/new-adr`, `/ship-item`, … (auto-triggers on
 matching requests too).
 
+### Claude Cowork
+
+Cowork uses the **same plugin system** as Claude Code, so install the
+docflow plugin exactly as above (`/plugin marketplace add
+EvolveHQ/docflow`, then install) — or from Anthropic's community
+marketplace once listed. No separate packaging.
+
 ### pi coding agent
 
 ```
@@ -97,6 +119,32 @@ The scaffolded output (`AGENTS.md`, `CONVENTIONS.md`, the ADR catalogue,
 `plan/`, `_agent/`) is plain Markdown and is read natively by pi's
 hierarchical `AGENTS.md` loading — no porting needed.
 
+### Codex (OpenAI)
+
+Codex reads `AGENTS.md` natively and discovers skills from `.agents/skills`.
+Copy docflow's skills into a path Codex scans:
+
+```
+# user-wide (all projects), from a clone of this repo:
+mkdir -p ~/.agents/skills && cp -r <docflow>/skills/* ~/.agents/skills/
+# or from npm:
+npm install @evolvehq/docflow
+cp -r node_modules/@evolvehq/docflow/skills/* ~/.agents/skills/
+```
+
+On Windows, copy `skills\*` into `%USERPROFILE%\.agents\skills\`. Invoke
+with `$bootstrap` / `/skills`, or just describe the task (Codex
+auto-triggers from the skill description). The structured assessment
+questions fall back to plain `A/B/C` text where there is no select tool.
+
+### OpenCode (sst)
+
+OpenCode scans `.opencode/skills/`, **`.claude/skills/`, and
+`.agents/skills/`** (project and global), so a Claude Code or Codex
+install is **picked up automatically** — or copy `skills/*` into
+`~/.config/opencode/skills/` (or per-project `.opencode/skills/`). Skills
+auto-load by description.
+
 ### Claude Code — local development (no install)
 
 ```

package/USAGE.md

@@ -164,12 +164,33 @@ The repo is now ready for ADR-driven work. Typical first steps:
 ## 5a. Lifecycle skills
 
 The manual workflow in §5 is exactly what the lifecycle skills
-automate. They all share three properties: they **read `CONVENTIONS.md`
-first** and honour the repo's recorded choices (ADR shape, status
-lifecycle, integration model, multi-agent mode); they **refuse on an
-un-bootstrapped repo** and point at `/bootstrap`; and they keep
-`INDEX.md` and the `_agent/` coordination files in sync as a side
-effect.
+automate. They all share four properties: they **run a short assessment
+first** (see below); they **read `CONVENTIONS.md` first** and honour the
+repo's recorded choices (ADR shape, status lifecycle, integration model,
+multi-agent mode); they **refuse on an un-bootstrapped repo** and point
+at `/bootstrap`; and they keep `INDEX.md` and the `_agent/` coordination
+files in sync as a side effect.
+
+**The assessment protocol.** `new-adr`, `new-plan`, `add-convention`,
+`brainstorm`, and `agent-wave` each open with a brief assessment before
+acting — the same pattern bootstrap uses (§3):
+
+- An **opt-out gate** first: *run the assessment, or skip it?* The
+  recommended default flips on context — *run* when you invoked the skill
+  with little detail, *skip* when your request already specifies
+  everything.
+- Questions are asked **one at a time**, each with a **recommended
+  option** you can accept, override, or replace.
+- Answers use **scroll-to-select** (single- or multiple-choice) where the
+  host exposes a selection tool (Claude Code's `AskUserQuestion`), falling
+  back to plain `A/B/C` lists otherwise. Free text is used only where an
+  enumerable set is impossible (e.g. an ADR title).
+- **You decide** — a skill never proceeds past a question without your
+  input, and never guesses scope when invoked with no context.
+
+`agent-wave` additionally asks the wave parallelism and the merge /
+integration strategy. So a bare *"new ADR"* leads with a couple of quick
+picks; a fully-specified request lets you skip straight through.
 
 | Skill | Replaces these manual steps |
 |-------|------------------------------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolvehq/docflow",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "ADR-driven documentation workflow: scaffold an Architecture Decision Record (ADR) catalogue, a plan/ queue, and AGENTS.md conventions into any repo, then author, queue, ship, and audit ADRs with lifecycle skills. Works with the pi coding agent and Claude Code.",
   "keywords": [
     "pi-package",