@evolvehq/docflow 0.7.0 → 0.7.1

package/README.md

@@ -78,12 +78,11 @@ read natively by any agent that loads `AGENTS.md`; the **skills** are
 | 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 |
+| Codex | native | ✅ | `codex plugin marketplace add EvolveHQ/docflow` | `$bootstrap` / `/skills` |
+| OpenCode | native | ✅ | auto-discovered, or symlink into `~/.config/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.
+Handy: OpenCode also reads `~/.claude/skills/` and `~/.agents/skills/`, so
+a shared skills directory can serve it alongside another agent.
 
 ### Claude Code — from this marketplace
 
@@ -121,29 +120,36 @@ 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:
+docflow ships a Codex plugin (`.codex-plugin/`), so it's a one-command
+install from this repo's marketplace:
 
 ```
-# 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/
+codex plugin marketplace add EvolveHQ/docflow
+codex plugin install docflow
 ```
 
-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.
+Codex reads the scaffolded `AGENTS.md` natively. Invoke with `$bootstrap`
+/ `/skills`, or just describe the task (Codex auto-triggers from the skill
+description); the assessment questions fall back to plain `A/B/C` text
+where there is no select tool. Update later with `codex plugin
+marketplace upgrade`.
 
 ### 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.
+OpenCode auto-discovers skills from `.claude/skills`, `.agents/skills`,
+and `.opencode/skills` (project and global) — so **if you already run
+docflow on Claude Code or Codex via a shared skills directory, OpenCode
+picks it up with no extra step.** Standalone, symlink the skills into
+OpenCode's global directory (one command, stays in sync with the clone):
+
+```
+git clone https://github.com/EvolveHQ/docflow ~/.docflow-src
+ln -s ~/.docflow-src/skills/* ~/.config/opencode/skills/
+```
+
+OpenCode has no marketplace command for `SKILL.md` skills (its plugin
+system is for npm JS plugins), so a shared skills directory is the clean
+path. Skills auto-load by description.
 
 ### Claude Code — local development (no install)
 
@@ -209,10 +215,14 @@ to extend or override the templates.
 ```
 docflow/
   .claude-plugin/
-    plugin.json          # Claude Code plugin manifest
+    plugin.json          # Claude Code / Cowork plugin manifest
     marketplace.json     # Claude Code marketplace listing (repo is its own marketplace)
+  .codex-plugin/
+    plugin.json          # Codex plugin manifest (skills -> ./skills)
+  .agents/plugins/
+    marketplace.json     # Codex marketplace listing
   package.json           # pi package manifest (pi.skills -> ./skills) + npm metadata
-  skills/
+  skills/                # the one skill source, shared by every target
     bootstrap/
       SKILL.md           # bootstrap: assessment + output sequence + backfill
       templates/         # files the bootstrap reads and writes into target repos

package/USAGE.md

@@ -5,21 +5,58 @@ what each of the 10 assessment questions actually changes in the
 output, and how to customise or extend the templates. The lifecycle
 skills are covered in §5a.
 
-For installation, see the [README](README.md).
-
-## 1. Triggering the bootstrap skill
-
-Once the plugin is installed (or `--plugin-dir`'d) into a Claude Code
-session, the skill is available in any repo. Three ways to trigger:
-
-1. **Slash command:** `/bootstrap`.
-2. **Natural language** matching the skill's description, e.g.
-   - "set up documentation-led conventions in this repo"
-   - "bootstrap ADRs and a plan queue"
-   - "scaffold AGENTS.md and the _agent/ layout"
-   - "retrofit this existing repo with the documentation conventions"
-3. **From another agent's prompt** — name the skill explicitly:
-   *"invoke the `bootstrap` skill on this repository."*
+## Install (per platform)
+
+docflow runs from **one `skills/` tree** on five coding agents. 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 | Install | Invoke |
+|-------|---------|--------|
+| **Claude Code** | `/plugin marketplace add EvolveHQ/docflow` then `/plugin install docflow@evolvehq` | `/bootstrap` |
+| **Claude Cowork** | the **same** Claude Code plugin (`/plugin marketplace add …`) — Cowork shares the plugin system | `/bootstrap` |
+| **pi** | `pi install npm:@evolvehq/docflow` (or `pi install git:github.com/EvolveHQ/docflow`) | `/skill:bootstrap` |
+| **Codex** | `codex plugin marketplace add EvolveHQ/docflow` then `codex plugin install docflow` (native plugin) | `$bootstrap` / `/skills` |
+| **OpenCode** | auto-discovers `.claude`/`.agents`/`.opencode` skills (so a Claude Code / Codex install is picked up), or symlink into `~/.config/opencode/skills` | auto, by description |
+
+Notes:
+
+- **Codex** ships a native plugin (`.codex-plugin/`), so it's a one-command
+  install like Claude Code. **OpenCode** has no marketplace command for
+  `SKILL.md` skills (its plugin system is npm JS plugins), so it relies on
+  skills-directory auto-discovery or a symlink.
+- A **shared skills directory** can serve two agents: `~/.agents/skills/`
+  is read by Codex and OpenCode; `~/.claude/skills/` by Claude Code and
+  OpenCode.
+- The scaffolded output needs no porting on any of them — it is read
+  natively wherever `AGENTS.md` is the instruction file.
+
+See the [README](README.md#install) for the full matrix, Windows paths,
+and local-development options.
+
+## 1. Triggering the skills
+
+Once docflow is installed (per the table above), the skills are available
+in any repo. Invocation differs per agent:
+
+| Agent | Slash / mention | Auto-trigger from description |
+|-------|-----------------|-------------------------------|
+| Claude Code / Cowork | `/bootstrap`, `/new-adr`, … | yes |
+| pi | `/skill:bootstrap`, `/skill:new-adr`, … | no — invoke explicitly |
+| Codex | `$bootstrap` / `/skills` | yes |
+| OpenCode | (loaded by name) | yes, by description |
+
+On agents that **auto-trigger**, natural-language matching the skill's
+description also works, e.g.:
+
+- "set up documentation-led conventions in this repo"
+- "bootstrap ADRs and a plan queue"
+- "scaffold AGENTS.md and the _agent/ layout"
+- "retrofit this existing repo with the documentation conventions"
+
+Or, on any agent, name the skill explicitly: *"invoke the `bootstrap`
+skill on this repository."*
 
 ## 2. The flow
 
@@ -340,6 +377,16 @@ To remove the plugin entirely:
 /plugin uninstall docflow@evolvehq
 ```
 
+**Other agents:**
+
+- **Cowork** — same as Claude Code (`/plugin marketplace update` →
+  install).
+- **pi** — re-run `pi install npm:@evolvehq/docflow` (or the `git:` form).
+- **Codex** — `codex plugin marketplace upgrade` then `codex plugin
+  install docflow`.
+- **OpenCode** — if installed via a clone/symlink, `git pull` the clone;
+  skills reload on the next session.
+
 ### As the author (you, maintaining this repo)
 
 1. Edit a skill body (`skills/<name>/SKILL.md`), the bootstrap templates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolvehq/docflow",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "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",