pi-maestro-flow 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. package/README.md +44 -72
  2. package/agents/cross-role-reviewer.md +1 -1
  3. package/agents/impeccable-agent.md +1 -1
  4. package/agents/ralph-executor.md +1 -1
  5. package/agents/team-worker.md +1 -1
  6. package/agents/workflow-analyzer.md +1 -1
  7. package/agents/workflow-codebase-mapper.md +1 -1
  8. package/agents/workflow-collab-planner.md +1 -1
  9. package/agents/workflow-debugger.md +1 -1
  10. package/agents/workflow-executor.md +1 -1
  11. package/agents/workflow-integration-checker.md +1 -1
  12. package/agents/workflow-nyquist-auditor.md +1 -1
  13. package/agents/workflow-phase-researcher.md +1 -1
  14. package/agents/workflow-planner.md +1 -1
  15. package/agents/workflow-project-researcher.md +1 -1
  16. package/agents/workflow-reviewer.md +1 -1
  17. package/agents/workflow-verifier.md +1 -1
  18. package/package.json +13 -4
  19. package/skills/codify-to-knowhow/SKILL.md +1 -1
  20. package/skills/delegation-check/SKILL.md +1 -1
  21. package/skills/domain-add/SKILL.md +5 -7
  22. package/skills/insight-challenge/SKILL.md +1 -1
  23. package/skills/learn-decompose/SKILL.md +4 -4
  24. package/skills/learn-follow/SKILL.md +5 -5
  25. package/skills/learn-investigate/SKILL.md +5 -5
  26. package/skills/learn-second-opinion/SKILL.md +5 -5
  27. package/skills/maestro/SKILL.md +9 -10
  28. package/skills/maestro-amend/SKILL.md +3 -3
  29. package/skills/maestro-analyze/SKILL.md +10 -13
  30. package/skills/maestro-blueprint/SKILL.md +8 -11
  31. package/skills/maestro-brainstorm/SKILL.md +11 -14
  32. package/skills/maestro-collab/SKILL.md +4 -4
  33. package/skills/maestro-companion/SKILL.md +3 -3
  34. package/skills/maestro-composer/SKILL.md +11 -12
  35. package/skills/maestro-execute/SKILL.md +9 -12
  36. package/skills/maestro-fork/SKILL.md +8 -11
  37. package/skills/maestro-grill/SKILL.md +13 -16
  38. package/skills/maestro-guard/SKILL.md +5 -5
  39. package/skills/maestro-help/SKILL.md +3 -3
  40. package/skills/maestro-impeccable/SKILL.md +7 -7
  41. package/skills/maestro-init/SKILL.md +9 -12
  42. package/skills/maestro-merge/SKILL.md +6 -8
  43. package/skills/maestro-milestone-audit/SKILL.md +3 -5
  44. package/skills/maestro-milestone-complete/SKILL.md +9 -12
  45. package/skills/maestro-milestone-release/SKILL.md +9 -11
  46. package/skills/maestro-next/SKILL.md +5 -5
  47. package/skills/maestro-overlay/SKILL.md +16 -16
  48. package/skills/maestro-plan/SKILL.md +9 -12
  49. package/skills/maestro-player/SKILL.md +5 -5
  50. package/skills/maestro-quick/SKILL.md +5 -7
  51. package/skills/maestro-ralph/SKILL.md +16 -17
  52. package/skills/maestro-ralph-cli/SKILL.md +6 -6
  53. package/skills/maestro-ralph-cli-execute/SKILL.md +2 -2
  54. package/skills/maestro-ralph-execute/SKILL.md +4 -4
  55. package/skills/maestro-ralph-v2/SKILL.md +18 -19
  56. package/skills/maestro-roadmap/SKILL.md +8 -9
  57. package/skills/maestro-swarm-workflow/SKILL.md +9 -9
  58. package/skills/maestro-tools-execute/SKILL.md +5 -7
  59. package/skills/maestro-tools-register/SKILL.md +7 -9
  60. package/skills/maestro-ui-codify/SKILL.md +9 -10
  61. package/skills/maestro-universal-workflow/SKILL.md +15 -15
  62. package/skills/maestro-update/SKILL.md +10 -10
  63. package/skills/manage-codebase-rebuild/SKILL.md +4 -6
  64. package/skills/manage-drift-realign/SKILL.md +8 -11
  65. package/skills/manage-harvest/SKILL.md +6 -9
  66. package/skills/manage-issue/SKILL.md +5 -8
  67. package/skills/manage-issue-discover/SKILL.md +8 -11
  68. package/skills/manage-kg-extractors/SKILL.md +3 -3
  69. package/skills/manage-knowhow/SKILL.md +3 -5
  70. package/skills/manage-knowhow-capture/SKILL.md +4 -6
  71. package/skills/manage-knowledge-audit/SKILL.md +6 -9
  72. package/skills/manage-status/SKILL.md +3 -5
  73. package/skills/manage-wiki/SKILL.md +5 -7
  74. package/skills/odyssey-debug/SKILL.md +13 -13
  75. package/skills/odyssey-improve/SKILL.md +15 -15
  76. package/skills/odyssey-planex/SKILL.md +16 -16
  77. package/skills/odyssey-review-test-fix/SKILL.md +11 -11
  78. package/skills/odyssey-ui/SKILL.md +10 -10
  79. package/skills/prompt-generator/SKILL.md +5 -5
  80. package/skills/quality-auto-test/SKILL.md +3 -5
  81. package/skills/quality-debug/SKILL.md +3 -5
  82. package/skills/quality-refactor/SKILL.md +3 -5
  83. package/skills/quality-retrospective/SKILL.md +10 -13
  84. package/skills/quality-review/SKILL.md +5 -8
  85. package/skills/quality-sync/SKILL.md +3 -5
  86. package/skills/quality-test/SKILL.md +4 -6
  87. package/skills/scholar-anti-ai-writing/SKILL.md +1 -1
  88. package/skills/scholar-citation-verify/SKILL.md +1 -1
  89. package/skills/scholar-experiment/SKILL.md +2 -2
  90. package/skills/scholar-ideation/SKILL.md +7 -7
  91. package/skills/scholar-latex-organizer/SKILL.md +1 -1
  92. package/skills/scholar-publish/SKILL.md +3 -3
  93. package/skills/scholar-rebuttal-pro/SKILL.md +3 -3
  94. package/skills/scholar-review/SKILL.md +1 -1
  95. package/skills/scholar-writing/SKILL.md +1 -1
  96. package/skills/security-audit/SKILL.md +2 -4
  97. package/skills/skill-generator/SKILL.md +3 -3
  98. package/skills/skill-iter-tune/SKILL.md +3 -3
  99. package/skills/skill-simplify/SKILL.md +1 -1
  100. package/skills/skill-tuning/SKILL.md +1 -1
  101. package/skills/spec-add/SKILL.md +5 -7
  102. package/skills/spec-load/SKILL.md +3 -5
  103. package/skills/spec-remove/SKILL.md +4 -6
  104. package/skills/spec-setup/SKILL.md +6 -8
  105. package/skills/team-adversarial-swarm/SKILL.md +5 -5
  106. package/skills/team-arch-opt/SKILL.md +2 -2
  107. package/skills/team-brainstorm/SKILL.md +3 -3
  108. package/skills/team-coordinate/SKILL.md +4 -4
  109. package/skills/team-designer/SKILL.md +1 -1
  110. package/skills/team-executor/SKILL.md +3 -3
  111. package/skills/team-frontend/SKILL.md +2 -2
  112. package/skills/team-frontend-debug/SKILL.md +3 -3
  113. package/skills/team-interactive-craft/SKILL.md +2 -2
  114. package/skills/team-issue/SKILL.md +3 -3
  115. package/skills/team-lifecycle-v4/SKILL.md +4 -4
  116. package/skills/team-motion-design/SKILL.md +2 -2
  117. package/skills/team-perf-opt/SKILL.md +3 -3
  118. package/skills/team-planex/SKILL.md +2 -2
  119. package/skills/team-quality-assurance/SKILL.md +3 -3
  120. package/skills/team-review/SKILL.md +3 -3
  121. package/skills/team-roadmap-dev/SKILL.md +3 -3
  122. package/skills/team-swarm/SKILL.md +4 -4
  123. package/skills/team-tech-debt/SKILL.md +2 -2
  124. package/skills/team-testing/SKILL.md +3 -3
  125. package/skills/team-ui-polish/SKILL.md +2 -2
  126. package/skills/team-uidesign/SKILL.md +2 -2
  127. package/skills/team-ultra-analyze/SKILL.md +4 -4
  128. package/skills/team-ux-improve/SKILL.md +3 -3
  129. package/skills/team-visual-a11y/SKILL.md +2 -2
  130. package/skills/workflow-skill-designer/SKILL.md +8 -8
  131. package/templates/business-test-report.json +68 -0
  132. package/templates/config.json +48 -0
  133. package/templates/context.md +16 -0
  134. package/templates/doc-index.json +11 -0
  135. package/templates/index.json +68 -0
  136. package/templates/issue.json +36 -0
  137. package/templates/plan.json +38 -0
  138. package/templates/project.md +60 -0
  139. package/templates/reflection-log.md +20 -0
  140. package/templates/roadmap.md +45 -0
  141. package/templates/scratch-index.json +19 -0
  142. package/templates/search-tool.json +1 -0
  143. package/templates/search-tools.md +47 -0
  144. package/templates/state.json +18 -0
  145. package/templates/task-summary.md +21 -0
  146. package/templates/task.json +89 -0
  147. package/templates/terminology-template.json +22 -0
  148. package/templates/uat.md +21 -0
  149. package/templates/validation.json +31 -0
  150. package/templates/verification.json +37 -0
  151. package/templates/workflow.md +14 -0
  152. package/templates/worktree-scope.json +9 -0
  153. package/templates/worktrees.json +26 -0
  154. package/workflows/agy-instructions.md +156 -0
  155. package/workflows/analyze.md +768 -0
  156. package/workflows/auto-test.md +705 -0
  157. package/workflows/blueprint.md +406 -0
  158. package/workflows/boundary-grill.md +50 -0
  159. package/workflows/brainstorm.md +508 -0
  160. package/workflows/business-test.md +574 -0
  161. package/workflows/chinese-response.md +25 -0
  162. package/workflows/claude-instructions.md +167 -0
  163. package/workflows/codebase-rebuild.md +267 -0
  164. package/workflows/codebase-refresh.md +168 -0
  165. package/workflows/codex-instructions.md +156 -0
  166. package/workflows/coding-philosophy.md +70 -0
  167. package/workflows/command-authoring.md +823 -0
  168. package/workflows/debug.md +409 -0
  169. package/workflows/delegate-usage.md +99 -0
  170. package/workflows/domain-add.md +121 -0
  171. package/workflows/drift-realign.md +396 -0
  172. package/workflows/execute.md +631 -0
  173. package/workflows/explore-usage.md +93 -0
  174. package/workflows/finish-work.md +124 -0
  175. package/workflows/fork.md +162 -0
  176. package/workflows/grill.md +494 -0
  177. package/workflows/harvest.md +478 -0
  178. package/workflows/impeccable.md +168 -0
  179. package/workflows/init.md +157 -0
  180. package/workflows/instruction-authoring-guide.md +97 -0
  181. package/workflows/integration-test.md +186 -0
  182. package/workflows/interview-mechanics.md +8 -0
  183. package/workflows/issue-analyze.md +20 -0
  184. package/workflows/issue-discover.md +238 -0
  185. package/workflows/issue-execute.md +110 -0
  186. package/workflows/issue-gaps-analyze.codex.md +256 -0
  187. package/workflows/issue-gaps-analyze.md +215 -0
  188. package/workflows/issue-plan.md +110 -0
  189. package/workflows/issue.md +338 -0
  190. package/workflows/knowhow.md +429 -0
  191. package/workflows/knowledge-audit.md +355 -0
  192. package/workflows/learn.md +271 -0
  193. package/workflows/maestro-chain-execute.md +20 -0
  194. package/workflows/maestro-link-coordinate.md +114 -0
  195. package/workflows/maestro-super.md +120 -0
  196. package/workflows/maestro.md +501 -0
  197. package/workflows/map.md +74 -0
  198. package/workflows/merge.md +122 -0
  199. package/workflows/milestone-audit.md +155 -0
  200. package/workflows/milestone-complete.md +167 -0
  201. package/workflows/milestone-release.md +82 -0
  202. package/workflows/odyssey-base-codex.md +305 -0
  203. package/workflows/odyssey-base.md +256 -0
  204. package/workflows/overlays.md +109 -0
  205. package/workflows/plan.md +520 -0
  206. package/workflows/quick.md +350 -0
  207. package/workflows/ralph-amend-goal.md +177 -0
  208. package/workflows/refactor.md +87 -0
  209. package/workflows/retrospective.md +471 -0
  210. package/workflows/review.md +448 -0
  211. package/workflows/roadmap-common.md +193 -0
  212. package/workflows/roadmap.md +106 -0
  213. package/workflows/shell-exec-protocol.md +30 -0
  214. package/workflows/skill-authoring.md +265 -0
  215. package/workflows/spec-generate.md +475 -0
  216. package/workflows/specs-add.md +123 -0
  217. package/workflows/specs-load.md +76 -0
  218. package/workflows/specs-remove.md +104 -0
  219. package/workflows/specs-setup.md +316 -0
  220. package/workflows/status.md +149 -0
  221. package/workflows/sync.md +116 -0
  222. package/workflows/tdd.md +255 -0
  223. package/workflows/test-gen.md +226 -0
  224. package/workflows/test.md +385 -0
  225. package/workflows/tools-spec.md +70 -0
  226. package/workflows/ui-codify-extract.md +372 -0
  227. package/workflows/ui-codify-knowhow.md +258 -0
  228. package/workflows/ui-codify-package.md +159 -0
  229. package/workflows/ui-codify.md +227 -0
  230. package/workflows/ui-design.md +393 -0
  231. package/workflows/ui-style.md +201 -0
  232. package/workflows/verify.md +557 -0
  233. package/workflows/wiki-connect.md +153 -0
  234. package/workflows/wiki-digest.md +180 -0
  235. package/workflows/wiki-manage.md +113 -0
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-coordinate
3
3
  description: "Universal team coordination skill with dynamic role generation. Uses team-worker agent architecture with role-spec files. Only coordinator is built-in -- all worker roles are generated at runtime as role-specs and spawned via team-worker agent. Beat/cadence model for orchestration. Triggers on \"Team Coordinate \"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Coordinate
@@ -110,7 +110,7 @@ User provides task description
110
110
  When coordinator spawns workers, use `team-worker` agent with role-spec path:
111
111
 
112
112
  ```
113
- Agent({
113
+ teammate({
114
114
  subagent_type: "team-worker",
115
115
  description: "Spawn <role> worker",
116
116
  team_name: <team-name>,
@@ -147,7 +147,7 @@ Execute built-in Phase 1 (task discovery) -> role-spec Phase 2-4 -> built-in Pha
147
147
  When pipeline completes (all tasks done), coordinator presents an interactive choice:
148
148
 
149
149
  ```
150
- AskUserQuestion({
150
+ ask user ({
151
151
  questions: [{
152
152
  question: "Team pipeline complete. What would you like to do?",
153
153
  header: "Completion",
@@ -243,7 +243,7 @@ AskUserQuestion({
243
243
  Coordinator supports `resume` / `continue` for interrupted sessions:
244
244
 
245
245
  1. Scan `.workflow/.team/TC-*/team-session.json` for active/paused sessions
246
- 2. Multiple matches -> AskUserQuestion for selection
246
+ 2. Multiple matches -> user prompt for selection
247
247
  3. Audit TaskList -> reconcile session state <-> task status
248
248
  4. Reset in_progress -> pending (interrupted tasks)
249
249
  5. Rebuild team and spawn needed workers only
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-designer
3
3
  description: "Meta-skill for generating team skills following the v4 architecture pattern. Produces complete skill packages with SKILL.md router, coordinator, worker roles, specs, and templates. Triggers on \"team-designer\", \"design team\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Skill Designer
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-executor
3
3
  description: "Lightweight session execution skill. Resumes existing team-coordinate sessions for pure execution via team-worker agents. No analysis, no role generation -- only loads and executes. Session path required. Triggers on \"Team Executor\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Executor
@@ -107,7 +107,7 @@ Validate session
107
107
  When executor spawns workers, use `team-worker` agent with role-spec path:
108
108
 
109
109
  ```
110
- Agent({
110
+ teammate({
111
111
  subagent_type: "team-worker",
112
112
  description: "Spawn <role> worker",
113
113
  team_name: <team-name>,
@@ -139,7 +139,7 @@ Read role_spec file to load Phase 2-4 domain instructions.`
139
139
  When pipeline completes (all tasks done), executor presents an interactive choice:
140
140
 
141
141
  ```
142
- AskUserQuestion({
142
+ ask user ({
143
143
  questions: [{
144
144
  question: "Team pipeline complete. What would you like to do?",
145
145
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-frontend
3
3
  description: "Unified team skill for frontend development. Pure router — all roles read this file. Beat model is coordinator-only in monitor.md. Built-in ui-ux-pro-max design intelligence. Triggers on \"team frontend\"."
4
- allowed-tools: Agent TaskCreate TaskList TaskGet TaskUpdate TeamCreate TeamDelete SendMessage AskUserQuestion Read Write Edit Bash Glob Grep WebFetch WebSearch mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep WebFetch WebSearch maestro
5
5
  ---
6
6
 
7
7
  # Team Frontend Development
@@ -66,7 +66,7 @@ Parse `$ARGUMENTS`:
66
66
  Coordinator spawns workers using this template:
67
67
 
68
68
  ```
69
- Agent({
69
+ teammate({
70
70
  subagent_type: "team-worker",
71
71
  description: "Spawn <role> worker",
72
72
  team_name: "frontend",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-frontend-debug
3
3
  description: "Frontend debugging team using Chrome DevTools MCP. Dual-mode — feature-list testing or bug-report debugging. Triggers on \"team-frontend-debug\", \"frontend debug\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg mcp__chrome-devtools__*
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__chrome-devtools__* maestro
5
5
  ---
6
6
 
7
7
  # Frontend Debug Team
@@ -113,7 +113,7 @@ All browser inspection operations use Chrome DevTools MCP. Reproducer and Verifi
113
113
  Coordinator spawns workers using this template:
114
114
 
115
115
  ```
116
- Agent({
116
+ teammate({
117
117
  subagent_type: "team-worker",
118
118
  description: "Spawn <role> worker",
119
119
  team_name: <team-name>,
@@ -154,7 +154,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
154
154
  When pipeline completes, coordinator presents:
155
155
 
156
156
  ```
157
- AskUserQuestion({
157
+ ask user ({
158
158
  questions: [{
159
159
  question: "Pipeline complete. What would you like to do?",
160
160
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-interactive-craft
3
3
  description: "Unified team skill for interactive component crafting. Vanilla JS + CSS interactive components with zero dependencies. Research -> interaction design -> build -> a11y test. Uses team-worker agent architecture. Triggers on \"team interactive craft\", \"interactive component\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file maestro
5
5
  ---
6
6
 
7
7
  # Team Interactive Craft
@@ -67,7 +67,7 @@ Parse `$ARGUMENTS`:
67
67
  Coordinator spawns workers using this template:
68
68
 
69
69
  ```
70
- Agent({
70
+ teammate({
71
71
  subagent_type: "team-worker",
72
72
  description: "Spawn <role> worker for <task-id>",
73
73
  team_name: "interactive-craft",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-issue
3
3
  description: "Unified team skill for issue resolution. Uses team-worker agent architecture with role directories for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on \"team issue\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Issue Resolution
@@ -67,7 +67,7 @@ Parse `$ARGUMENTS`:
67
67
  Coordinator spawns workers using this template:
68
68
 
69
69
  ```
70
- Agent({
70
+ teammate({
71
71
  subagent_type: "team-worker",
72
72
  description: "Spawn <role> worker",
73
73
  team_name: "issue",
@@ -96,7 +96,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
96
96
  **Parallel spawn** (Batch mode, N explorer or M implementer instances):
97
97
 
98
98
  ```
99
- Agent({
99
+ teammate({
100
100
  subagent_type: "team-worker",
101
101
  name: "<role>-<N>",
102
102
  team_name: "issue",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-lifecycle-v4
3
3
  description: "Full lifecycle team skill — plan, develop, test, review in one coordinated session. Role-based architecture with coordinator-driven beat model. Triggers on \"team lifecycle v4\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Lifecycle v4
@@ -63,7 +63,7 @@ Parse `$ARGUMENTS`:
63
63
  Coordinator spawns workers using this template:
64
64
 
65
65
  ```
66
- Agent({
66
+ teammate({
67
67
  subagent_type: "team-worker",
68
68
  description: "Spawn <role> worker",
69
69
  team_name: <team-name>,
@@ -96,7 +96,7 @@ Supervisor is a **resident agent** (independent from team-worker). Spawned once
96
96
  ### Spawn (Phase 2 — once per session)
97
97
 
98
98
  ```
99
- Agent({
99
+ teammate({
100
100
  subagent_type: "team-supervisor",
101
101
  description: "Spawn resident supervisor",
102
102
  team_name: <team-name>,
@@ -162,7 +162,7 @@ SendMessage({
162
162
  When pipeline completes, coordinator presents:
163
163
 
164
164
  ```
165
- AskUserQuestion({
165
+ ask user ({
166
166
  questions: [{
167
167
  question: "Pipeline complete. What would you like to do?",
168
168
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-motion-design
3
3
  description: "Unified team skill for motion design. Animation token systems, scroll choreography, GPU-accelerated transforms, reduced-motion fallback. Uses team-worker agent architecture. Triggers on \"team motion design\", \"animation system\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg mcp__chrome-devtools__performance_start_trace mcp__chrome-devtools__performance_stop_trace mcp__chrome-devtools__performance_analyze_insight mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__chrome-devtools__performance_start_trace mcp__chrome-devtools__performance_stop_trace mcp__chrome-devtools__performance_analyze_insight mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot maestro
5
5
  ---
6
6
 
7
7
  # Team Motion Design
@@ -66,7 +66,7 @@ Parse `$ARGUMENTS`:
66
66
  Coordinator spawns workers using this template:
67
67
 
68
68
  ```
69
- Agent({
69
+ teammate({
70
70
  subagent_type: "team-worker",
71
71
  description: "Spawn <role> worker for <task-id>",
72
72
  team_name: "motion-design",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-perf-opt
3
3
  description: "Unified team skill for performance optimization. Coordinator orchestrates pipeline, workers are team-worker agents. Supports single/fan-out/independent parallel modes. Triggers on \"team perf-opt\"."
4
- allowed-tools: Agent TaskCreate TaskList TaskGet TaskUpdate TeamCreate TeamDelete SendMessage AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Performance Optimization
@@ -77,7 +77,7 @@ Parse `$ARGUMENTS`:
77
77
  Coordinator spawns workers using this template:
78
78
 
79
79
  ```
80
- Agent({
80
+ teammate({
81
81
  subagent_type: "team-worker",
82
82
  description: "Spawn <role> worker",
83
83
  team_name: "perf-opt",
@@ -142,7 +142,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
142
142
  When the pipeline completes:
143
143
 
144
144
  ```
145
- AskUserQuestion({
145
+ ask user ({
146
146
  questions: [{
147
147
  question: "Team pipeline complete. What would you like to do?",
148
148
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-planex
3
3
  description: "Unified team skill for plan-and-execute pipeline. Pure router — coordinator always. Beat model is coordinator-only in monitor.md. Triggers on \"team planex\"."
4
- allowed-tools: Agent TaskCreate TaskList TaskGet TaskUpdate TeamCreate TeamDelete SendMessage AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team PlanEx
@@ -65,7 +65,7 @@ Parse `$ARGUMENTS`:
65
65
  Coordinator spawns workers using this template:
66
66
 
67
67
  ```
68
- Agent({
68
+ teammate({
69
69
  subagent_type: "team-worker",
70
70
  description: "Spawn <role> worker",
71
71
  team_name: "planex",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-quality-assurance
3
3
  description: "Unified team skill for quality assurance. Full closed-loop QA combining issue discovery and software testing. Triggers on \"team quality-assurance\", \"team qa\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Quality Assurance
@@ -60,7 +60,7 @@ Parse `$ARGUMENTS`:
60
60
  Coordinator spawns workers using this template:
61
61
 
62
62
  ```
63
- Agent({
63
+ teammate({
64
64
  subagent_type: "team-worker",
65
65
  description: "Spawn <role> worker",
66
66
  team_name: "quality-assurance",
@@ -101,7 +101,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
101
101
  When pipeline completes, coordinator presents:
102
102
 
103
103
  ```
104
- AskUserQuestion({
104
+ ask user ({
105
105
  questions: [{
106
106
  question: "Quality Assurance pipeline complete. What would you like to do?",
107
107
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-review
3
3
  description: "Unified team skill for code review. 3-role pipeline: scanner, reviewer, fixer. Triggers on team-review."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Review
@@ -58,7 +58,7 @@ Parse `$ARGUMENTS`:
58
58
  Coordinator spawns workers using this template:
59
59
 
60
60
  ```
61
- Agent({
61
+ teammate({
62
62
  subagent_type: "team-worker",
63
63
  description: "Spawn <role> worker",
64
64
  team_name: "review",
@@ -101,7 +101,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
101
101
  When pipeline completes, coordinator presents:
102
102
 
103
103
  ```
104
- AskUserQuestion({
104
+ ask user ({
105
105
  questions: [{
106
106
  question: "Review pipeline complete. What would you like to do?",
107
107
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-roadmap-dev
3
3
  description: "Unified team skill for roadmap-driven development workflow. Coordinator discusses roadmap with user, then dispatches phased execution pipeline (plan -> execute -> verify). All roles invoke this skill with --role arg. Triggers on \"team roadmap-dev\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Roadmap Dev
@@ -72,7 +72,7 @@ Parse `$ARGUMENTS`:
72
72
  Coordinator spawns workers using this template:
73
73
 
74
74
  ```
75
- Agent({
75
+ teammate({
76
76
  subagent_type: "team-worker",
77
77
  description: "Spawn <role> worker",
78
78
  team_name: "roadmap-dev",
@@ -138,7 +138,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
138
138
  When the pipeline completes:
139
139
 
140
140
  ```
141
- AskUserQuestion({
141
+ ask user ({
142
142
  questions: [{
143
143
  question: "Roadmap Dev pipeline complete. What would you like to do?",
144
144
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-swarm
3
3
  description: "Swarm intelligence team skill — ACO-driven multi-agent exploration with hybrid LLM coordinator + Python optimization controller. Coordinator generates swarm-config from user task, then runs K iterations of N parallel ants guided by pheromone state. Universal task space via config (nodes + scoring rule). Triggers on \"team swarm\", \"swarm intelligence\", \"蚁群\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Swarm
@@ -66,7 +66,7 @@ Parse `$ARGUMENTS`:
66
66
  Coordinator spawns workers using this template:
67
67
 
68
68
  ```
69
- Agent({
69
+ teammate({
70
70
  subagent_type: "team-worker",
71
71
  description: "Spawn <role> worker",
72
72
  team_name: "swarm",
@@ -150,7 +150,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
150
150
  When swarm converges, coordinator presents:
151
151
 
152
152
  ```
153
- AskUserQuestion({
153
+ ask user ({
154
154
  questions: [{
155
155
  question: "Swarm pipeline complete. What would you like to do?",
156
156
  header: "Completion",
@@ -171,7 +171,7 @@ AskUserQuestion({
171
171
  |----------|------------|
172
172
  | `aco.py` not found | Verify `<skill_root>/scripts/aco.py`; check Python install |
173
173
  | Python version < 3.10 | Use `python3` or report dependency error |
174
- | Config validation fails | AskUserQuestion to fix, regenerate, retry |
174
+ | Config validation fails | user prompt to fix, regenerate, retry |
175
175
  | All ants fail in iteration | Halt, AskUserQuestion (retry / abort / refine config) |
176
176
  | Hallucination cluster (>50%) | Pause, AskUserQuestion (continue / refine scoring) |
177
177
  | Convergence never trips | `max_iterations` safety net always fires |
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-tech-debt
3
3
  description: "Unified team skill for tech debt identification and remediation. Scans codebase for tech debt, assesses severity, plans and executes fixes with validation. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on \"team tech debt\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file maestro
5
5
  ---
6
6
 
7
7
  # Team Tech Debt
@@ -60,7 +60,7 @@ Parse `$ARGUMENTS`:
60
60
  Coordinator spawns workers using this template:
61
61
 
62
62
  ```
63
- Agent({
63
+ teammate({
64
64
  subagent_type: "team-worker",
65
65
  description: "Spawn <role> worker for <task-id>",
66
66
  team_name: "tech-debt",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-testing
3
3
  description: "Unified team skill for testing team. Progressive test coverage through Generator-Critic loops, shared memory, and dynamic layer selection. Triggers on \"team testing\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Testing
@@ -59,7 +59,7 @@ Parse `$ARGUMENTS`:
59
59
  Coordinator spawns workers using this template:
60
60
 
61
61
  ```
62
- Agent({
62
+ teammate({
63
63
  subagent_type: "team-worker",
64
64
  description: "Spawn <role> worker",
65
65
  team_name: "testing",
@@ -99,7 +99,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
99
99
  When pipeline completes, coordinator presents:
100
100
 
101
101
  ```
102
- AskUserQuestion({
102
+ ask user ({
103
103
  questions: [{
104
104
  question: "Testing pipeline complete. What would you like to do?",
105
105
  header: "Completion",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-ui-polish
3
3
  description: "Unified team skill for UI polish. Auto-discover and fix UI design issues using Impeccable design standards. Anti-AI-slop detection, color/typography/spacing quality, motion, interaction states, visual hierarchy. Uses team-worker agent architecture. Triggers on \"team ui polish\", \"ui polish\", \"design polish\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot mcp__chrome-devtools__navigate_page mcp__chrome-devtools__resize_page
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot mcp__chrome-devtools__navigate_page mcp__chrome-devtools__resize_page maestro
5
5
  ---
6
6
 
7
7
  # Team UI Polish
@@ -67,7 +67,7 @@ Parse `$ARGUMENTS`:
67
67
  Coordinator spawns workers using this template:
68
68
 
69
69
  ```
70
- Agent({
70
+ teammate({
71
71
  subagent_type: "team-worker",
72
72
  description: "Spawn <role> worker for <task-id>",
73
73
  team_name: "ui-polish",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-uidesign
3
3
  description: "Unified team skill for UI design team. Research -> design tokens -> audit -> implementation. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates dual-track pipeline with GC loops and sync points. Triggers on \"team ui design\", \"ui design team\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file maestro
5
5
  ---
6
6
 
7
7
  # Team UI Design
@@ -66,7 +66,7 @@ Parse `$ARGUMENTS`:
66
66
  Coordinator spawns workers using this template:
67
67
 
68
68
  ```
69
- Agent({
69
+ teammate({
70
70
  subagent_type: "team-worker",
71
71
  description: "Spawn <role> worker for <task-id>",
72
72
  team_name: "uidesign",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-ultra-analyze
3
3
  description: "Deep collaborative analysis team skill. Multi-role investigation with coordinator-driven synthesis. Triggers on \"team ultra-analyze\", \"team analyze\"."
4
- allowed-tools: TeamCreate TeamDelete SendMessage TaskCreate TaskUpdate TaskList TaskGet Agent AskUserQuestion Read Write Edit Bash Glob Grep mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Team Ultra Analyze
@@ -74,7 +74,7 @@ Parse `$ARGUMENTS`:
74
74
  Coordinator spawns workers using this template:
75
75
 
76
76
  ```
77
- Agent({
77
+ teammate({
78
78
  subagent_type: "team-worker",
79
79
  description: "Spawn <role> worker",
80
80
  team_name: "ultra-analyze",
@@ -136,7 +136,7 @@ Execute built-in Phase 1 (task discovery, owner=<agent-name>) -> role Phase 2-4
136
136
  When pipeline completes, coordinator presents:
137
137
 
138
138
  ```
139
- AskUserQuestion({
139
+ ask user ({
140
140
  questions: [{
141
141
  question: "Ultra-Analyze pipeline complete. What would you like to do?",
142
142
  header: "Completion",
@@ -154,7 +154,7 @@ AskUserQuestion({
154
154
  |--------|--------|
155
155
  | Archive & Clean | Update session status="completed" -> TeamDelete() -> output final summary |
156
156
  | Keep Active | Update session status="paused" -> output resume instructions |
157
- | Export Results | AskUserQuestion for target path -> copy deliverables -> Archive & Clean |
157
+ | Export Results | user prompt for target path -> copy deliverables -> Archive & Clean |
158
158
 
159
159
  ## Specs Reference
160
160
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-ux-improve
3
3
  description: "Unified team skill for UX improvement. Systematically discovers and fixes UI/UX interaction issues including unresponsive buttons, missing feedback, and state refresh problems. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on \"team ux improve\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file maestro
5
5
  ---
6
6
 
7
7
  # Team UX Improve
@@ -75,7 +75,7 @@ Parse `$ARGUMENTS`:
75
75
  Coordinator spawns workers using this template:
76
76
 
77
77
  ```
78
- Agent({
78
+ teammate({
79
79
  subagent_type: "team-worker",
80
80
  description: "Spawn <role> worker for <task-id>",
81
81
  team_name: "ux-improve",
@@ -144,7 +144,7 @@ Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5
144
144
  | Unknown command | Error with available command list |
145
145
  | Role not found | Error with role registry |
146
146
  | Project path invalid | Re-prompt user for valid path |
147
- | Framework detection fails | AskUserQuestion for framework selection |
147
+ | Framework detection fails | user prompt for framework selection |
148
148
  | Session corruption | Attempt recovery, fallback to manual |
149
149
  | Fast-advance conflict | Coordinator reconciles on next callback |
150
150
  | No UI issues found | Complete with empty fix list, generate clean bill report |
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: team-visual-a11y
3
3
  description: "Unified team skill for visual accessibility QA. OKLCH color contrast, typography readability, focus management, WCAG AA/AAA audit at rendered level. Uses team-worker agent architecture. Triggers on \"team visual a11y\", \"accessibility audit\", \"visual a11y\"."
4
- allowed-tools: Agent AskUserQuestion Read Write Edit Bash Glob Grep TaskList TaskGet TaskUpdate TaskCreate TeamCreate TeamDelete SendMessage mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__maestro__team_msg mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot mcp__chrome-devtools__emulate mcp__chrome-devtools__lighthouse_audit mcp__chrome-devtools__navigate_page mcp__chrome-devtools__resize_page
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep mcp__maestro__read_file mcp__maestro__write_file mcp__maestro__edit_file mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__take_screenshot mcp__chrome-devtools__emulate mcp__chrome-devtools__lighthouse_audit mcp__chrome-devtools__navigate_page mcp__chrome-devtools__resize_page maestro
5
5
  ---
6
6
 
7
7
  # Team Visual Accessibility
@@ -78,7 +78,7 @@ Parse `$ARGUMENTS`:
78
78
  Coordinator spawns workers using this template:
79
79
 
80
80
  ```
81
- Agent({
81
+ teammate({
82
82
  subagent_type: "team-worker",
83
83
  description: "Spawn <role> worker for <task-id>",
84
84
  team_name: "visual-a11y",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: workflow-skill-designer
3
3
  description: "Meta-skill for designing orchestrator+phases structured workflow skills. Creates SKILL.md coordinator with progressive phase loading, TodoWrite patterns, and data flow. Triggers on \"design workflow skill\", \"create workflow skill\", \"workflow skill designer\"."
4
- allowed-tools: Agent AskUserQuestion TodoWrite Read Write Edit Bash Glob Grep
4
+ allowed-tools: teammate Read Write Edit Bash Glob Grep maestro
5
5
  ---
6
6
 
7
7
  # Workflow Skill Designer
@@ -108,13 +108,13 @@ CONTEXT: [background/constraints]
108
108
 
109
109
  ### Pattern 6: Interactive Preference Collection (SKILL.md Responsibility)
110
110
 
111
- Workflow preferences (auto mode, force explore, etc.) MUST be collected via AskUserQuestion in SKILL.md **before** dispatching to phases. Phases reference these as `workflowPreferences.{key}` context variables.
111
+ Workflow preferences (auto mode, force explore, etc.) MUST be collected via user prompt in SKILL.md **before** dispatching to phases. Phases reference these as `workflowPreferences.{key}` context variables.
112
112
 
113
113
  **Anti-Pattern**: Command-line flags (`--yes`, `-e`, `--explore`) parsed within phase files via `$ARGUMENTS.includes(...)`.
114
114
 
115
115
  ```javascript
116
116
  // CORRECT: In SKILL.md (before phase dispatch)
117
- const prefResponse = AskUserQuestion({
117
+ const prefResponse = ask user ({
118
118
  questions: [
119
119
  { question: "是否跳过确认?", header: "Auto Mode", options: [
120
120
  { label: "Interactive (Recommended)", description: "交互模式" },
@@ -150,7 +150,7 @@ Phase files are internal execution documents. They MUST NOT contain:
150
150
 
151
151
  | Prohibited | Reason | Correct Location |
152
152
  |------------|--------|------------------|
153
- | Flag parsing (`$ARGUMENTS.includes(...)`) | Preferences collected in SKILL.md | SKILL.md via AskUserQuestion |
153
+ | Flag parsing (`$ARGUMENTS.includes(...)`) | Preferences collected in SKILL.md | SKILL.md via user prompt |
154
154
  | Invocation syntax (`/skill-name "..."`) | Not user-facing docs | Removed or SKILL.md only |
155
155
  | Conversion provenance (`Source: Converted from...`) | Implementation detail | Removed |
156
156
  | Skill routing for inter-phase (`Skill(skill="...")`) | Use direct phase read | Direct `Read("phases/...")` |
@@ -357,7 +357,7 @@ What goes into SKILL.md vs what goes into phase files:
357
357
  ---
358
358
  name: {skill-name}
359
359
  description: {description}. Triggers on "{trigger1}", "{trigger2}".
360
- allowed-tools: {tools}
360
+ allowed-tools: {tools} maestro
361
361
  ---
362
362
 
363
363
  # {Title}
@@ -375,8 +375,8 @@ allowed-tools: {tools}
375
375
 
376
376
  ## Interactive Preference Collection
377
377
 
378
- Collect workflow preferences via AskUserQuestion before dispatching to phases:
379
- {AskUserQuestion code with preference derivation → workflowPreferences}
378
+ Collect workflow preferences via user prompt before dispatching to phases:
379
+ {user prompt code with preference derivation → workflowPreferences}
380
380
 
381
381
  ## Auto Mode Defaults
382
382
 
@@ -491,6 +491,6 @@ When designing a new workflow skill, answer these questions:
491
491
  | What's the TodoWrite granularity? | TodoWrite Pattern | Some phases have sub-tasks, others are atomic |
492
492
  | Is there a planning notes pattern? | Post-Phase Updates | Accumulated state document across phases |
493
493
  | What's the error recovery? | Error Handling | Retry once then report, vs rollback |
494
- | Does it need preference collection? | Interactive Preference Collection | Collect via AskUserQuestion in SKILL.md, pass as workflowPreferences |
494
+ | Does it need preference collection? | Interactive Preference Collection | Collect via user prompt in SKILL.md, pass as workflowPreferences |
495
495
  | Does phase N hand off to phase M? | Direct Phase Handoff (Pattern 7) | Read phase doc directly, not Skill() routing |
496
496
  | Will later phases run after long context? | Compact Recovery (Pattern 9) | Add sentinel + checkpoints, mark 🔄 in Phase Reference table |