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.
- package/adapters/codex/CORE.md +1 -1
- package/adapters/codex/skills/flow-bug-fix/SKILL.md +3 -1
- package/adapters/codex/skills/flow-bug-investigate/SKILL.md +2 -0
- package/adapters/codex/skills/flow-bug-postmortem/SKILL.md +2 -0
- package/adapters/codex/skills/flow-bug-review/SKILL.md +2 -0
- package/adapters/codex/skills/flow-bug-ship/SKILL.md +2 -0
- package/adapters/codex/skills/flow-bug-start/SKILL.md +2 -0
- package/adapters/codex/skills/flow-bug-validate/SKILL.md +2 -0
- package/adapters/codex/skills/flow-doctor/SKILL.md +1 -0
- package/adapters/codex/skills/flow-feat-build/SKILL.md +6 -2
- package/adapters/codex/skills/flow-feat-design/SKILL.md +2 -0
- package/adapters/codex/skills/flow-feat-plan/SKILL.md +2 -0
- package/adapters/codex/skills/flow-feat-review/SKILL.md +2 -0
- package/adapters/codex/skills/flow-feat-ship/SKILL.md +2 -0
- package/adapters/codex/skills/flow-feat-start/SKILL.md +2 -0
- package/adapters/codex/skills/flow-feat-validate/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-abandon/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-clean/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-daily/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-green/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-query/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-respond/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-resume/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-status/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-try/SKILL.md +2 -0
- package/adapters/codex/skills/flow-work-watch/SKILL.md +2 -0
- package/adapters/gemini/CORE.md +1 -1
- package/adapters/gemini/commands/flow/bug/fix.toml +3 -1
- package/adapters/gemini/commands/flow/bug/investigate.toml +2 -0
- package/adapters/gemini/commands/flow/bug/postmortem.toml +2 -0
- package/adapters/gemini/commands/flow/bug/review.toml +2 -0
- package/adapters/gemini/commands/flow/bug/ship.toml +2 -0
- package/adapters/gemini/commands/flow/bug/start.toml +2 -0
- package/adapters/gemini/commands/flow/bug/validate.toml +2 -0
- package/adapters/gemini/commands/flow/doctor.toml +1 -0
- package/adapters/gemini/commands/flow/feat/build.toml +6 -2
- package/adapters/gemini/commands/flow/feat/design.toml +2 -0
- package/adapters/gemini/commands/flow/feat/plan.toml +2 -0
- package/adapters/gemini/commands/flow/feat/review.toml +2 -0
- package/adapters/gemini/commands/flow/feat/ship.toml +2 -0
- package/adapters/gemini/commands/flow/feat/start.toml +2 -0
- package/adapters/gemini/commands/flow/feat/validate.toml +2 -0
- package/adapters/gemini/commands/flow/work/abandon.toml +2 -0
- package/adapters/gemini/commands/flow/work/clean.toml +2 -0
- package/adapters/gemini/commands/flow/work/daily.toml +2 -0
- package/adapters/gemini/commands/flow/work/green.toml +2 -0
- package/adapters/gemini/commands/flow/work/query.toml +2 -0
- package/adapters/gemini/commands/flow/work/respond.toml +2 -0
- package/adapters/gemini/commands/flow/work/resume.toml +2 -0
- package/adapters/gemini/commands/flow/work/status.toml +2 -0
- package/adapters/gemini/commands/flow/work/try.toml +2 -0
- package/adapters/gemini/commands/flow/work/watch.toml +2 -0
- package/adapters/hermes/CORE.md +1 -1
- package/adapters/hermes/skills/flow-bug-fix/SKILL.md +3 -1
- package/adapters/hermes/skills/flow-bug-investigate/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-bug-postmortem/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-bug-review/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-bug-ship/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-bug-start/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-bug-validate/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-doctor/SKILL.md +1 -0
- package/adapters/hermes/skills/flow-feat-build/SKILL.md +6 -2
- package/adapters/hermes/skills/flow-feat-design/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-feat-plan/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-feat-review/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-feat-ship/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-feat-start/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-feat-validate/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-abandon/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-clean/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-daily/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-green/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-query/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-respond/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-resume/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-status/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-try/SKILL.md +2 -0
- package/adapters/hermes/skills/flow-work-watch/SKILL.md +2 -0
- package/adapters/opencode/CORE.md +1 -1
- package/adapters/opencode/commands/flow-bug-fix.md +3 -1
- package/adapters/opencode/commands/flow-bug-investigate.md +2 -0
- package/adapters/opencode/commands/flow-bug-postmortem.md +2 -0
- package/adapters/opencode/commands/flow-bug-review.md +2 -0
- package/adapters/opencode/commands/flow-bug-ship.md +2 -0
- package/adapters/opencode/commands/flow-bug-start.md +2 -0
- package/adapters/opencode/commands/flow-bug-validate.md +2 -0
- package/adapters/opencode/commands/flow-doctor.md +1 -0
- package/adapters/opencode/commands/flow-feat-build.md +6 -2
- package/adapters/opencode/commands/flow-feat-design.md +2 -0
- package/adapters/opencode/commands/flow-feat-plan.md +2 -0
- package/adapters/opencode/commands/flow-feat-review.md +2 -0
- package/adapters/opencode/commands/flow-feat-ship.md +2 -0
- package/adapters/opencode/commands/flow-feat-start.md +2 -0
- package/adapters/opencode/commands/flow-feat-validate.md +2 -0
- package/adapters/opencode/commands/flow-work-abandon.md +2 -0
- package/adapters/opencode/commands/flow-work-clean.md +2 -0
- package/adapters/opencode/commands/flow-work-daily.md +2 -0
- package/adapters/opencode/commands/flow-work-green.md +2 -0
- package/adapters/opencode/commands/flow-work-query.md +2 -0
- package/adapters/opencode/commands/flow-work-respond.md +2 -0
- package/adapters/opencode/commands/flow-work-resume.md +2 -0
- package/adapters/opencode/commands/flow-work-status.md +2 -0
- package/adapters/opencode/commands/flow-work-try.md +2 -0
- package/adapters/opencode/commands/flow-work-watch.md +2 -0
- package/package.json +1 -1
- package/plugins/flow/.claude-plugin/plugin.json +1 -1
- 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.
|
|
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.
|
|
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**
|