flow-workflows 0.74.0 → 0.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/adapters/codex/CORE.md +1 -1
  2. package/adapters/codex/skills/flow-bug-fix/SKILL.md +3 -1
  3. package/adapters/codex/skills/flow-bug-investigate/SKILL.md +2 -0
  4. package/adapters/codex/skills/flow-bug-postmortem/SKILL.md +2 -0
  5. package/adapters/codex/skills/flow-bug-review/SKILL.md +2 -0
  6. package/adapters/codex/skills/flow-bug-ship/SKILL.md +2 -0
  7. package/adapters/codex/skills/flow-bug-start/SKILL.md +2 -0
  8. package/adapters/codex/skills/flow-bug-validate/SKILL.md +2 -0
  9. package/adapters/codex/skills/flow-doctor/SKILL.md +1 -0
  10. package/adapters/codex/skills/flow-feat-build/SKILL.md +6 -2
  11. package/adapters/codex/skills/flow-feat-design/SKILL.md +2 -0
  12. package/adapters/codex/skills/flow-feat-plan/SKILL.md +2 -0
  13. package/adapters/codex/skills/flow-feat-review/SKILL.md +2 -0
  14. package/adapters/codex/skills/flow-feat-ship/SKILL.md +2 -0
  15. package/adapters/codex/skills/flow-feat-start/SKILL.md +2 -0
  16. package/adapters/codex/skills/flow-feat-validate/SKILL.md +2 -0
  17. package/adapters/codex/skills/flow-work-abandon/SKILL.md +2 -0
  18. package/adapters/codex/skills/flow-work-clean/SKILL.md +2 -0
  19. package/adapters/codex/skills/flow-work-daily/SKILL.md +2 -0
  20. package/adapters/codex/skills/flow-work-green/SKILL.md +2 -0
  21. package/adapters/codex/skills/flow-work-query/SKILL.md +2 -0
  22. package/adapters/codex/skills/flow-work-respond/SKILL.md +2 -0
  23. package/adapters/codex/skills/flow-work-resume/SKILL.md +2 -0
  24. package/adapters/codex/skills/flow-work-status/SKILL.md +2 -0
  25. package/adapters/codex/skills/flow-work-try/SKILL.md +2 -0
  26. package/adapters/codex/skills/flow-work-watch/SKILL.md +2 -0
  27. package/adapters/gemini/CORE.md +1 -1
  28. package/adapters/gemini/commands/flow/bug/fix.toml +3 -1
  29. package/adapters/gemini/commands/flow/bug/investigate.toml +2 -0
  30. package/adapters/gemini/commands/flow/bug/postmortem.toml +2 -0
  31. package/adapters/gemini/commands/flow/bug/review.toml +2 -0
  32. package/adapters/gemini/commands/flow/bug/ship.toml +2 -0
  33. package/adapters/gemini/commands/flow/bug/start.toml +2 -0
  34. package/adapters/gemini/commands/flow/bug/validate.toml +2 -0
  35. package/adapters/gemini/commands/flow/doctor.toml +1 -0
  36. package/adapters/gemini/commands/flow/feat/build.toml +6 -2
  37. package/adapters/gemini/commands/flow/feat/design.toml +2 -0
  38. package/adapters/gemini/commands/flow/feat/plan.toml +2 -0
  39. package/adapters/gemini/commands/flow/feat/review.toml +2 -0
  40. package/adapters/gemini/commands/flow/feat/ship.toml +2 -0
  41. package/adapters/gemini/commands/flow/feat/start.toml +2 -0
  42. package/adapters/gemini/commands/flow/feat/validate.toml +2 -0
  43. package/adapters/gemini/commands/flow/work/abandon.toml +2 -0
  44. package/adapters/gemini/commands/flow/work/clean.toml +2 -0
  45. package/adapters/gemini/commands/flow/work/daily.toml +2 -0
  46. package/adapters/gemini/commands/flow/work/green.toml +2 -0
  47. package/adapters/gemini/commands/flow/work/query.toml +2 -0
  48. package/adapters/gemini/commands/flow/work/respond.toml +2 -0
  49. package/adapters/gemini/commands/flow/work/resume.toml +2 -0
  50. package/adapters/gemini/commands/flow/work/status.toml +2 -0
  51. package/adapters/gemini/commands/flow/work/try.toml +2 -0
  52. package/adapters/gemini/commands/flow/work/watch.toml +2 -0
  53. package/adapters/hermes/CORE.md +1 -1
  54. package/adapters/hermes/skills/flow-bug-fix/SKILL.md +3 -1
  55. package/adapters/hermes/skills/flow-bug-investigate/SKILL.md +2 -0
  56. package/adapters/hermes/skills/flow-bug-postmortem/SKILL.md +2 -0
  57. package/adapters/hermes/skills/flow-bug-review/SKILL.md +2 -0
  58. package/adapters/hermes/skills/flow-bug-ship/SKILL.md +2 -0
  59. package/adapters/hermes/skills/flow-bug-start/SKILL.md +2 -0
  60. package/adapters/hermes/skills/flow-bug-validate/SKILL.md +2 -0
  61. package/adapters/hermes/skills/flow-doctor/SKILL.md +1 -0
  62. package/adapters/hermes/skills/flow-feat-build/SKILL.md +6 -2
  63. package/adapters/hermes/skills/flow-feat-design/SKILL.md +2 -0
  64. package/adapters/hermes/skills/flow-feat-plan/SKILL.md +2 -0
  65. package/adapters/hermes/skills/flow-feat-review/SKILL.md +2 -0
  66. package/adapters/hermes/skills/flow-feat-ship/SKILL.md +2 -0
  67. package/adapters/hermes/skills/flow-feat-start/SKILL.md +2 -0
  68. package/adapters/hermes/skills/flow-feat-validate/SKILL.md +2 -0
  69. package/adapters/hermes/skills/flow-work-abandon/SKILL.md +2 -0
  70. package/adapters/hermes/skills/flow-work-clean/SKILL.md +2 -0
  71. package/adapters/hermes/skills/flow-work-daily/SKILL.md +2 -0
  72. package/adapters/hermes/skills/flow-work-green/SKILL.md +2 -0
  73. package/adapters/hermes/skills/flow-work-query/SKILL.md +2 -0
  74. package/adapters/hermes/skills/flow-work-respond/SKILL.md +2 -0
  75. package/adapters/hermes/skills/flow-work-resume/SKILL.md +2 -0
  76. package/adapters/hermes/skills/flow-work-status/SKILL.md +2 -0
  77. package/adapters/hermes/skills/flow-work-try/SKILL.md +2 -0
  78. package/adapters/hermes/skills/flow-work-watch/SKILL.md +2 -0
  79. package/adapters/opencode/CORE.md +1 -1
  80. package/adapters/opencode/commands/flow-bug-fix.md +3 -1
  81. package/adapters/opencode/commands/flow-bug-investigate.md +2 -0
  82. package/adapters/opencode/commands/flow-bug-postmortem.md +2 -0
  83. package/adapters/opencode/commands/flow-bug-review.md +2 -0
  84. package/adapters/opencode/commands/flow-bug-ship.md +2 -0
  85. package/adapters/opencode/commands/flow-bug-start.md +2 -0
  86. package/adapters/opencode/commands/flow-bug-validate.md +2 -0
  87. package/adapters/opencode/commands/flow-doctor.md +1 -0
  88. package/adapters/opencode/commands/flow-feat-build.md +6 -2
  89. package/adapters/opencode/commands/flow-feat-design.md +2 -0
  90. package/adapters/opencode/commands/flow-feat-plan.md +2 -0
  91. package/adapters/opencode/commands/flow-feat-review.md +2 -0
  92. package/adapters/opencode/commands/flow-feat-ship.md +2 -0
  93. package/adapters/opencode/commands/flow-feat-start.md +2 -0
  94. package/adapters/opencode/commands/flow-feat-validate.md +2 -0
  95. package/adapters/opencode/commands/flow-work-abandon.md +2 -0
  96. package/adapters/opencode/commands/flow-work-clean.md +2 -0
  97. package/adapters/opencode/commands/flow-work-daily.md +2 -0
  98. package/adapters/opencode/commands/flow-work-green.md +2 -0
  99. package/adapters/opencode/commands/flow-work-query.md +2 -0
  100. package/adapters/opencode/commands/flow-work-respond.md +2 -0
  101. package/adapters/opencode/commands/flow-work-resume.md +2 -0
  102. package/adapters/opencode/commands/flow-work-status.md +2 -0
  103. package/adapters/opencode/commands/flow-work-try.md +2 -0
  104. package/adapters/opencode/commands/flow-work-watch.md +2 -0
  105. package/package.json +1 -1
  106. package/plugins/flow/.claude-plugin/plugin.json +1 -1
  107. package/plugins/flow/CHANGELOG.md +43 -0
@@ -18,6 +18,8 @@ description: Your work assistant — a Scrum-style daily standup across all your
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, autonomy, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session.
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  External sources (tracker, forge, `knowledge`) are all **best-effort**: a CLI missing/unauthenticated, an MCP failing, or a call over ~3s → continue without that source and note it in a single line; **never block**.
22
24
 
23
25
  Your **work assistant**: a Scrum-style daily standup — *"what was I working on?"*, *"what's left?"*, *"what should I pick up today?"* — from three sources: **local** work state, the **forge** (open MRs/PRs, reviews, CI), the **tracker** (assigned/re-prioritized tickets). Unlike `/flow-work-status` (technical table) and `/flow-work-resume` (one branch), a cross-cutting narrative briefing.
@@ -32,6 +32,8 @@ Extract from `git`: `host`, `cli` (empty → the default for that host), `defaul
32
32
 
33
33
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, models, autonomy modes and hard gates, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session. **Models: the subagents it launches take `models.agents`; the wait it delegates takes `models.supervisors`.**
34
34
 
35
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
36
+
35
37
  **Autonomy.** Modes as in flow-core §2; `guided`/`auto` record their choices in `09-ci.md` (e.g. a pure formatter auto-fix). **Hard gates — ALWAYS stop and ask, in every mode, no exceptions:**
36
38
  1. **Any push** (§6).
37
39
  2. Creating/switching a branch, or DB schema changes/migrations, if a fix requires them.
@@ -18,6 +18,8 @@ description: Put a data-access query on trial — schema, indexes, execution pla
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, models, autonomy modes and hard gates, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session. **Models: the subagents it launches take `models.agents`; its parallel rounds take `models.workers`.**
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  **A query is approved by its plan, not by prose.** Fact sheet → challenger attacks → each point settled with a **plan or a number**. **Cross-cutting** (feat or bug), **repeatable**, does **not** advance `meta.json.phase`; runs with or without a work folder.
22
24
 
23
25
  Invoked by `/flow-feat-review` and `/flow-bug-review` (duel over the diff), `/flow-work-respond` (a reviewer objected to a query), `/flow-feat-design` (access paths), `/flow-feat-build`, `/flow-feat-validate`. Invoke directly for any doubt outside them (chat question, comment on an open MR/PR, a year-old query).
@@ -28,6 +28,8 @@ Extract from `git`: `host`, `cli` (empty → the default for that host), `assign
28
28
 
29
29
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, models, autonomy modes and hard gates, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session. **Models: this command runs with the model it was launched with (no `models` key).**
30
30
 
31
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
32
+
31
33
  **Autonomy.** Modes as in flow-core §2 (`autonomy.mode`: `manual` | `guided` | `auto`; empty = `manual`); `guided`/`auto` record their choices in `08-feedback.md`. **Hard gates — ALWAYS stop and ask, in every mode, no exceptions:**
32
34
  1. **Posting any comment/reply** to the MR/PR (§7).
33
35
  2. **Any push** (§6.2).
@@ -18,6 +18,8 @@ description: Resume the work associated with the current branch and suggest the
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, autonomy, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session.
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  Use when returning to a work after a break (next morning, another session).
22
24
 
23
25
  ## 1. Detection
@@ -18,6 +18,8 @@ description: Summary of all open works in .claude/work/
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, autonomy, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session.
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  Overview of works in progress; detects divergences between artifacts and actual git state.
22
24
 
23
25
  ## 1. List works
@@ -18,6 +18,8 @@ description: Point the main checkout at a branch to test it (then return), re-sy
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, autonomy, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session.
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  Temporarily point the **main checkout** at another branch to test it against this checkout's live environment (running stack, DB, containers), then return — a generic `make wt-try`/`wt-back` pair. The git switch is built in; the project-specific re-sync (e.g. migrations) comes from `git.worktree_resync` in `FLOW.md`. Operates **in place**; never creates or touches worktrees.
22
24
 
23
25
  ## 1. Parse the argument
@@ -18,6 +18,8 @@ description: Monitor the observability platform after a deploy and alert on erro
18
18
 
19
19
  Read `~/.claude/flow/CORE.opencode.md` first (shared rules: `FLOW.md` step 0, models, autonomy modes and hard gates, how a stop reads, the live panel, `00-summary.md`) — skip if you already read it in this session. **Models: this command runs with the model it was launched with; the wait it delegates takes `models.supervisors`.**
20
20
 
21
+ **Panel words are closed** — `mark`: `done` · `current` · `pending` · `wait` · `block` · `info`; `style`: `normal` · `dim` · `title` · `accent` · `ok` · `warn` · `error`. Anything else is dropped by the reader in silence: the panel still paints, and nobody is told.
22
+
21
23
  **Autopiloted post-deploy monitoring**: signals **scoped to the change** over a window (default 30 min), against a baseline; alert on errors or performance regressions from the deploy.
22
24
 
23
25
  Usage: `/flow-work-watch {PREFIX}XXXXX [duration]` (prefix from `tracker.prefix`; default `30m`).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flow-workflows",
3
- "version": "0.74.0",
3
+ "version": "0.76.0",
4
4
  "description": "Guided feat/bug workflows (start→ship), post-deploy monitoring and multi-agent code review, stack-agnostic. Each repo uses a shared FLOW.md plus optional harness overlay.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -3,7 +3,7 @@
3
3
  "name": "flow",
4
4
  "displayName": "Flow — guided dev workflows",
5
5
  "description": "Guided feat/bug workflows (start→ship), post-deploy monitoring and multi-agent code review, stack-agnostic. Each repo uses a shared FLOW.md plus optional harness overlay.",
6
- "version": "0.74.0",
6
+ "version": "0.76.0",
7
7
  "author": {
8
8
  "name": "Alberto Vioque",
9
9
  "email": "mashware@gmail.com"
@@ -5,6 +5,49 @@ plugin and is what `/flow:news` reads to show you what changed since your previo
5
5
 
6
6
  The canonical, richest notes live in the [GitHub Releases](https://github.com/mashware/flow-workflows/releases).
7
7
 
8
+ ## v0.76.0 — The plan was written for a list the terminal was never given · 2026-09-22
9
+
10
+ **In short**
11
+ - **`build` and `fix` look for the task-list tool before they use it**, including the deferred list,
12
+ and when there is none they tick the plan's steps in the phase artifact and say so once.
13
+ - **`/flow:doctor` reports whether a task-list tool is there**, and on Claude Code names the setting
14
+ that brings it back.
15
+
16
+ Since v0.70.0 `build` writes a plan per MR/PR and seeds the terminal's step list from it. On 22
17
+ September the plan was written (`## Plan MR/PR #3`) and no list ever appeared: Claude Code withholds
18
+ its task tools from newer models unless `CLAUDE_CODE_ENABLE_TODO_TOOLS=true` is set, and when the
19
+ setting is on it lists them deferred. Either way the instruction named a tool that was not callable,
20
+ and it was skipped without a word — across three sessions, not one task call.
21
+
22
+ ## v0.75.0 — The words the panel understands now travel with every command · 2026-09-22
23
+
24
+ **In short**
25
+ - **Every command carries the panel's vocabulary on its own opening lines**, so an agent whose shared
26
+ rules were dropped by a context compaction keeps publishing a panel that can still be read.
27
+ - **The panel stops degrading in silence.** The reader discards a word it does not know without
28
+ saying so, which is why the failure was invisible from the inside.
29
+ - **The release check pins every copy to one constant**: the sentence is built from the vocabulary
30
+ so the two cannot disagree, a locally edited copy fails, a new command without the line fails, and
31
+ a trigger that stops matching any file fails instead of going quietly green.
32
+
33
+ `flow-core` is read once per session. A compaction drops it, and from that moment the agent publishes
34
+ panels from memory — observed on 22 September: correct panels for thirty minutes, a compaction, then
35
+ four lines carrying the invented mark `doing`, and a panel that had become a paragraph of grey text
36
+ next to a pane whose panel was still laid out in full. Nobody was told, because an unknown word is
37
+ dropped by design.
38
+
39
+ The fix is one frozen sentence in all 24 command files, on the line after the one that loads the
40
+ skill — **not** at the points that order a publication: `build`, `review` and `validate` order none of
41
+ their own, and they are exactly the long phases where the failure was seen. `check_panel_reminder`
42
+ keeps the copies honest: every copy must be byte-identical to the constant, every file that loads the
43
+ skill must carry one — so the twenty-fifth command is caught the day it is added rather than by a
44
+ count nobody updated — and the check fails if its own trigger ever matches no file at all, which is
45
+ how a guard retires without telling anyone.
46
+
47
+ `docs/DESIGN.md` records the boundary this draws against the rule that removed eighteen hand copies of
48
+ a shared preamble: prose that can be reworded lives once; a closed enumeration may be repeated, if and
49
+ only if a check pins every copy to one constant.
50
+
8
51
  ## v0.74.0 — The thing you were asked to approve was the thing the terminal hid · 2026-09-22
9
52
 
10
53
  **In short**