@fernado03/zoo-flow 0.12.0 → 0.12.2

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 (81) hide show
  1. package/docs/architecture.md +380 -0
  2. package/docs/bloat-control.md +49 -0
  3. package/docs/command-design.md +38 -0
  4. package/docs/command-flow.md +133 -0
  5. package/docs/comparison.md +86 -0
  6. package/docs/context-packs.md +35 -0
  7. package/docs/dogfood/01-small-library.md +28 -0
  8. package/docs/dogfood/02-web-app.md +29 -0
  9. package/docs/dogfood/03-mixed-monorepo.md +29 -0
  10. package/docs/mode-rules.md +86 -0
  11. package/docs/npm-publishing.md +79 -0
  12. package/docs/out-of-scope/mainstream-issue-trackers-only.md +25 -0
  13. package/docs/out-of-scope/question-limits.md +18 -0
  14. package/docs/out-of-scope/setup-skill-verify-mode.md +15 -0
  15. package/docs/overview.md +61 -0
  16. package/docs/philosophy.md +73 -0
  17. package/docs/quality-scorecard.md +23 -0
  18. package/docs/skill-maintenance.md +32 -0
  19. package/docs/skills-index.md +64 -0
  20. package/docs/team-mode.md +46 -0
  21. package/docs/token-budget.md +22 -0
  22. package/docs/troubleshooting.md +288 -0
  23. package/examples/demo-transcripts/01-small-tweak.md +37 -0
  24. package/examples/demo-transcripts/02-unknown-bug-fix.md +37 -0
  25. package/examples/demo-transcripts/03-new-feature.md +37 -0
  26. package/examples/demo-transcripts/04-refactor.md +37 -0
  27. package/examples/demo-transcripts/05-review-and-verify.md +37 -0
  28. package/examples/feature-flow.md +117 -0
  29. package/examples/fix-flow.md +139 -0
  30. package/package.json +5 -2
  31. package/scripts/check-package-links.js +1 -1
  32. package/scripts/eval-routing.js +1 -1
  33. package/scripts/score-quality.js +3 -3
  34. package/scripts/test-doctor.js +5 -5
  35. package/templates/claude-code/.claude/skills/engineering/diagnose/SKILL.md +2 -2
  36. package/templates/claude-code/.claude/skills/engineering/explore/SKILL.md +1 -1
  37. package/templates/claude-code/.claude/skills/engineering/feature/SKILL.md +1 -1
  38. package/templates/claude-code/.claude/skills/engineering/fix/SKILL.md +1 -1
  39. package/templates/claude-code/.claude/skills/engineering/grill-with-docs/SKILL.md +1 -1
  40. package/templates/claude-code/.claude/skills/engineering/improve-codebase-architecture/SKILL.md +1 -1
  41. package/templates/claude-code/.claude/skills/engineering/refactor/SKILL.md +1 -1
  42. package/templates/claude-code/.claude/skills/engineering/review/SKILL.md +6 -6
  43. package/templates/claude-code/.claude/skills/engineering/scaffold-context/SKILL.md +1 -1
  44. package/templates/claude-code/.claude/skills/engineering/setup-matt-pocock-skills/SKILL.md +1 -1
  45. package/templates/claude-code/.claude/skills/engineering/tdd/SKILL.md +1 -1
  46. package/templates/claude-code/.claude/skills/engineering/to-issues/SKILL.md +1 -1
  47. package/templates/claude-code/.claude/skills/engineering/to-prd/SKILL.md +1 -1
  48. package/templates/claude-code/.claude/skills/engineering/triage/SKILL.md +1 -1
  49. package/templates/claude-code/.claude/skills/engineering/tweak/SKILL.md +1 -1
  50. package/templates/claude-code/.claude/skills/engineering/update-docs/SKILL.md +1 -1
  51. package/templates/claude-code/.claude/skills/engineering/verify/SKILL.md +1 -1
  52. package/templates/claude-code/.claude/skills/engineering/zoom-out/SKILL.md +1 -1
  53. package/templates/claude-code/.claude/skills/productivity/caveman/SKILL.md +1 -1
  54. package/templates/claude-code/.zoo-flow/CONTEXT.md +1 -1
  55. package/templates/claude-code/.zoo-flow/START_HERE.md +5 -5
  56. package/templates/claude-code/.zoo-flow/evals/no-regression-checklist.md +2 -2
  57. package/templates/claude-code/.zoo-flow/evals/routing-cases.md +4 -4
  58. package/templates/claude-code/CLAUDE.md +47 -56
  59. package/templates/full/.roo/commands/zoo-caveman.md +1 -1
  60. package/templates/full/.roo/commands/zoo-explore.md +3 -3
  61. package/templates/full/.roo/commands/zoo-feature.md +1 -1
  62. package/templates/full/.roo/commands/zoo-fix.md +2 -2
  63. package/templates/full/.roo/commands/zoo-refactor.md +2 -2
  64. package/templates/full/.roo/commands/zoo-update-docs.md +4 -4
  65. package/templates/full/.roo/rules/03-manual-reply-protocol.md +1 -1
  66. package/templates/full/.roo/rules/04-context-economy.md +1 -1
  67. package/templates/full/.roo/rules-code-tweaker/01-completion.md +3 -3
  68. package/templates/full/.roo/rules-custom-orchestrator/00-routing.md +1 -1
  69. package/templates/full/.roo/rules-custom-orchestrator/01-delegation-message.md +14 -14
  70. package/templates/full/.roo/rules-system-architect/01-feature-prototype.md +2 -2
  71. package/templates/full/.roo/rules-system-architect/02-completion.md +3 -3
  72. package/templates/full/.roo/skills/docs/adr/0001-explicit-setup-pointer-only-for-hard-dependencies.md +2 -2
  73. package/templates/full/.roo/skills/engineering/README.md +1 -1
  74. package/templates/full/.roo/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md +1 -1
  75. package/templates/full/.roo/skills/engineering/scaffold-context/templates/writing-patterns.md +1 -1
  76. package/templates/full/.roo/skills/engineering/setup-matt-pocock-skills/domain.md +1 -1
  77. package/templates/full/.zoo-flow/CONTEXT.md +1 -1
  78. package/templates/full/.zoo-flow/START_HERE.md +1 -1
  79. package/templates/full/.zoo-flow/evals/no-regression-checklist.md +5 -5
  80. package/templates/full/.zoo-flow/evals/routing-cases.md +32 -32
  81. package/tests/fixtures/doctor/helper-not-permitted/fixture.json +1 -1
@@ -5,7 +5,7 @@ You are part of a structured workflow system with two behavioral profiles that a
5
5
  ## Behavioral Profiles
6
6
 
7
7
  ### Architect Profile
8
- - **Activation**: Commands like `/fix`, `/feature`, `/refactor`, `/explore`, `/diagnose`, `/review`, `/triage`, `/grill-with-docs`, `/improve-codebase-architecture`, `/to-prd`, `/to-issues`, `/zoom-out`, `/handoff`, `/grill-me`
8
+ - **Activation**: Commands like `/zoo-fix`, `/zoo-feature`, `/zoo-refactor`, `/zoo-explore`, `/zoo-diagnose`, `/zoo-review`, `/zoo-triage`, `/zoo-grill-with-docs`, `/zoo-improve-codebase-architecture`, `/zoo-to-prd`, `/zoo-to-issues`, `/zoo-zoom-out`, `/zoo-handoff`, `/zoo-grill-me`
9
9
  - **Scope**: Plan, diagnose, explore, refactor-design, triage, and review
10
10
  - **File access**: Read-only for application code. May edit markdown files, `.scratch/`, and `docs/`
11
11
  - **Delegation**: Use `Agent` tool to delegate implementation to implementer profile
@@ -13,7 +13,7 @@ You are part of a structured workflow system with two behavioral profiles that a
13
13
  - **Never**: Write implementation code, run tests, or make direct source changes
14
14
 
15
15
  ### Implementer Profile
16
- - **Activation**: Commands like `/tweak`, `/tdd`, `/update-docs`, `/commit-and-document`, `/prototype`, `/scaffold-context`, `/verify`, `/write-a-skill`, `/setup-matt-pocock-skills`, `/teach`
16
+ - **Activation**: Commands like `/zoo-tweak`, `/zoo-tdd`, `/zoo-update-docs`, `/zoo-commit-and-document`, `/zoo-prototype`, `/zoo-scaffold-context`, `/zoo-verify`, `/zoo-write-a-skill`, `/zoo-setup-matt-pocock-skills`, `/zoo-teach`
17
17
  - **Scope**: Implement, test, update docs, prototype, and commit (after approval)
18
18
  - **File access**: Full repository access within task scope
19
19
  - **Escalation**: Use `Agent` tool to delegate architecture decisions to architect profile
@@ -28,64 +28,64 @@ When a user makes a request without a slash command, infer the best workflow and
28
28
 
29
29
  | User Request Pattern | Workflow | Command | Profile |
30
30
  |---|---|---|---|
31
- | "Fix bug", "Why is X broken?", "Error in..." | Diagnose and fix | `/fix` | Architect → Implementer |
32
- | "Add feature", "Implement X", "New capability" | Feature development | `/feature` | Architect → Implementer |
33
- | "Refactor", "Clean up", "Improve structure" | Refactoring | `/refactor` | Architect → Implementer |
34
- | "Explore codebase", "How does X work?", "Map..." | Exploration | `/explore` | Architect |
35
- | "Review code", "Check this PR", "Audit..." | Code review | `/review` | Architect |
36
- | "Triage issues", "Review tickets", "Sort bugs" | Issue triage | `/triage` | Architect |
37
- | "Grill design", "Challenge assumptions", "What if..." | Design validation | `/grill-with-docs` | Architect |
38
- | "Improve architecture", "Deepen design", "Find patterns" | Architecture improvement | `/improve-codebase-architecture` | Architect |
39
- | "Write PRD", "Product spec", "Requirements doc" | PRD creation | `/to-prd` | Architect |
40
- | "Break into issues", "Create tasks", "Slice work" | Issue creation | `/to-issues` | Architect |
41
- | "Zoom out", "Big picture", "Architectural view" | High-level overview | `/zoom-out` | Architect |
42
- | "Small change", "Quick fix", "Update this", "Change X to Y" | Direct implementation | `/tweak` | Implementer |
43
- | "Write tests first", "TDD", "Test-driven" | Test-driven development | `/tdd` | Implementer |
44
- | "Update docs", "Fix documentation", "Docs are wrong" | Documentation update | `/update-docs` | Implementer |
45
- | "Commit and document", "Journal this", "Document changes" | Commit workflow | `/commit-and-document` | Implementer |
46
- | "Prototype", "Try this out", "Experiment with" | Prototyping | `/prototype` | Implementer |
47
- | "Scaffold context", "Initialize docs", "Set up CONTEXT.md" | Context scaffolding | `/scaffold-context` | Implementer |
48
- | "Verify", "Check if tests pass", "Run validation" | Verification | `/verify` | Implementer |
49
- | "Caveman mode", "Be brief", "Less tokens" | Compressed communication | `/caveman` | Implementer |
31
+ | "Fix bug", "Why is X broken?", "Error in..." | Diagnose and fix | `/zoo-fix` | Architect → Implementer |
32
+ | "Add feature", "Implement X", "New capability" | Feature development | `/zoo-feature` | Architect → Implementer |
33
+ | "Refactor", "Clean up", "Improve structure" | Refactoring | `/zoo-refactor` | Architect → Implementer |
34
+ | "Explore codebase", "How does X work?", "Map..." | Exploration | `/zoo-explore` | Architect |
35
+ | "Review code", "Check this PR", "Audit..." | Code review | `/zoo-review` | Architect |
36
+ | "Triage issues", "Review tickets", "Sort bugs" | Issue triage | `/zoo-triage` | Architect |
37
+ | "Grill design", "Challenge assumptions", "What if..." | Design validation | `/zoo-grill-with-docs` | Architect |
38
+ | "Improve architecture", "Deepen design", "Find patterns" | Architecture improvement | `/zoo-improve-codebase-architecture` | Architect |
39
+ | "Write PRD", "Product spec", "Requirements doc" | PRD creation | `/zoo-to-prd` | Architect |
40
+ | "Break into issues", "Create tasks", "Slice work" | Issue creation | `/zoo-to-issues` | Architect |
41
+ | "Zoom out", "Big picture", "Architectural view" | High-level overview | `/zoo-zoom-out` | Architect |
42
+ | "Small change", "Quick fix", "Update this", "Change X to Y" | Direct implementation | `/zoo-tweak` | Implementer |
43
+ | "Write tests first", "TDD", "Test-driven" | Test-driven development | `/zoo-tdd` | Implementer |
44
+ | "Update docs", "Fix documentation", "Docs are wrong" | Documentation update | `/zoo-update-docs` | Implementer |
45
+ | "Commit and document", "Journal this", "Document changes" | Commit workflow | `/zoo-commit-and-document` | Implementer |
46
+ | "Prototype", "Try this out", "Experiment with" | Prototyping | `/zoo-prototype` | Implementer |
47
+ | "Scaffold context", "Initialize docs", "Set up CONTEXT.md" | Context scaffolding | `/zoo-scaffold-context` | Implementer |
48
+ | "Verify", "Check if tests pass", "Run validation" | Verification | `/zoo-verify` | Implementer |
49
+ | "Caveman mode", "Be brief", "Less tokens" | Compressed communication | `/zoo-caveman` | Implementer |
50
50
 
51
51
  ### Decision Guide
52
52
 
53
53
  When inferring workflow, consider:
54
54
 
55
- 1. **Is it a bug or error?** → `/fix` (diagnose first, then implement)
56
- 2. **Is it a new feature?** → `/feature` (architect plans, implementer builds)
57
- 3. **Is it improving existing code structure?** → `/refactor` (architect identifies improvements, implementer applies)
58
- 4. **Is it exploratory?** → `/explore` (architect maps the territory)
59
- 5. **Is it a code review?** → `/review` (architect evaluates)
60
- 6. **Is it a small, well-defined change?** → `/tweak` (implementer handles directly)
61
- 7. **Is it test-first development?** → `/tdd` (implementer writes tests, then code)
62
- 8. **Is it documentation?** → `/update-docs` (implementer updates)
63
- 9. **Is it committing work?** → `/commit-and-document` (implementer follows commit workflow)
64
- 10. **Is it prototyping?** → `/prototype` (implementer builds throwaway)
55
+ 1. **Is it a bug or error?** → `/zoo-fix` (diagnose first, then implement)
56
+ 2. **Is it a new feature?** → `/zoo-feature` (architect plans, implementer builds)
57
+ 3. **Is it improving existing code structure?** → `/zoo-refactor` (architect identifies improvements, implementer applies)
58
+ 4. **Is it exploratory?** → `/zoo-explore` (architect maps the territory)
59
+ 5. **Is it a code review?** → `/zoo-review` (architect evaluates)
60
+ 6. **Is it a small, well-defined change?** → `/zoo-tweak` (implementer handles directly)
61
+ 7. **Is it test-first development?** → `/zoo-tdd` (implementer writes tests, then code)
62
+ 8. **Is it documentation?** → `/zoo-update-docs` (implementer updates)
63
+ 9. **Is it committing work?** → `/zoo-commit-and-document` (implementer follows commit workflow)
64
+ 10. **Is it prototyping?** → `/zoo-prototype` (implementer builds throwaway)
65
65
 
66
66
  ### Risk Levels
67
67
 
68
68
  Assess risk to choose appropriate workflow:
69
69
 
70
- - **Low risk** (typos, comments, simple renames): `/tweak`
71
- - **Medium risk** (single-function changes, clear requirements): `/tweak` or `/tdd`
72
- - **High risk** (architecture changes, cross-cutting concerns): `/fix`, `/feature`, or `/refactor`
73
- - **Critical risk** (security, performance, data handling): Always start with architect workflow (`/fix`, `/feature`, `/refactor`)
70
+ - **Low risk** (typos, comments, simple renames): `/zoo-tweak`
71
+ - **Medium risk** (single-function changes, clear requirements): `/zoo-tweak` or `/zoo-tdd`
72
+ - **High risk** (architecture changes, cross-cutting concerns): `/zoo-fix`, `/zoo-feature`, or `/zoo-refactor`
73
+ - **Critical risk** (security, performance, data handling): Always start with architect workflow (`/zoo-fix`, `/zoo-feature`, `/zoo-refactor`)
74
74
 
75
75
  ## Approval Gates
76
76
 
77
77
  **Critical rule**: When proposing a workflow, always wait for explicit user approval before delegating.
78
78
 
79
- 1. **Propose**: "This sounds like it needs [workflow]. Should I proceed with `/command`?"
79
+ 1. **Propose**: "This sounds like it needs [workflow]. Should I proceed with `/zoo-[command]`?"
80
80
  2. **Wait**: Do not delegate until user confirms (e.g., "yes", "proceed", "go ahead")
81
81
  3. **Delegate**: Only after approval, use `Agent` tool with appropriate profile and command
82
82
 
83
83
  Example:
84
84
  ```
85
85
  User: "The login page is broken"
86
- Assistant: "This sounds like it needs diagnosis and fixing. Should I proceed with `/fix`?"
86
+ Assistant: "This sounds like it needs diagnosis and fixing. Should I proceed with `/zoo-fix`?"
87
87
  User: "yes"
88
- Assistant: [delegates to architect with /fix command]
88
+ Assistant: [delegates to architect with /zoo-fix command]
89
89
  ```
90
90
 
91
91
  Never assume approval. Never delegate without explicit confirmation.
@@ -147,7 +147,7 @@ This is similar to how ultracode's Workflow tool handles subagent completion.
147
147
 
148
148
  ### Multi-Phase Commands
149
149
 
150
- Commands like `/fix`, `/feature`, and `/refactor` involve multiple phases:
150
+ Commands like `/zoo-fix`, `/zoo-feature`, and `/zoo-refactor` involve multiple phases:
151
151
 
152
152
  **Fix workflow:**
153
153
  1. Architect diagnoses the problem
@@ -203,7 +203,7 @@ When presenting options or choices:
203
203
  - Wait for numbered response: "1" or "Option A"
204
204
 
205
205
  **DON'T:**
206
- - Reference internal commands: "Should I use `/fix` or `/feature`?"
206
+ - Reference internal commands: "Should I use `/zoo-fix` or `/zoo-feature`?"
207
207
  - Use profile names: "Should the architect or implementer handle this?"
208
208
  - Assume approval: Never delegate without explicit confirmation
209
209
 
@@ -229,24 +229,15 @@ When using tools:
229
229
  6. **Never delete branches**: Let users manage branch lifecycle
230
230
  7. **Never modify protected files**: Respect `.gitignore` and security-sensitive files
231
231
 
232
- ### MCP Awareness
233
-
234
- If MCP (Model Context Protocol) servers are available:
235
-
236
- 1. **Check available tools**: Use `mcp_list_tools` to see what's available
237
- 2. **Use when appropriate**: Prefer MCP tools when they're more efficient (e.g., database queries, API calls)
238
- 3. **Fall back gracefully**: If MCP tools fail, use standard Claude Code tools
239
- 4. **Don't assume**: Not all environments have MCP servers configured
240
-
241
232
  ## Quick Start
242
233
 
243
- 1. **First session**: Run `/scaffold-context` to initialize project documentation
244
- 2. **Small changes**: Use `/tweak` for quick fixes and updates
245
- 3. **Bug fixes**: Use `/fix` for diagnosis and repair
246
- 4. **New features**: Use `/feature` for planned implementation
247
- 5. **Refactoring**: Use `/refactor` for structural improvements
248
- 6. **Exploration**: Use `/explore` to understand unfamiliar code
249
- 7. **Reviews**: Use `/review` before committing significant changes
234
+ 1. **First session**: Run `/zoo-scaffold-context` to initialize project documentation
235
+ 2. **Small changes**: Use `/zoo-tweak` for quick fixes and updates
236
+ 3. **Bug fixes**: Use `/zoo-fix` for diagnosis and repair
237
+ 4. **New features**: Use `/zoo-feature` for planned implementation
238
+ 5. **Refactoring**: Use `/zoo-refactor` for structural improvements
239
+ 6. **Exploration**: Use `/zoo-explore` to understand unfamiliar code
240
+ 7. **Reviews**: Use `/zoo-review` before committing significant changes
250
241
 
251
242
  ## Workflow Philosophy
252
243
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says \"caveman mode\", \"talk like caveman\", \"use caveman\", \"less tokens\", \"be brief\", or invokes /caveman."
2
+ description: "Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says \"caveman mode\", \"talk like caveman\", \"use caveman\", \"less tokens\", \"be brief\", or invokes /zoo-caveman."
3
3
  ---
4
4
 
5
5
  Skill: `.roo/skills/productivity/caveman/SKILL.md`
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Explore unfamiliar code before /feature, /refactor, or /fix. Produces written map."
2
+ description: "Explore unfamiliar code before /zoo-feature, /zoo-refactor, or /zoo-fix. Produces written map."
3
3
  argument-hint: <feature or folder to map>
4
4
  mode: system-architect
5
5
  ---
@@ -9,10 +9,10 @@ Explore unfamiliar code and produce a written map. Follow the skill exactly.
9
9
  Skill: `.roo/skills/engineering/zoom-out/SKILL.md`
10
10
 
11
11
  EXECUTION RULES:
12
- 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.
12
+ 1. READ `.zoo-flow/CONTEXT.md`. If it does not exist, output one line before step 2: "No CONTEXT.md found. Run /zoo-scaffold-context to fill, or continue without." Do not invent content.
13
13
  2. 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`.
14
14
  3. WRITE POINTER: Write the exact file path to `.scratch/LAST-EXPLORATION.md` so next commands can find it.
15
- 4. NEXT STEPS: Suggest `/scaffold-context`, `/feature`, `/refactor`, or `/fix`. DO NOT auto-launch.
15
+ 4. NEXT STEPS: Suggest `/zoo-scaffold-context`, `/zoo-feature`, `/zoo-refactor`, or `/zoo-fix`. DO NOT auto-launch.
16
16
  5. COMPLETION: Call `attempt_completion` with the exact file path, status, and recommended next command. Do NOT use `ask_followup_question` or write results as plain text.
17
17
 
18
18
  $ARGUMENTS
@@ -17,6 +17,6 @@ EXECUTION RULES (Run sequentially. Wait for user between phases):
17
17
  5. IMPLEMENT (Tweaker):
18
18
  - Architect summarizes issues.
19
19
  - Architect MUST `switch_mode` -> `code-tweaker`.
20
- - Tweaker: For each issue, execute the `/tdd` command workflow (per `.roo/rules/01-command-protocol.md`). After each ships, suggest `/verify`, then `/review` (requires `switch_mode` back to system-architect), then `/commit-and-document`. Do not auto-launch.
20
+ - Tweaker: For each issue, execute the `/zoo-tdd` command workflow (per `.roo/rules/01-command-protocol.md`). After each ships, suggest `/zoo-verify`, then `/zoo-review` (requires `switch_mode` back to system-architect), then `/zoo-commit-and-document`. Do not auto-launch.
21
21
 
22
22
  $ARGUMENTS
@@ -14,7 +14,7 @@ EXECUTION RULES:
14
14
  - Architect MUST `switch_mode` -> `code-tweaker`.
15
15
  - Tweaker executes phase 5 (Fix + test).
16
16
  - Tweaker MUST `switch_mode` -> `system-architect`.
17
- 4. POST-MORTEM (Architect): Execute Phase 6. If architectural rot, suggest `/refactor`.
18
- 5. FOLLOW-UP (Architect): Suggest `/verify`, then `/review`, then `/commit-and-document`. Do not auto-launch. Call `attempt_completion` with diagnosis summary, fix applied, post-mortem findings, and recommended next command.
17
+ 4. POST-MORTEM (Architect): Execute Phase 6. If architectural rot, suggest `/zoo-refactor`.
18
+ 5. FOLLOW-UP (Architect): Suggest `/zoo-verify`, then `/zoo-review`, then `/zoo-commit-and-document`. Do not auto-launch. Call `attempt_completion` with diagnosis summary, fix applied, post-mortem findings, and recommended next command.
19
19
 
20
20
  $ARGUMENTS
@@ -13,8 +13,8 @@ EXECUTION RULES:
13
13
  3. EXECUTE (Tweaker):
14
14
  - Architect summarizes approved plan.
15
15
  - Architect MUST `switch_mode` -> `code-tweaker`.
16
- - Tweaker executes the `/tdd` command workflow (per `.roo/rules/01-command-protocol.md`) — new tests at interface, delete old.
17
- - Tweaker suggests `/verify`, then `/review` (requires `switch_mode` back to system-architect), then `/commit-and-document`. Do not auto-launch.
16
+ - Tweaker executes the `/zoo-tdd` command workflow (per `.roo/rules/01-command-protocol.md`) — new tests at interface, delete old.
17
+ - Tweaker suggests `/zoo-verify`, then `/zoo-review` (requires `switch_mode` back to system-architect), then `/zoo-commit-and-document`. Do not auto-launch.
18
18
  - Tweaker calls `attempt_completion` with: what was refactored, files changed, tests added, status, and recommended next command.
19
19
 
20
20
  $ARGUMENTS
@@ -12,10 +12,10 @@ Find the target doc in `.zoo-flow/` or `docs/`. If it does not exist, ask once:
12
12
 
13
13
  Do NOT use this for:
14
14
 
15
- - Domain glossary terms — use `/grill-with-docs`
16
- - ADRs — use `/grill-with-docs` or `/refactor`
17
- - Local commit journal entries — use `/commit-and-document`
18
- - Read-only understanding — use `/explore`
15
+ - Domain glossary terms — use `/zoo-grill-with-docs`
16
+ - ADRs — use `/zoo-grill-with-docs` or `/zoo-refactor`
17
+ - Local commit journal entries — use `/zoo-commit-and-document`
18
+ - Read-only understanding — use `/zoo-explore`
19
19
 
20
20
  If `$ARGUMENTS` is empty, ask once: "Which documentation file or area should I update?"
21
21
 
@@ -20,7 +20,7 @@ Safe suggestions:
20
20
 
21
21
  Unsafe suggestions:
22
22
 
23
- - `/tweak`
23
+ - `/zoo-tweak`
24
24
  - `Switch to code-tweaker`
25
25
  - `Route to system-architect`
26
26
  - `Fix it → code`
@@ -21,7 +21,7 @@ Read domain docs only when at least one is true:
21
21
  - The task touches domain language or terminology.
22
22
  - The task changes public behavior.
23
23
  - The task changes architecture, module seams, persistence, API shape, auth, payments, security, migrations, or cross-module design.
24
- - The command explicitly requires those docs (e.g. `/feature`, `/refactor`, `/grill-with-docs`, `/scaffold-context`, `/update-docs`, `/tdd`).
24
+ - The command explicitly requires those docs (e.g. `/zoo-feature`, `/zoo-refactor`, `/zoo-grill-with-docs`, `/zoo-scaffold-context`, `/zoo-update-docs`, `/zoo-tdd`).
25
25
  - The user asks for documentation, architecture, product, or domain-context work.
26
26
 
27
27
  Missing CONTEXT.md or ADRs is not an error. Proceed silently when nothing is present.
@@ -16,7 +16,7 @@ Before any `attempt_completion`, re-read the command body and confirm no later p
16
16
  `attempt_completion` is a tool call with a `result` parameter. You MUST call it as a tool, not as plain text. Example:
17
17
 
18
18
  ```
19
- attempt_completion(result="Done. Changed X in file Y. Status: complete. Next: /verify")
19
+ attempt_completion(result="Done. Changed X in file Y. Status: complete. Next: /zoo-verify")
20
20
  ```
21
21
 
22
22
  Do NOT:
@@ -38,6 +38,6 @@ Write long output (verification report, diff summary) to `.scratch/` with a desc
38
38
 
39
39
  Before running `git commit` or `git push`, halt and wait for explicit user approval. Never push unless explicitly asked.
40
40
 
41
- For non-trivial `/tdd`, `/fix`, `/feature`, `/refactor`, or R3+ `/tweak` work, recommend `/verify` before `/review` before `/commit-and-document`. Do not auto-launch those commands.
41
+ For non-trivial `/zoo-tdd`, `/zoo-fix`, `/zoo-feature`, `/zoo-refactor`, or R3+ `/zoo-tweak` work, recommend `/zoo-verify` before `/zoo-review` before `/zoo-commit-and-document`. Do not auto-launch those commands.
42
42
 
43
- If the user explicitly says to remember a project rule, or the same mistake has repeated, ask before appending a short lesson to `.zoo-flow/LESSONS.md`. Do not read or write lessons by default.
43
+ If the user explicitly says to remember a project rule, or the same mistake has repeated, ask before appending a short lesson to `.zoo-flow/LESSONS.md`. Do not read or write lessons by default.
@@ -30,7 +30,7 @@ If neither custom mode is suitable, stop and report that no valid Zoo Flow mode
30
30
 
31
31
  ## Slash command handling
32
32
 
33
- When the user types a slash command (e.g. `/tweak`, `/explore`), the extension reads the `mode:` frontmatter from the command file and auto-switches to that mode. The orchestrator does not route slash commands — the extension handles it.
33
+ When the user types a slash command (e.g. `/zoo-tweak`, `/zoo-explore`), the extension reads the `mode:` frontmatter from the command file and auto-switches to that mode. The orchestrator does not route slash commands — the extension handles it.
34
34
 
35
35
  The orchestrator only routes **free-form requests** (natural language without a leading `/`).
36
36
 
@@ -50,17 +50,17 @@ Use the least-interruptive policy that is safe.
50
50
 
51
51
  Defaults:
52
52
 
53
- - `/tweak`: proceed automatically after audit if clean
54
- - `/tdd`: proceed automatically after audit if clean, unless the public interface, expected behavior, or test target is unclear
55
- - `/explore`: proceed automatically; ask only if the target area is ambiguous
56
- - `/update-docs`: proceed automatically after audit if the target doc/area is clear; ask if unclear
57
- - `/prototype`: proceed automatically if prototype branch is clear; ask if logic vs UI is ambiguous
58
- - `/verify`: proceed automatically after changed scope and project checks are identified; report exact commands run
59
- - `/review`: stop and report only; do not patch application source
60
- - `/fix`: ask after reproduced hypotheses before instrumentation/fix
61
- - `/feature`: ask at phase gates: Prototype/PRD, prototype verdict, slice approval, issue approval
62
- - `/refactor`: ask before selecting a candidate and before implementation
63
- - `/triage`: ask before publishing, closing, labeling, or making irreversible tracker changes unless the user explicitly requested it
64
- - `/commit-and-document`: always ask before `git commit`, `git push`, or issue close actions
65
-
66
- Do not auto-launch `/verify`, `/review`, or `/commit-and-document` merely because a worker recommended it. Suggest only; wait for explicit approval.
53
+ - `/zoo-tweak`: proceed automatically after audit if clean
54
+ - `/zoo-tdd`: proceed automatically after audit if clean, unless the public interface, expected behavior, or test target is unclear
55
+ - `/zoo-explore`: proceed automatically; ask only if the target area is ambiguous
56
+ - `/zoo-update-docs`: proceed automatically after audit if the target doc/area is clear; ask if unclear
57
+ - `/zoo-prototype`: proceed automatically if prototype branch is clear; ask if logic vs UI is ambiguous
58
+ - `/zoo-verify`: proceed automatically after changed scope and project checks are identified; report exact commands run
59
+ - `/zoo-review`: stop and report only; do not patch application source
60
+ - `/zoo-fix`: ask after reproduced hypotheses before instrumentation/fix
61
+ - `/zoo-feature`: ask at phase gates: Prototype/PRD, prototype verdict, slice approval, issue approval
62
+ - `/zoo-refactor`: ask before selecting a candidate and before implementation
63
+ - `/zoo-triage`: ask before publishing, closing, labeling, or making irreversible tracker changes unless the user explicitly requested it
64
+ - `/zoo-commit-and-document`: always ask before `git commit`, `git push`, or issue close actions
65
+
66
+ Do not auto-launch `/zoo-verify`, `/zoo-review`, or `/zoo-commit-and-document` merely because a worker recommended it. Suggest only; wait for explicit approval.
@@ -1,10 +1,10 @@
1
1
  # Feature Prototype Handoff
2
2
 
3
- During `/feature`, do not run prototype implementation directly.
3
+ During `/zoo-feature`, do not run prototype implementation directly.
4
4
 
5
5
  If the user chooses Prototype:
6
6
 
7
7
  1. Summarize the prototype question and constraints.
8
8
  2. Use `switch_mode` to `code-tweaker`.
9
- 3. Have `code-tweaker` execute `/prototype`.
9
+ 3. Have `code-tweaker` execute `/zoo-prototype`.
10
10
  4. Resume architecture flow after the prototype result returns.
@@ -14,7 +14,7 @@ NEVER call `switch_mode` to the built-in `code`, `Code`, `ask`, `Ask`, `debug`,
14
14
 
15
15
  - **More phases remain** (this or a later phase is assigned to `code-tweaker`, or control returns to you afterward): use `switch_mode` to `code-tweaker` (exact slug, never `code`). Never `attempt_completion` mid-chain. Writing a plan, diagnosis, or `.scratch/` notes is not "done" — it is a handoff. Switch to `code-tweaker` to implement.
16
16
  - **You are running the command's final phase** and it is complete or blocked: use `attempt_completion` to return to the orchestrator.
17
- - **Standalone command with no implementation phase** (e.g. `/review`, `/explore`, `/grill-with-docs`, `/triage`): use `attempt_completion` with the recommended next command.
17
+ - **Standalone command with no implementation phase** (e.g. `/zoo-review`, `/zoo-explore`, `/zoo-grill-with-docs`, `/zoo-triage`): use `attempt_completion` with the recommended next command.
18
18
 
19
19
  If you entered this window via `switch_mode` (you are mid-chain, not the entry point) and any phase remains, you hand back with `switch_mode`. Only the command's final phase returns to the orchestrator.
20
20
 
@@ -25,7 +25,7 @@ Before any `attempt_completion`, re-read the command body and confirm no later p
25
25
  `attempt_completion` is a tool call with a `result` parameter. You MUST call it as a tool, not as plain text. Example:
26
26
 
27
27
  ```
28
- attempt_completion(result="Done. Explored X. Status: complete. Next: /feature")
28
+ attempt_completion(result="Done. Explored X. Status: complete. Next: /zoo-feature")
29
29
  ```
30
30
 
31
31
  Do NOT:
@@ -40,6 +40,6 @@ Do not use `attempt_completion` to avoid required implementation work. Write the
40
40
 
41
41
  Halt for explicit user approval before testing a bug hypothesis, finalizing an architecture plan, publishing issues, or making irreversible decisions.
42
42
 
43
- For non-trivial completed plans or reviews, recommend the next command only. Typical chain: implementation command -> `/verify` -> `/review` -> `/commit-and-document`. Do not auto-launch those commands.
43
+ For non-trivial completed plans or reviews, recommend the next command only. Typical chain: implementation command -> `/zoo-verify` -> `/zoo-review` -> `/zoo-commit-and-document`. Do not auto-launch those commands.
44
44
 
45
45
  If the user explicitly says to remember a project rule, or the same mistake has repeated, ask before appending a short lesson to `.zoo-flow/LESSONS.md`. Do not read or write lessons by default.
@@ -1,13 +1,13 @@
1
1
  # ADR-0001: Explicit setup pointer only for hard dependencies
2
2
 
3
- RULE: explicit `/setup-matt-pocock-skills` pointer only for hard deps.
3
+ RULE: explicit `/zoo-setup-matt-pocock-skills` pointer only for hard deps.
4
4
 
5
5
  MUST include pointer:
6
6
  - `to-issues`
7
7
  - `to-prd`
8
8
  - `triage`
9
9
 
10
- Required wording: mapping/config should exist; run `/setup-matt-pocock-skills` if missing.
10
+ Required wording: mapping/config should exist; run `/zoo-setup-matt-pocock-skills` if missing.
11
11
 
12
12
  MUST NOT include pointer:
13
13
  - `diagnose`
@@ -11,4 +11,4 @@
11
11
  - **[zoom-out](./zoom-out/SKILL.md)** — Map modules/callers.
12
12
  - **[prototype](./prototype/SKILL.md)** — Throwaway logic/UI prototype.
13
13
  - **[review](./review/SKILL.md)** — Diff/branch review against spec and standards.
14
- - **[verify](./verify/SKILL.md)** — Targeted tests/typecheck/lint/build evidence.
14
+ - **[verify](./verify/SKILL.md)** — Targeted tests/typecheck/lint/build evidence.
@@ -32,4 +32,4 @@ _Avoid_: Purchase, transaction
32
32
  ## Discovery rule
33
33
 
34
34
  1. If the file exists, read it.
35
- 2. If the file is missing, that is **not an error**. Do not invent content. Surface once: "No CONTEXT.md found. Run /scaffold-context to fill, or continue without."
35
+ 2. If the file is missing, that is **not an error**. Do not invent content. Surface once: "No CONTEXT.md found. Run /zoo-scaffold-context to fill, or continue without."
@@ -13,5 +13,5 @@ This pack adds structured writing workflows:
13
13
  - **Beats** — narrative/argument sequencing patterns
14
14
  - **Fragments** — reusable content components
15
15
 
16
- None of these are activated by default. Run `/scaffold-context` and
16
+ None of these are activated by default. Run `/zoo-scaffold-context` and
17
17
  select "writing-patterns" to install.
@@ -16,5 +16,5 @@ See `.roo/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md` for layout and d
16
16
 
17
17
  - Use glossary vocabulary in outputs/tests/issues/hypotheses.
18
18
  - Avoid `_Avoid_` synonyms.
19
- - If term missing, reconsider wording or note `/grill-with-docs` gap.
19
+ - If term missing, reconsider wording or note `/zoo-grill-with-docs` gap.
20
20
  - If output contradicts ADR, surface conflict.
@@ -1,5 +1,5 @@
1
1
  # Context
2
- <!-- Domain language, terms, and ambiguities for this project. Run /grill-with-docs to fill. -->
2
+ <!-- Domain language, terms, and ambiguities for this project. Run /zoo-grill-with-docs to fill. -->
3
3
 
4
4
  ## Language
5
5
  <!-- Term: 1-2 sentence definition. _Avoid_: aliases. -->
@@ -4,5 +4,5 @@
4
4
 
5
5
  1. Reload VS Code and open Zoo Code.
6
6
  2. Switch to **Custom Orchestrator** mode.
7
- 3. Run `/scaffold-context` for an existing project, or `/setup-matt-pocock-skills` if using PRDs, issue slicing, or triage.
7
+ 3. Run `/zoo-scaffold-context` for an existing project, or `/zoo-setup-matt-pocock-skills` if using PRDs, issue slicing, or triage.
8
8
  4. Then describe tasks normally.
@@ -20,9 +20,9 @@ Before accepting workflow changes, verify:
20
20
  - [ ] README links to `.zoo-flow/START_HERE.md`.
21
21
  - [ ] README does not duplicate the full Zoo Flow onboarding guide.
22
22
  - [ ] `.zoo-flow/START_HERE.md` remains the source of truth for first-run initialization.
23
- - [ ] First-run guidance explains `/scaffold-context` and `/setup-matt-pocock-skills`.
23
+ - [ ] First-run guidance explains `/zoo-scaffold-context` and `/zoo-setup-matt-pocock-skills`.
24
24
  - [ ] Custom Orchestrator never delegates to built-in/default Ask mode.
25
- - [ ] Analysis, review, inspection, and safety-check subtasks route to `system-architect`.
26
- - [ ] Implementation, tests, docs, prototype, and commit subtasks route to `code-tweaker`.
27
- - [ ] Verification requests route to `code-tweaker`.
28
- - [ ] Non-trivial work suggests `/verify` and `/review` before `/commit-and-document` but does not auto-launch them.
25
+ - [ ] Analysis, review, inspection, and safety-check subtasks route to `system-architect`.
26
+ - [ ] Implementation, tests, docs, prototype, and commit subtasks route to `code-tweaker`.
27
+ - [ ] Verification requests route to `code-tweaker`.
28
+ - [ ] Non-trivial work suggests `/zoo-verify` and `/zoo-review` before `/zoo-commit-and-document` but does not auto-launch them.
@@ -67,7 +67,7 @@ Expected:
67
67
  Recommend exploration first.
68
68
 
69
69
  Must:
70
- - Produce a map before choosing feature/fix/refactor.
70
+ - Produce a map before choosing zoo-feature/zoo-fix/zoo-refactor.
71
71
 
72
72
  ## Case 6 — Known mechanical fix
73
73
 
@@ -142,7 +142,7 @@ Must:
142
142
  ## Case 12 — Explicit slash command
143
143
 
144
144
  User:
145
- "/tweak rename the cancel button to close."
145
+ "/zoo-tweak rename the cancel button to close."
146
146
 
147
147
  Expected:
148
148
  Route immediately. Do not second-guess the explicit command.
@@ -178,12 +178,12 @@ Good response:
178
178
  2. Explore the area first"
179
179
 
180
180
  Must not:
181
- - Say "use `/tweak`" in the user-facing recommendation.
182
- - Offer `/tweak` as a selectable option.
181
+ - Say "use `/zoo-tweak`" in the user-facing recommendation.
182
+ - Offer `/zoo-tweak` as a selectable option.
183
183
  - Tell the user to type a slash command.
184
184
 
185
185
  Allowed:
186
- - Internally delegate using `/tweak` after the user approves.
186
+ - Internally delegate using `/zoo-tweak` after the user approves.
187
187
  - Mention slash commands only if the user explicitly asks for command syntax.
188
188
 
189
189
  ## Case — Deep inspection must not route to Ask mode
@@ -198,30 +198,30 @@ Delegation target after approval:
198
198
  `system-architect`
199
199
 
200
200
  Must not:
201
- - Delegate to Ask mode.
202
- - Delegate to default Architect mode.
203
- - Use any mode other than `system-architect` or `code-tweaker`.
204
-
205
- ## Case — Review
206
-
207
- User:
208
- "Review this branch before I commit it."
209
-
210
- Expected:
211
- Recommend the review workflow.
212
-
213
- Must:
214
- - Route to `system-architect` after approval.
215
- - Report findings by severity.
216
-
217
- ## Case — Verification
218
-
219
- User:
220
- "Run tests for this change and make sure nothing broke."
221
-
222
- Expected:
223
- Recommend the verification workflow.
224
-
225
- Must:
226
- - Route to `code-tweaker` after approval.
227
- - Report exact commands run and results.
201
+ - Delegate to Ask mode.
202
+ - Delegate to default Architect mode.
203
+ - Use any mode other than `system-architect` or `code-tweaker`.
204
+
205
+ ## Case — Review
206
+
207
+ User:
208
+ "Review this branch before I commit it."
209
+
210
+ Expected:
211
+ Recommend the review workflow.
212
+
213
+ Must:
214
+ - Route to `system-architect` after approval.
215
+ - Report findings by severity.
216
+
217
+ ## Case — Verification
218
+
219
+ User:
220
+ "Run tests for this change and make sure nothing broke."
221
+
222
+ Expected:
223
+ Recommend the verification workflow.
224
+
225
+ Must:
226
+ - Route to `code-tweaker` after approval.
227
+ - Report exact commands run and results.
@@ -1 +1 @@
1
- {"expect":"fail","mutation":"helper-not-permitted","message":"does not permit documented command /diagnose"}
1
+ {"expect":"fail","mutation":"helper-not-permitted","message":"does not permit documented command /zoo-diagnose"}