flow-workflows 0.73.0 → 0.75.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 (103) hide show
  1. package/adapters/codex/CORE.md +2 -1
  2. package/adapters/codex/skills/flow-bug-fix/SKILL.md +5 -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-feat-build/SKILL.md +5 -1
  10. package/adapters/codex/skills/flow-feat-design/SKILL.md +2 -0
  11. package/adapters/codex/skills/flow-feat-plan/SKILL.md +2 -0
  12. package/adapters/codex/skills/flow-feat-review/SKILL.md +2 -0
  13. package/adapters/codex/skills/flow-feat-ship/SKILL.md +3 -1
  14. package/adapters/codex/skills/flow-feat-start/SKILL.md +2 -0
  15. package/adapters/codex/skills/flow-feat-validate/SKILL.md +2 -0
  16. package/adapters/codex/skills/flow-work-abandon/SKILL.md +2 -0
  17. package/adapters/codex/skills/flow-work-clean/SKILL.md +2 -0
  18. package/adapters/codex/skills/flow-work-daily/SKILL.md +2 -0
  19. package/adapters/codex/skills/flow-work-green/SKILL.md +2 -0
  20. package/adapters/codex/skills/flow-work-query/SKILL.md +2 -0
  21. package/adapters/codex/skills/flow-work-respond/SKILL.md +2 -0
  22. package/adapters/codex/skills/flow-work-resume/SKILL.md +2 -0
  23. package/adapters/codex/skills/flow-work-status/SKILL.md +2 -0
  24. package/adapters/codex/skills/flow-work-try/SKILL.md +2 -0
  25. package/adapters/codex/skills/flow-work-watch/SKILL.md +2 -0
  26. package/adapters/gemini/CORE.md +2 -1
  27. package/adapters/gemini/commands/flow/bug/fix.toml +5 -1
  28. package/adapters/gemini/commands/flow/bug/investigate.toml +2 -0
  29. package/adapters/gemini/commands/flow/bug/postmortem.toml +2 -0
  30. package/adapters/gemini/commands/flow/bug/review.toml +2 -0
  31. package/adapters/gemini/commands/flow/bug/ship.toml +2 -0
  32. package/adapters/gemini/commands/flow/bug/start.toml +2 -0
  33. package/adapters/gemini/commands/flow/bug/validate.toml +2 -0
  34. package/adapters/gemini/commands/flow/feat/build.toml +5 -1
  35. package/adapters/gemini/commands/flow/feat/design.toml +2 -0
  36. package/adapters/gemini/commands/flow/feat/plan.toml +2 -0
  37. package/adapters/gemini/commands/flow/feat/review.toml +2 -0
  38. package/adapters/gemini/commands/flow/feat/ship.toml +3 -1
  39. package/adapters/gemini/commands/flow/feat/start.toml +2 -0
  40. package/adapters/gemini/commands/flow/feat/validate.toml +2 -0
  41. package/adapters/gemini/commands/flow/work/abandon.toml +2 -0
  42. package/adapters/gemini/commands/flow/work/clean.toml +2 -0
  43. package/adapters/gemini/commands/flow/work/daily.toml +2 -0
  44. package/adapters/gemini/commands/flow/work/green.toml +2 -0
  45. package/adapters/gemini/commands/flow/work/query.toml +2 -0
  46. package/adapters/gemini/commands/flow/work/respond.toml +2 -0
  47. package/adapters/gemini/commands/flow/work/resume.toml +2 -0
  48. package/adapters/gemini/commands/flow/work/status.toml +2 -0
  49. package/adapters/gemini/commands/flow/work/try.toml +2 -0
  50. package/adapters/gemini/commands/flow/work/watch.toml +2 -0
  51. package/adapters/hermes/CORE.md +2 -1
  52. package/adapters/hermes/skills/flow-bug-fix/SKILL.md +5 -1
  53. package/adapters/hermes/skills/flow-bug-investigate/SKILL.md +2 -0
  54. package/adapters/hermes/skills/flow-bug-postmortem/SKILL.md +2 -0
  55. package/adapters/hermes/skills/flow-bug-review/SKILL.md +2 -0
  56. package/adapters/hermes/skills/flow-bug-ship/SKILL.md +2 -0
  57. package/adapters/hermes/skills/flow-bug-start/SKILL.md +2 -0
  58. package/adapters/hermes/skills/flow-bug-validate/SKILL.md +2 -0
  59. package/adapters/hermes/skills/flow-feat-build/SKILL.md +5 -1
  60. package/adapters/hermes/skills/flow-feat-design/SKILL.md +2 -0
  61. package/adapters/hermes/skills/flow-feat-plan/SKILL.md +2 -0
  62. package/adapters/hermes/skills/flow-feat-review/SKILL.md +2 -0
  63. package/adapters/hermes/skills/flow-feat-ship/SKILL.md +3 -1
  64. package/adapters/hermes/skills/flow-feat-start/SKILL.md +2 -0
  65. package/adapters/hermes/skills/flow-feat-validate/SKILL.md +2 -0
  66. package/adapters/hermes/skills/flow-work-abandon/SKILL.md +2 -0
  67. package/adapters/hermes/skills/flow-work-clean/SKILL.md +2 -0
  68. package/adapters/hermes/skills/flow-work-daily/SKILL.md +2 -0
  69. package/adapters/hermes/skills/flow-work-green/SKILL.md +2 -0
  70. package/adapters/hermes/skills/flow-work-query/SKILL.md +2 -0
  71. package/adapters/hermes/skills/flow-work-respond/SKILL.md +2 -0
  72. package/adapters/hermes/skills/flow-work-resume/SKILL.md +2 -0
  73. package/adapters/hermes/skills/flow-work-status/SKILL.md +2 -0
  74. package/adapters/hermes/skills/flow-work-try/SKILL.md +2 -0
  75. package/adapters/hermes/skills/flow-work-watch/SKILL.md +2 -0
  76. package/adapters/opencode/CORE.md +2 -1
  77. package/adapters/opencode/commands/flow-bug-fix.md +5 -1
  78. package/adapters/opencode/commands/flow-bug-investigate.md +2 -0
  79. package/adapters/opencode/commands/flow-bug-postmortem.md +2 -0
  80. package/adapters/opencode/commands/flow-bug-review.md +2 -0
  81. package/adapters/opencode/commands/flow-bug-ship.md +2 -0
  82. package/adapters/opencode/commands/flow-bug-start.md +2 -0
  83. package/adapters/opencode/commands/flow-bug-validate.md +2 -0
  84. package/adapters/opencode/commands/flow-feat-build.md +5 -1
  85. package/adapters/opencode/commands/flow-feat-design.md +2 -0
  86. package/adapters/opencode/commands/flow-feat-plan.md +2 -0
  87. package/adapters/opencode/commands/flow-feat-review.md +2 -0
  88. package/adapters/opencode/commands/flow-feat-ship.md +3 -1
  89. package/adapters/opencode/commands/flow-feat-start.md +2 -0
  90. package/adapters/opencode/commands/flow-feat-validate.md +2 -0
  91. package/adapters/opencode/commands/flow-work-abandon.md +2 -0
  92. package/adapters/opencode/commands/flow-work-clean.md +2 -0
  93. package/adapters/opencode/commands/flow-work-daily.md +2 -0
  94. package/adapters/opencode/commands/flow-work-green.md +2 -0
  95. package/adapters/opencode/commands/flow-work-query.md +2 -0
  96. package/adapters/opencode/commands/flow-work-respond.md +2 -0
  97. package/adapters/opencode/commands/flow-work-resume.md +2 -0
  98. package/adapters/opencode/commands/flow-work-status.md +2 -0
  99. package/adapters/opencode/commands/flow-work-try.md +2 -0
  100. package/adapters/opencode/commands/flow-work-watch.md +2 -0
  101. package/package.json +1 -1
  102. package/plugins/flow/.claude-plugin/plugin.json +1 -1
  103. package/plugins/flow/CHANGELOG.md +45 -0
@@ -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.73.0",
3
+ "version": "0.75.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.73.0",
6
+ "version": "0.75.0",
7
7
  "author": {
8
8
  "name": "Alberto Vioque",
9
9
  "email": "mashware@gmail.com"
@@ -5,6 +5,51 @@ 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.75.0 — The words the panel understands now travel with every command · 2026-09-22
9
+
10
+ **In short**
11
+ - **Every command carries the panel's vocabulary on its own opening lines**, so an agent whose shared
12
+ rules were dropped by a context compaction keeps publishing a panel that can still be read.
13
+ - **The panel stops degrading in silence.** The reader discards a word it does not know without
14
+ saying so, which is why the failure was invisible from the inside.
15
+ - **The release check pins every copy to one constant**: the sentence is built from the vocabulary
16
+ so the two cannot disagree, a locally edited copy fails, a new command without the line fails, and
17
+ a trigger that stops matching any file fails instead of going quietly green.
18
+
19
+ `flow-core` is read once per session. A compaction drops it, and from that moment the agent publishes
20
+ panels from memory — observed on 22 September: correct panels for thirty minutes, a compaction, then
21
+ four lines carrying the invented mark `doing`, and a panel that had become a paragraph of grey text
22
+ next to a pane whose panel was still laid out in full. Nobody was told, because an unknown word is
23
+ dropped by design.
24
+
25
+ The fix is one frozen sentence in all 24 command files, on the line after the one that loads the
26
+ skill — **not** at the points that order a publication: `build`, `review` and `validate` order none of
27
+ their own, and they are exactly the long phases where the failure was seen. `check_panel_reminder`
28
+ keeps the copies honest: every copy must be byte-identical to the constant, every file that loads the
29
+ skill must carry one — so the twenty-fifth command is caught the day it is added rather than by a
30
+ count nobody updated — and the check fails if its own trigger ever matches no file at all, which is
31
+ how a guard retires without telling anyone.
32
+
33
+ `docs/DESIGN.md` records the boundary this draws against the rule that removed eighteen hand copies of
34
+ a shared preamble: prose that can be reworded lives once; a closed enumeration may be repeated, if and
35
+ only if a check pins every copy to one constant.
36
+
37
+ ## v0.74.0 — The thing you were asked to approve was the thing the terminal hid · 2026-09-22
38
+
39
+ **In short**
40
+ - **What a gate asks about now travels with the question** — the brief, the MR/PR body, the plan — so it is read in the prompt being answered instead of by opening the artifact in an editor.
41
+ - **Nothing runs between showing it and asking.** A tool call right after is what lets a terminal collapse that message into one line, and the line it collapses is exactly the one the user needed.
42
+ - Applied at the two briefs (`feat:build`, `bug:fix`) and at the MR/PR preview, the three gates that exist to catch scope before there is a diff to argue with.
43
+
44
+ The rule already said to print the brief and then ask. It never said what had to sit between them,
45
+ so a status line, a file write or a `git` call landed in the middle — and a chat UI that folds a
46
+ message once a tool call follows it turned a nine-line brief into "· summarized". What reached the
47
+ user was a one-line paraphrase above a Yes/No, and the honest way to answer it was to open
48
+ `05-implementation.md` and read the brief there, which is the cost the gate exists to avoid.
49
+
50
+ Where a harness's question cannot hold the content, it is printed as the **last** thing before
51
+ asking, with the tool calls already done.
52
+
8
53
  ## v0.73.0 — The panel kept asking what you had already answered · 2026-09-22
9
54
 
10
55
  **In short**