@fernado03/zoo-flow 0.7.7 → 0.7.9

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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@fernado03/zoo-flow",
3
3
  "description": "Workflow control plane for Zoo Code.",
4
- "version": "0.7.7",
4
+ "version": "0.7.9",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "zoo-flow": "bin/zoo-flow.js"
@@ -6,8 +6,9 @@ mode: system-architect
6
6
  EXECUTION RULES:
7
7
  1. READ `.zoo-flow/CONTEXT.md`. If it does not exist, output one line before step 2: "No CONTEXT.md found. Run /scaffold-context to fill, or continue without." Do not invent content.
8
8
  2. RUN skill: `.roo/skills/engineering/zoom-out/SKILL.md`.
9
- 3. OUTPUT MAP: Create markdown with sections: Domain language, Modules, Data flow, Seams/callers, ADRs, Open questions. Write the full map to `.scratch/explorations/<date>/explore-<slug>.md`.
10
- 4. NEXT STEPS: Suggest `/scaffold-context`, `/feature`, `/refactor`, or `/fix`. DO NOT auto-launch.
11
- 5. COMPLETION: Reference the `.scratch/` file path in `attempt_completion`. The orchestrator will read and present it.
9
+ 3. OUTPUT MAP: Create markdown with sections: Domain language, Modules, Data flow, Seams/callers, ADRs, Open questions. Derive slug from the target area (e.g. "auth module" → `auth-module.md`). Write to `.scratch/explorations/<YYYY-MM-DD>/<slug>.md`.
10
+ 4. WRITE POINTER: Write the exact file path to `.scratch/LAST-EXPLORATION.md` so next commands can find it.
11
+ 5. NEXT STEPS: Suggest `/scaffold-context`, `/feature`, `/refactor`, or `/fix`. DO NOT auto-launch.
12
+ 6. COMPLETION: Include the exact file path in `attempt_completion`.
12
13
 
13
14
  $ARGUMENTS
@@ -5,6 +5,7 @@ mode: system-architect
5
5
  ---
6
6
  EXECUTION RULES (Run sequentially. Wait for user between phases):
7
7
  0. TRACK: At start, write a phase checklist to `.scratch/feature-<slug>.md` (phases 1-5, each unchecked). Before any `switch_mode` or `attempt_completion`, update it. Do NOT `attempt_completion` while any phase is unchecked — `switch_mode` to the phase's owner instead.
8
+ 0b. READ `.scratch/LAST-EXPLORATION.md` if it exists to find the most recent exploration map. Reference it in phase 1.
8
9
  1. SHARPEN (Architect): Run skill `.roo/skills/engineering/grill-with-docs/SKILL.md`. Update docs.
9
10
  HARD STOP: Ask user to choose: Prototype OR skip to PRD.
10
11
  2. PROTOTYPE [Optional]: Follow `.roo/rules-system-architect/01-feature-prototype.md` for the architect→tweaker handoff.
@@ -5,6 +5,7 @@ mode: system-architect
5
5
  ---
6
6
  EXECUTION RULES:
7
7
  0. TRACK: At start, write a phase checklist to `.scratch/fix-<slug>.md` (phases 1-5, each unchecked). Before any `switch_mode` or `attempt_completion`, update it. Do NOT `attempt_completion` while any phase is unchecked — `switch_mode` to the phase's owner instead.
8
+ 0b. READ `.scratch/LAST-EXPLORATION.md` if it exists to find the most recent exploration map. Reference it in phase 1.
8
9
  1. DIAGNOSE (Architect): Run skill `.roo/skills/engineering/diagnose/SKILL.md`. Run phases 1-3.
9
10
  HARD STOP: Present hypotheses. Wait for user selection. Ignore internal AFK rules.
10
11
  2. INSTRUMENT (Architect): Run phase 4 on chosen hypothesis. Find root cause.
@@ -5,6 +5,7 @@ mode: system-architect
5
5
  ---
6
6
  EXECUTION RULES:
7
7
  0. TRACK: At start, write a phase checklist to `.scratch/refactor-<slug>.md` (phases 1-3, each unchecked). Before any `switch_mode` or `attempt_completion`, update it. Do NOT `attempt_completion` while any phase is unchecked — `switch_mode` to the phase's owner instead.
8
+ 0b. READ `.scratch/LAST-EXPLORATION.md` if it exists to find the most recent exploration map. Reference it in phase 1.
8
9
  1. FIND (Architect): Run skill `.roo/skills/engineering/improve-codebase-architecture/SKILL.md`. List candidates.
9
10
  HARD STOP: Ask user which candidate to explore.
10
11
  2. GRILL (Architect): Run grilling loop. Update CONTEXT/ADRs inline.
@@ -20,7 +20,7 @@ Before any `attempt_completion`, re-read the command body and confirm no later p
20
20
  - remaining risk (what was not checked or is uncertain)
21
21
  - recommended next command (one only, no auto-launch)
22
22
 
23
- Before `attempt_completion`, present the full output to the user in a normal message if the work produced long results (verification report, diff summary). Then `attempt_completion` with only: brief status, file path if written to `.scratch/`, and recommended next command. The orchestrator summarizes completion messages — the user must see the full output first.
23
+ Write long output (verification report, diff summary) to `.scratch/` with a descriptive path. `attempt_completion` must include: file path where output was saved, brief status, and recommended next command. The user will open the file to see full details.
24
24
 
25
25
  Before running `git commit` or `git push`, halt and wait for explicit user approval. Never push unless explicitly asked.
26
26
 
@@ -6,12 +6,10 @@ Router only. No reading implementation files, editing, shell, or answering imple
6
6
 
7
7
  After `attempt_completion` from a worker, the orchestrator must:
8
8
 
9
- 1. Show the worker's completion message (brief status + file path + recommended next command).
9
+ 1. Show the worker's completion message to the user (file path + brief status + recommended next command).
10
10
  2. Stop and wait for user input.
11
11
 
12
- The worker already presented the full output in a normal message before `attempt_completion`. The orchestrator does not need to repeat it.
13
-
14
- Do not route a new user message until the completion message is fully presented.
12
+ The full output is in the `.scratch/` file referenced by the worker. The orchestrator does not read it the user opens it in the editor.
15
13
 
16
14
  ## Hard delegation boundary
17
15
 
@@ -11,7 +11,7 @@ If you entered this window via `switch_mode` (you are mid-chain, not the entry p
11
11
 
12
12
  Before any `attempt_completion`, re-read the command body and confirm no later phase is assigned to another mode. If one is, `switch_mode` instead.
13
13
 
14
- Do not use `attempt_completion` to avoid required implementation work. Before `attempt_completion`, present the full output to the user in a normal message so they see the complete details (review findings, exploration map, diagnosis, plan). Then `attempt_completion` with only: brief status, file path if written to `.scratch/`, and recommended next command. The orchestrator summarizes completion messages — the user must see the full output first.
14
+ Do not use `attempt_completion` to avoid required implementation work. Write the full output (review findings, exploration map, diagnosis, plan) to `.scratch/` with a descriptive path. `attempt_completion` must include: file path where output was saved, brief status, and recommended next command. The user will open the file to see full details.
15
15
 
16
16
  Halt for explicit user approval before testing a bug hypothesis, finalizing an architecture plan, publishing issues, or making irreversible decisions.
17
17