Skip to content

docs: refresh stale CLI references after the flow-verb redesign - #100

Merged
eduralph merged 1 commit into
mainfrom
docs/refresh-cli-references
Jun 21, 2026
Merged

docs: refresh stale CLI references after the flow-verb redesign#100
eduralph merged 1 commit into
mainfrom
docs/refresh-cli-references

Conversation

@eduralph

@eduralph eduralph commented Jun 21, 2026

Copy link
Copy Markdown
Owner

Summary

Closes #101.

A documentation audit against the current code (the flow-verb redesign #85#89, Act-default-on #86, publish-on-accept #97, worktree isolation #94) surfaced docs naming removed/renamed commands and an out-of-date leaf count. This brings them in line:

  • README.mdpdca batchpdca flow <ids>; pdca flow|batch --lanespdca flow --lanes; pdca act-index/act-logpdca act index/act log; quickstart now leads with pdca flow (+ --rehearse); "two leaf commands" → "model-leaf commands"; added Publish-on-accept and Per-cycle-worktree-isolation to "What's built" (both were missing).
  • template/CLAUDE.md.jinjapdca flow … [--act][--no-act] (Act runs by default since Unify flow + batch into one flow: arity selects batch; auto-Plan when unbriefed #86).
  • template/PCDA/quality-cycle/03-cycle-automation.md[--act][--no-publish] [--no-act]; "two leaves to five" → "six" and added the publisher leaf to the enumeration.
  • docs/04-do.md — dropped the backticks on "batch" (it's a batch run, not the removed verb).

Verification

  • Docs-only change; lint_docs OK.
  • The docs/ guide folder and the rendered command table in template/README.md.jinja were already current (they correctly use flow, --no-publish, --no-act, act index/act log, etc.).

Out of scope (noted, no change)

  • template/PCDA/.claudian/sessions/*.meta.json is local untracked session cache (0 committed files) — won't ship via copier. Optional future hardening: gitignore it + add .claudian to copier _exclude alongside .obsidian.

🤖 Generated with Claude Code

The CLI redesign (#85#89), Act-default-on (#86), and the publish/worktree work
(#97/#94) left several docs naming removed/renamed commands and an out-of-date leaf
count. Bring the docs in line with the current verb set:

- README.md: `pdca batch` → `pdca flow <ids>`; `pdca flow|batch --lanes` →
  `pdca flow --lanes`; `pdca act-index`/`act-log` → `pdca act index`/`act log`;
  quickstart leads with `pdca flow` (+ `--rehearse`); "two leaf commands" →
  "model-leaf commands"; add Publish-on-accept and Per-cycle-worktree-isolation to
  "What's built" (both were missing).
- template/CLAUDE.md.jinja: `pdca flow … [--act]` → `[--no-act]` (Act is default-on).
- template/PCDA/quality-cycle/03-cycle-automation.md: `[--act]` →
  `[--no-publish] [--no-act]`; "two leaves to five" → "six" and add the publisher
  leaf to the enumeration.
- docs/04-do.md: drop the backticks on "batch" (a batch run, not the removed verb).

Docs-only; lint_docs OK. The docs/ guide folder and the rendered command table in
template/README.md.jinja were already current.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Eduard Ralph <15236434+eduralph@users.noreply.github.com>
@eduralph
eduralph merged commit 51a17c8 into main Jun 21, 2026
2 of 3 checks passed
@eduralph
eduralph deleted the docs/refresh-cli-references branch June 21, 2026 13:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs name removed/renamed CLI verbs after the flow-verb redesign

1 participant