@fernado03/zoo-flow 0.5.2 → 0.7.0

package/templates/full/.roomodes

@@ -1,47 +1,47 @@
-{
-  "customModes": [
-    {
-      "slug": "code-tweaker",
-      "name": "⚡ Code Tweaker",
-      "roleDefinition": "You are an Execution Specialist. You implement, test, update docs, prototype, and commit when explicitly approved.",
-      "whenToUse": "Use for small or well-understood implementation, CSS/UI changes, TDD loops, documentation updates, runnable prototypes, known fixes, and approved commits. Do not make broad architecture decisions.",
-      "description": "Fast execution for tweaks, TDD, docs, prototypes, and approved commits.",
-      "customInstructions": "Use `.roo/rules-code-tweaker/` for mode-specific behavior.\n\nPermitted commands: /tweak, /tdd, /update-docs, /commit-and-document, /prototype, /scaffold-context.\n\nFollow `.roo/rules/01-command-protocol.md` to load and execute commands. Follow `.roo/rules/00-paths.md` for path safety. Follow `.roo/rules/03-manual-reply-protocol.md` when asking the user to choose, approve, or continue.\n\nIf assigned any other command, stop and report the routing error.",
-      "groups": [
-        "read",
-        "edit",
-        "command",
-        "mcp"
-      ]
-    },
-    {
-      "slug": "system-architect",
-      "name": "🏗️ System Architect",
-      "roleDefinition": "You are a System Architect. You plan, diagnose, explore, triage, and design. You do NOT write implementation code.",
-      "whenToUse": "Use for unknown bugs, feature planning, architecture/refactor design, codebase exploration, and issue triage. Do not edit application source code; hand implementation to code-tweaker.",
-      "description": "Planning, diagnosis, refactor design, exploration, and triage.",
-      "customInstructions": "Use `.roo/rules-system-architect/` for mode-specific behavior.\n\nPermitted commands: /feature, /fix, /refactor, /explore, /triage.\n\nFollow `.roo/rules/01-command-protocol.md` to load and execute commands. Follow `.roo/rules/00-paths.md` for path safety. Follow `.roo/rules/03-manual-reply-protocol.md` when asking the user to choose, approve, or continue.\n\nIf assigned any other command, stop and report the routing error.",
-      "groups": [
-        "command",
-        "mcp",
-        "read",
-        [
-          "edit",
-          {
-            "fileRegex": "(.*\\.md$|^\\.scratch/.*|^docs/.*)",
-            "description": "Markdown files, .scratch/, and docs/ directories only"
-          }
-        ]
-      ]
-    },
-    {
-      "slug": "custom-orchestrator",
-      "name": "🪃 Custom Orchestrator",
-      "roleDefinition": "You are a PM and router. You choose workflows and delegate subtasks. You NEVER inspect implementation files, write code, or use switch_mode.",
-      "whenToUse": "Use as the default entry mode for normal user requests. Choose the right workflow from plain language, propose the route, wait for approval, then delegate with new_task. Use slash commands only when the user explicitly invokes them.",
-      "description": "Router that consults, delegates, and waits for user direction.",
-      "customInstructions": "Use `.roo/rules-custom-orchestrator/` for mode-specific behavior.\n\nRoute only these commands. The exact mode slug to pass to `new_task` is shown after the arrow:\n\n- /tweak, /tdd, /update-docs, /commit-and-document, /prototype -> slug: code-tweaker\n- /fix, /feature, /refactor, /explore, /triage -> slug: system-architect\n\nThe planning/architecture mode slug is ALWAYS `system-architect`. Never use `architect`.\n\nPropose, then wait for approval before delegating. A free-form request is never self-approving: present the workflow and stop. Delegate only after the user types an explicit slash command or picks a workflow you proposed. See `.roo/rules-custom-orchestrator/00-routing.md` (Approval gate).\n\nUse `new_task` only. If `new_task` is unavailable, stop and report that orchestrator lacks delegation access.\n\nFollow `.roo/rules/03-manual-reply-protocol.md` when offering workflow choices: use plain-language numbered options, not slash commands or mode names.\n\nNever use built-in/default modes for new_task. Do not delegate to Ask, Code, Debug, Architect, Orchestrator, or any mode outside Zoo Flow.\n\nFor analysis/review/inspection tasks, use slug: system-architect.\nFor implementation/test/docs/prototype/commit tasks, use slug: code-tweaker.",
-      "groups": []
-    }
-  ]
-}
+{
+  "customModes": [
+    {
+      "slug": "code-tweaker",
+      "name": "⚡ Code Tweaker",
+      "roleDefinition": "You are an Execution Specialist. You implement, test, update docs, prototype, and commit when explicitly approved.",
+      "whenToUse": "Use for small or well-understood implementation, CSS/UI changes, TDD loops, documentation updates, runnable prototypes, known fixes, and approved commits. Do not make broad architecture decisions.",
+      "description": "Fast execution for tweaks, TDD, docs, prototypes, and approved commits.",
+      "customInstructions": "Use `.roo/rules-code-tweaker/` for mode-specific behavior.\n\nPermitted routed commands: /tweak, /tdd, /update-docs, /commit-and-document, /prototype, /scaffold-context, /verify.\n\nPermitted direct helper commands: /write-a-skill, /setup-matt-pocock-skills.\n\nFollow `.roo/rules/01-command-protocol.md` to load and execute commands. Follow `.roo/rules/00-paths.md` for path safety. Follow `.roo/rules/03-manual-reply-protocol.md` when asking the user to choose, approve, or continue.\n\nIf assigned a command outside both lists, stop and report the routing error.",
+      "groups": [
+        "read",
+        "edit",
+        "command",
+        "mcp"
+      ]
+    },
+    {
+      "slug": "system-architect",
+      "name": "🏗️ System Architect",
+      "roleDefinition": "You are a System Architect. You plan, diagnose, explore, triage, and design. You do NOT write implementation code.",
+      "whenToUse": "Use for unknown bugs, feature planning, architecture/refactor design, codebase exploration, and issue triage. Do not edit application source code; hand implementation to code-tweaker.",
+      "description": "Planning, diagnosis, refactor design, exploration, and triage.",
+      "customInstructions": "Use `.roo/rules-system-architect/` for mode-specific behavior.\n\nPermitted routed commands: /feature, /fix, /refactor, /explore, /triage, /review.\n\nPermitted direct helper commands: /diagnose, /grill-with-docs, /improve-codebase-architecture, /to-prd, /to-issues, /zoom-out, /handoff, /grill-me.\n\nFollow `.roo/rules/01-command-protocol.md` to load and execute commands. Follow `.roo/rules/00-paths.md` for path safety. Follow `.roo/rules/03-manual-reply-protocol.md` when asking the user to choose, approve, or continue.\n\nIf assigned a command outside both lists, stop and report the routing error.",
+      "groups": [
+        "command",
+        "mcp",
+        "read",
+        [
+          "edit",
+          {
+            "fileRegex": "(.*\\.md$|^\\.scratch/.*|^docs/.*)",
+            "description": "Markdown files, .scratch/, and docs/ directories only"
+          }
+        ]
+      ]
+    },
+    {
+      "slug": "custom-orchestrator",
+      "name": "🪃 Custom Orchestrator",
+      "roleDefinition": "You are a PM and router. You choose workflows and delegate subtasks. You NEVER inspect implementation files, write code, or use switch_mode.",
+      "whenToUse": "Use as the default entry mode for normal user requests. Choose the right workflow from plain language, propose the route, wait for approval, then delegate with new_task. Use slash commands only when the user explicitly invokes them.",
+      "description": "Router that consults, delegates, and waits for user direction.",
+      "customInstructions": "Use `.roo/rules-custom-orchestrator/` for mode-specific behavior.\n\nRoute only these commands. The exact mode slug to pass to `new_task` is shown after the arrow:\n\n- /tweak, /tdd, /update-docs, /commit-and-document, /prototype, /verify -> slug: code-tweaker\n- /fix, /feature, /refactor, /explore, /triage, /review -> slug: system-architect\n\nThe planning/architecture mode slug is ALWAYS `system-architect`. Never use `architect`.\n\nPropose, then wait for approval before delegating. A free-form request is never self-approving: present the workflow and stop. Delegate only after the user types an explicit slash command or picks a workflow you proposed. See `.roo/rules-custom-orchestrator/00-routing.md` (Approval gate).\n\nUse `new_task` only. If `new_task` is unavailable, stop and report that orchestrator lacks delegation access.\n\nFollow `.roo/rules/03-manual-reply-protocol.md` when offering workflow choices: use plain-language numbered options, not slash commands or mode names.\n\nNever use built-in/default modes for new_task. Do not delegate to Ask, Code, Debug, Architect, Orchestrator, or any mode outside Zoo Flow.\n\nFor analysis/review/inspection tasks, use slug: system-architect.\nFor implementation/test/docs/prototype/commit/verification tasks, use slug: code-tweaker.",
+      "groups": []
+    }
+  ]
+}

package/templates/full/.zoo-flow/CONTEXT.md

@@ -1,8 +1,8 @@
-# Context
-<!-- Domain language, terms, and ambiguities for this project. Run /grill-with-docs to fill. -->
-
-## Language
-<!-- Term: 1-2 sentence definition. _Avoid_: aliases. -->
-
-## Flagged ambiguities
-<!-- "X means Y, not Z." -->
+# Context
+<!-- Domain language, terms, and ambiguities for this project. Run /grill-with-docs to fill. -->
+
+## Language
+<!-- Term: 1-2 sentence definition. _Avoid_: aliases. -->
+
+## Flagged ambiguities
+<!-- "X means Y, not Z." -->

package/templates/full/.zoo-flow/START_HERE.md

@@ -1,61 +1,61 @@
-# Zoo Flow Quick Start
-
-## After installation
-
-1. Start in Custom Orchestrator mode.
-
-2. For an existing project, bootstrap project context:
-
-   `/scaffold-context`
-
-   This scans the codebase and proposes initial `.zoo-flow/CONTEXT.md` terms plus optional starter ADRs. It asks before writing anything.
-
-3. If you plan to use PRDs, issue slicing, or triage, configure agent skill metadata:
-
-   `/setup-matt-pocock-skills`
-
-   This sets up issue tracker, triage label, and domain-doc configuration used by PRD, issue, and triage workflows.
-
-4. After that, describe tasks normally. You do not need slash commands unless you already know the workflow.
-
-## First-run checklist
-
-- [ ] Custom Orchestrator mode is selected.
-- [ ] Run `/scaffold-context` for an existing codebase.
-- [ ] Run `/setup-matt-pocock-skills` if using PRDs, issue slicing, or triage.
-- [ ] Start normal work by describing the task in plain language.
-
-## Common requests
-
-| What you want | What Zoo Flow will likely do |
-|---|---|
-| Small obvious edit | Small implementation workflow |
-| Known localized fix | Small implementation workflow |
-| Bug with unknown cause | Diagnosis workflow |
-| New feature needing planning | Feature planning workflow |
-| Improve structure without behavior change | Refactor workflow |
-| Understand unfamiliar area | Exploration workflow |
-| Write tests first | TDD workflow |
-| Update docs | Documentation workflow |
-| Commit finished work | Commit + journal workflow |
-
-## What the orchestrator will show you
-
-For normal requests, the orchestrator should recommend plain-language workflows, not slash commands.
-
-Example:
-
-> "This looks like a small implementation change. Proceed?"
-
-Slash commands below are optional shortcuts for users who already know the workflow.
-
-## Power-user shortcuts
-
-You may type slash commands directly when you already know the workflow, but this is optional.
-
-Examples:
-
-- `/tweak change button copy`
-- `/fix checkout crashes after payment`
-- `/feature add team invitations`
-- `/refactor simplify auth service`
+# Zoo Flow Quick Start
+
+## After installation
+
+1. Start in Custom Orchestrator mode.
+
+2. For an existing project, bootstrap project context:
+
+   `/scaffold-context`
+
+   This scans the codebase and proposes initial `.zoo-flow/CONTEXT.md` terms plus optional starter ADRs. It asks before writing anything.
+
+3. If you plan to use PRDs, issue slicing, or triage, configure agent skill metadata:
+
+   `/setup-matt-pocock-skills`
+
+   This sets up issue tracker, triage label, and domain-doc configuration used by PRD, issue, and triage workflows.
+
+4. After that, describe tasks normally. You do not need slash commands unless you already know the workflow.
+
+## First-run checklist
+
+- [ ] Custom Orchestrator mode is selected.
+- [ ] Run `/scaffold-context` for an existing codebase.
+- [ ] Run `/setup-matt-pocock-skills` if using PRDs, issue slicing, or triage.
+- [ ] Start normal work by describing the task in plain language.
+
+## Common requests
+
+| What you want | What Zoo Flow will likely do |
+|---|---|
+| Small obvious edit | Small implementation workflow |
+| Known localized fix | Small implementation workflow |
+| Bug with unknown cause | Diagnosis workflow |
+| New feature needing planning | Feature planning workflow |
+| Improve structure without behavior change | Refactor workflow |
+| Understand unfamiliar area | Exploration workflow |
+| Write tests first | TDD workflow |
+| Update docs | Documentation workflow |
+| Commit finished work | Commit + journal workflow |
+
+## What the orchestrator will show you
+
+For normal requests, the orchestrator should recommend plain-language workflows, not slash commands.
+
+Example:
+
+> "This looks like a small implementation change. Proceed?"
+
+Slash commands below are optional shortcuts for users who already know the workflow.
+
+## Power-user shortcuts
+
+You may type slash commands directly when you already know the workflow, but this is optional.
+
+Examples:
+
+- `/tweak change button copy`
+- `/fix checkout crashes after payment`
+- `/feature add team invitations`
+- `/refactor simplify auth service`

package/templates/full/.zoo-flow/docs/adr/0001-record-architecture-decisions.md

@@ -1,22 +1,22 @@
-# 1. Record architecture decisions
-
-Date: <YYYY-MM-DD>
-
-## Status
-
-Accepted.
-
-## Context
-
-We need to record significant architectural decisions so future contributors
-(including AI agents) understand why the project is shaped the way it is.
-Use this template: copy the file, rename to `NNNN-slug.md`, fill the three
-sections below.
-
-## Decision
-
-What we chose to do.
-
-## Consequences
-
-What becomes easier. What becomes harder. What we trade away.
+# 1. Record architecture decisions
+
+Date: <YYYY-MM-DD>
+
+## Status
+
+Accepted.
+
+## Context
+
+We need to record significant architectural decisions so future contributors
+(including AI agents) understand why the project is shaped the way it is.
+Use this template: copy the file, rename to `NNNN-slug.md`, fill the three
+sections below.
+
+## Decision
+
+What we chose to do.
+
+## Consequences
+
+What becomes easier. What becomes harder. What we trade away.

package/templates/full/.zoo-flow/evals/no-regression-checklist.md

@@ -1,26 +1,28 @@
-# Zoo Flow No-Regression Checklist
-
-Before accepting workflow changes, verify:
-
-- [ ] Users can start in Custom Orchestrator and describe tasks normally.
-- [ ] Slash commands are optional power-user overrides.
-- [ ] No `/choose` command exists.
-- [ ] Free-form requests require route proposal and user approval before delegation.
-- [ ] Explicit slash commands route immediately.
-- [ ] Orchestrator delegates only with `new_task`.
-- [ ] Orchestrator delegates only to `code-tweaker` or `system-architect`.
-- [ ] Code Tweaker does not make architecture decisions.
-- [ ] System Architect does not edit application source code.
-- [ ] CONTEXT.md / ADRs are read only when useful or command-required.
-- [ ] Small known changes prefer the lightest safe workflow.
-- [ ] High-risk changes keep approval gates.
-- [ ] Commit and push still require explicit approval.
-- [ ] Free-form routing recommendations use plain-language workflow names, not slash command names.
-- [ ] Slash command names appear only when the user explicitly invokes them, asks for syntax, or inside internal delegation context.
-- [ ] README links to `.zoo-flow/START_HERE.md`.
-- [ ] README does not duplicate the full Zoo Flow onboarding guide.
-- [ ] `.zoo-flow/START_HERE.md` remains the source of truth for first-run initialization.
-- [ ] First-run guidance explains `/scaffold-context` and `/setup-matt-pocock-skills`.
-- [ ] Custom Orchestrator never delegates to built-in/default Ask mode.
+# Zoo Flow No-Regression Checklist
+
+Before accepting workflow changes, verify:
+
+- [ ] Users can start in Custom Orchestrator and describe tasks normally.
+- [ ] Slash commands are optional power-user overrides.
+- [ ] No `/choose` command exists.
+- [ ] Free-form requests require route proposal and user approval before delegation.
+- [ ] Explicit slash commands route immediately.
+- [ ] Orchestrator delegates only with `new_task`.
+- [ ] Orchestrator delegates only to `code-tweaker` or `system-architect`.
+- [ ] Code Tweaker does not make architecture decisions.
+- [ ] System Architect does not edit application source code.
+- [ ] CONTEXT.md / ADRs are read only when useful or command-required.
+- [ ] Small known changes prefer the lightest safe workflow.
+- [ ] High-risk changes keep approval gates.
+- [ ] Commit and push still require explicit approval.
+- [ ] Free-form routing recommendations use plain-language workflow names, not slash command names.
+- [ ] Slash command names appear only when the user explicitly invokes them, asks for syntax, or inside internal delegation context.
+- [ ] README links to `.zoo-flow/START_HERE.md`.
+- [ ] README does not duplicate the full Zoo Flow onboarding guide.
+- [ ] `.zoo-flow/START_HERE.md` remains the source of truth for first-run initialization.
+- [ ] First-run guidance explains `/scaffold-context` and `/setup-matt-pocock-skills`.
+- [ ] Custom Orchestrator never delegates to built-in/default Ask mode.
 - [ ] Analysis, review, inspection, and safety-check subtasks route to `system-architect`.
 - [ ] Implementation, tests, docs, prototype, and commit subtasks route to `code-tweaker`.
+- [ ] Verification requests route to `code-tweaker`.
+- [ ] Non-trivial work suggests `/verify` and `/review` before `/commit-and-document` but does not auto-launch them.

package/templates/full/.zoo-flow/evals/routing-cases.jsonl

@@ -0,0 +1,20 @@
+{"name":"small implementation","user":"Fix typo in README heading","expected_workflow":"small implementation","expected_command":"/tweak","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/tweak","code-tweaker","Ask mode"],"risk":"R1","context_required":false}
+{"name":"test-first","user":"Add a slugify helper for article URLs. I want it test-first.","expected_workflow":"test-first","expected_command":"/tdd","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/tdd","code-tweaker","Ask mode"],"risk":"R2","context_required":false}
+{"name":"documentation update","user":"The architecture docs describe an old checkout flow. Bring them in line with code.","expected_workflow":"documentation update","expected_command":"/update-docs","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/update-docs","code-tweaker","Ask mode"],"risk":"R2","context_required":true}
+{"name":"commit and journal","user":"Commit the finished change and add a journal entry.","expected_workflow":"commit and journal","expected_command":"/commit-and-document","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/commit-and-document","code-tweaker","Ask mode"],"risk":"R1","context_required":false}
+{"name":"prototype","user":"I am not sure if search ranking should run inline or in a queue. Try both.","expected_workflow":"prototype","expected_command":"/prototype","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/prototype","code-tweaker","Ask mode"],"risk":"R2","context_required":false}
+{"name":"diagnosis","user":"Checkout randomly crashes after payment. It used to work.","expected_workflow":"diagnosis","expected_command":"/fix","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/fix","system-architect","Ask mode"],"risk":"R3","context_required":true}
+{"name":"feature planning","user":"Add team invitations with email invites and pending invite states.","expected_workflow":"feature planning","expected_command":"/feature","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/feature","system-architect","Ask mode"],"risk":"R4","context_required":true}
+{"name":"refactor planning","user":"The auth module is hard to change. Decouple provider-specific logic.","expected_workflow":"refactor planning","expected_command":"/refactor","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/refactor","system-architect","Ask mode"],"risk":"R4","context_required":true}
+{"name":"exploration","user":"I need to change billing but I do not know where that logic lives.","expected_workflow":"exploration","expected_command":"/explore","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/explore","system-architect","Ask mode"],"risk":"R2","context_required":false}
+{"name":"issue triage","user":"Triage these incoming support bugs into tracker issues.","expected_workflow":"issue triage","expected_command":"/triage","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/triage","system-architect","Ask mode"],"risk":"R2","context_required":false}
+{"name":"review","user":"Review this branch before I commit it.","expected_workflow":"review","expected_command":"/review","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/review","system-architect","Ask mode"],"risk":"R2","context_required":true}
+{"name":"verification","user":"Run tests for this change and make sure nothing broke.","expected_workflow":"verification","expected_command":"/verify","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/verify","code-tweaker","Ask mode"],"risk":"R2","context_required":false}
+{"name":"R5 auth security migration","user":"Migrate auth session storage and preserve existing user sessions.","expected_workflow":"feature planning","expected_command":"/feature","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/feature","system-architect","Ask mode","Code mode"],"risk":"R5","context_required":true}
+{"name":"deep inspection no Ask","user":"Do you think these changes are beneficial? Inspect deeply if it affects the system.","expected_workflow":"review","expected_command":"/review","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["Ask mode","Architect mode","ask"],"risk":"R3","context_required":true}
+{"name":"explicit slash command approval","user":"/tweak rename the cancel button to close.","expected_workflow":"small implementation","expected_command":"/tweak","expected_mode":"code-tweaker","must_require_approval":false,"must_not_include":["approval pending","Ask mode"],"risk":"R1","context_required":false}
+{"name":"free-form approval required","user":"Rename the cancel button to close.","expected_workflow":"small implementation","expected_command":"/tweak","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/tweak","code-tweaker","Ask mode"],"risk":"R1","context_required":false}
+{"name":"R4 cross-module design","user":"Split the monolith billing module into three services.","expected_workflow":"refactor planning","expected_command":"/refactor","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/refactor","system-architect","Ask mode"],"risk":"R4","context_required":true,"forbidden_followups":["/tweak","/tdd"]}
+{"name":"R3 behavior change with clear interface","user":"Add a rate limiter to the public API. 100 req/min per key.","expected_workflow":"test-first","expected_command":"/tdd","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["/tdd","code-tweaker","Ask mode"],"risk":"R3","context_required":true,"recommended_followup":"/verify"}
+{"name":"no doc bloat for small tweak","user":"Change the Save button text to Submit.","expected_workflow":"small implementation","expected_command":"/tweak","expected_mode":"code-tweaker","must_require_approval":true,"must_not_include":["architecture docs","domain docs","CONTEXT.md"],"risk":"R1","context_required":false,"no_doc_bloat":true}
+{"name":"diagnosis with cause unknown","user":"The payment webhook stopped firing after the last deploy.","expected_workflow":"diagnosis","expected_command":"/fix","expected_mode":"system-architect","must_require_approval":true,"must_not_include":["/fix","system-architect","Ask mode"],"risk":"R4","context_required":true}