prizmkit 1.1.190 → 1.1.192

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 (189) hide show
  1. package/bin/create-prizmkit.js +4 -4
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +150 -0
  4. package/bundled/adapters/antigravity/hooks-adapter.js +195 -0
  5. package/bundled/adapters/antigravity/paths.js +14 -0
  6. package/bundled/adapters/antigravity/rules-adapter.js +54 -0
  7. package/bundled/adapters/antigravity/skill-adapter.js +38 -0
  8. package/bundled/adapters/codex/skill-adapter.js +28 -8
  9. package/bundled/adapters/cursor/skill-adapter.js +13 -4
  10. package/bundled/adapters/pi/skill-adapter.js +28 -7
  11. package/bundled/dev-pipeline/.env.example +4 -12
  12. package/bundled/dev-pipeline/README.md +21 -15
  13. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +3 -6
  14. package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
  15. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
  16. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
  17. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
  18. package/bundled/dev-pipeline/prizmkit_runtime/config.py +29 -70
  19. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +125 -67
  20. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +89 -442
  21. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +93 -49
  22. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -3
  23. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
  24. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +49 -18
  25. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +206 -151
  26. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +2 -23
  27. package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +15 -134
  28. package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
  29. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +68 -83
  30. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
  31. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -29
  32. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
  33. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
  34. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +282 -217
  35. package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +124 -122
  36. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
  37. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +369 -154
  38. package/bundled/dev-pipeline/prizmkit_runtime/status.py +3 -3
  39. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2780 -0
  40. package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -101
  41. package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
  42. package/bundled/dev-pipeline/scripts/check-session-status.py +43 -19
  43. package/bundled/dev-pipeline/scripts/continuation.py +6 -4
  44. package/bundled/dev-pipeline/scripts/detect-stuck.py +28 -28
  45. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +7 -2
  46. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +7 -2
  47. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
  48. package/bundled/dev-pipeline/scripts/init-change-artifact.py +8 -2
  49. package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
  50. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2328
  51. package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
  52. package/bundled/dev-pipeline/scripts/prompt_framework.py +56 -9
  53. package/bundled/dev-pipeline/scripts/status_common.py +591 -0
  54. package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
  55. package/bundled/dev-pipeline/scripts/update-checkpoint.py +227 -65
  56. package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
  57. package/bundled/dev-pipeline/scripts/utils.py +10 -15
  58. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +4 -4
  59. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
  60. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +1 -1
  61. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
  62. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
  63. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  64. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
  65. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
  66. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
  67. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
  68. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
  69. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
  70. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
  71. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
  72. package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
  73. package/bundled/dev-pipeline/tests/_helpers.py +418 -0
  74. package/bundled/dev-pipeline/tests/conftest.py +45 -1
  75. package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +1 -0
  76. package/bundled/dev-pipeline/tests/test_auto_skip.py +4 -69
  77. package/bundled/dev-pipeline/tests/test_checkpoint_state.py +126 -1
  78. package/bundled/dev-pipeline/tests/test_daemon_and_scripts.py +257 -0
  79. package/bundled/dev-pipeline/tests/test_e2e_pipeline_run.py +500 -0
  80. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +59 -117
  81. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +12 -10
  82. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +561 -3094
  83. package/bundled/dev-pipeline/tests/test_recovery_workflow.py +7 -8
  84. package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -1
  85. package/bundled/dev-pipeline/tests/test_reset_modes.py +15 -27
  86. package/bundled/dev-pipeline/tests/test_reset_preserve.py +54 -139
  87. package/bundled/dev-pipeline/tests/test_runner_bookkeeping.py +766 -0
  88. package/bundled/dev-pipeline/tests/test_runner_lifecycle.py +1257 -0
  89. package/bundled/dev-pipeline/tests/test_runtime_helper.py +97 -20
  90. package/bundled/dev-pipeline/tests/test_session_launch.py +1101 -0
  91. package/bundled/dev-pipeline/tests/test_stream_progress.py +585 -0
  92. package/bundled/dev-pipeline/tests/test_unified_cli.py +490 -2006
  93. package/bundled/dev-pipeline/tests/test_utils.py +3 -3
  94. package/bundled/rules/USAGE.md +1 -0
  95. package/bundled/skills/_metadata.json +9 -63
  96. package/bundled/skills/app-planner/SKILL.md +32 -303
  97. package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
  98. package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
  99. package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
  100. package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
  101. package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
  102. package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
  103. package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
  104. package/bundled/skills/bug-planner/SKILL.md +54 -435
  105. package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
  106. package/bundled/skills/bug-planner/references/input-formats.md +32 -0
  107. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
  108. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
  109. package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
  110. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
  111. package/bundled/skills/feature-planner/SKILL.md +60 -439
  112. package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
  113. package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
  114. package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
  115. package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
  116. package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
  117. package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
  118. package/bundled/skills/feature-workflow/SKILL.md +1 -2
  119. package/bundled/skills/prizmkit/SKILL.md +7 -1
  120. package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
  121. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
  122. package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
  123. package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
  124. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  125. package/bundled/skills/prizmkit-init/SKILL.md +25 -128
  126. package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
  127. package/bundled/skills/prizmkit-init/references/config-schema.md +2 -2
  128. package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
  129. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
  130. package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
  131. package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
  132. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
  133. package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +1 -1
  134. package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +1 -1
  135. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
  136. package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
  137. package/bundled/skills/prizmkit-test/SKILL.md +25 -133
  138. package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
  139. package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
  140. package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
  141. package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
  142. package/bundled/skills/recovery-workflow/SKILL.md +7 -7
  143. package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
  144. package/bundled/skills/recovery-workflow/references/detection.md +1 -3
  145. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
  146. package/bundled/templates/project-memory-template.md +1 -2
  147. package/package.json +1 -1
  148. package/src/ai-cli-launch.js +1 -1
  149. package/src/clean.js +40 -4
  150. package/src/config.js +64 -4
  151. package/src/detect-platform.js +10 -6
  152. package/src/external-skills.js +2 -2
  153. package/src/index.js +1 -0
  154. package/src/manifest.js +1 -1
  155. package/src/platforms.js +6 -2
  156. package/src/prompts.js +11 -3
  157. package/src/scaffold.js +87 -11
  158. package/src/upgrade.js +9 -3
  159. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
  160. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
  161. package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
  162. package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
  163. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
  164. package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
  165. package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
  166. package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
  167. package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
  168. package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
  169. package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
  170. package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
  171. package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
  172. package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
  173. package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
  174. package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
  175. package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
  176. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
  177. package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
  178. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
  179. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
  180. package/bundled/skills/refactor-planner/SKILL.md +0 -467
  181. package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
  182. package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
  183. package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
  184. package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
  185. package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
  186. package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
  187. package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
  188. package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
  189. package/bundled/skills/refactor-workflow/SKILL.md +0 -205
@@ -1,205 +0,0 @@
1
- ---
2
- name: "refactor-workflow"
3
- description: "Thin behavior-preserving refactor scenario router. Clarifies enough to choose direct single-requirement guidance, refactor planning, existing-list command construction, or behavior-change rerouting; hands planning to refactor-planner and runtime command construction to refactor-pipeline-launcher. It never starts coding or owns the requirement lifecycle."
4
- ---
5
-
6
- # Refactor Workflow
7
-
8
- Classify behavior intent, prepare a concise handoff brief, and route planned work without implementing a refactor or duplicating planner/launcher responsibilities.
9
-
10
- ## Responsibility Boundary
11
-
12
- This workflow owns:
13
- - Scenario recognition: direct single-requirement guidance, Pipeline Path, existing-list command construction, or behavior-change reroute.
14
- - Lightweight behavior-preservation and scope triage.
15
- - User path selection through `AskUserQuestion`.
16
- - Prompt brief handoff to `refactor-planner`, `refactor-pipeline-launcher`, or `feature-workflow` for behavior changes.
17
- - Continuation after `refactor-planner` when the user entered through this workflow.
18
-
19
- This workflow does not own:
20
- - Source-code implementation, test execution, code review, documentation sync, or commit execution.
21
- - Deep code analysis, item decomposition, dependency ordering, behavior-preservation strategy selection, schema validation, or plan review gates — those belong to `refactor-planner`.
22
- - Runtime option selection, command construction, prerequisite checks, or status/log/stop/retry syntax — those belong to `refactor-pipeline-launcher`.
23
- - Product behavior changes — those route to feature work.
24
- - The independent direct requirement lifecycle.
25
-
26
- ## Execution Topology
27
-
28
- ```text
29
- Direct single requirement:
30
- User → prizmkit-workflow → atomic lifecycle skills
31
-
32
- Planned refactor execution:
33
- User → refactor-workflow → refactor-planner → refactor-pipeline-launcher → returned CLI command → runtime → atomic lifecycle skills
34
- ```
35
-
36
- The routes are independent. This workflow can identify a direct-path candidate, but it ends before the user enters the direct path and never invokes the direct workflow.
37
-
38
- ## Behavior-Preservation Boundary
39
-
40
- Refactoring means external behavior remains unchanged:
41
- - Public product behavior and user-visible outcomes stay the same.
42
- - Public contracts remain stable unless the user confirms a compatibility-preserving migration.
43
- - Tests and behavior checks prove the change is structural.
44
-
45
- Changed product behavior, new user-facing functionality, or a breaking public API routes to `feature-workflow`. Internal API/import/module changes can remain refactoring when external behavior is preserved and the planner can define a safe migration.
46
-
47
- ## When to Use
48
-
49
- Use this workflow to:
50
- - Classify cleanup, restructuring, extraction, decoupling, simplification, or migration intent.
51
- - Decide whether one confirmed refactor should use the independent Direct Path or planned runtime execution.
52
- - Plan batch/cross-module behavior-preserving work.
53
- - Continue from `.prizmkit/plans/refactor-list.json`.
54
-
55
- Do not use this workflow when the user only wants:
56
- - The direct single-requirement lifecycle -> enter it independently.
57
- - Refactor planning without execution intent -> `refactor-planner`.
58
- - Runtime command construction for an existing refactor list -> `refactor-pipeline-launcher`.
59
- - New functionality or changed product behavior -> `feature-workflow`.
60
- - Bug repair -> `bug-fix-workflow` or bug planning skills.
61
-
62
- ## Route Overview
63
-
64
- | User situation | Route |
65
- |---|---|
66
- | One confirmed local behavior-preserving requirement | Explain independent Direct Path and end this router |
67
- | Batch, cross-module, weak-test, or ordered migration | `refactor-planner` -> return here -> `refactor-pipeline-launcher` |
68
- | Product behavior change or breaking public API | `feature-workflow` |
69
- | Explicit request for an existing refactor-list command | `refactor-pipeline-launcher` |
70
- | Auto-discovered refactor list | Ask construct command / inspect / update |
71
-
72
- ## Route Selection
73
-
74
- ### Step 1: Detect entry mode
75
-
76
- Classify the request as behavior-preserving refactor, confirmed behavior change, suspected behavior change, existing-list command, or unclear. If preservation is unclear, ask one concise question.
77
-
78
- ### Step 2: Lightweight triage
79
-
80
- A Direct Path candidate is one localized, confirmed behavior-preserving requirement with obvious checks and no dependency ordering. This classification only tells the user to leave this router for the independent direct entry.
81
-
82
- A Pipeline Path candidate has one or more of these signals:
83
- - Multiple items or batch refactoring.
84
- - Cross-module or multi-layer impact.
85
- - Import-path, internal API, or module-boundary migration ordering.
86
- - Weak test coverage or non-trivial behavior-preservation risk.
87
- - Autonomous/background execution intent.
88
- - A need for planner-owned analysis, decomposition, validation, and review.
89
-
90
- Do not perform deep code analysis here.
91
-
92
- ### Step 3: Ask for path selection
93
-
94
- Use `AskUserQuestion`; do not render options as plain text.
95
-
96
- ```text
97
- Question: How would you like to proceed?
98
- Header: Approach
99
- Options:
100
- - Use Direct Path — leave this router and invoke the direct single-requirement workflow independently
101
- - Use Pipeline Path — refactor-planner creates/reviews refactor-list.json, then refactor-pipeline-launcher constructs the runtime command
102
- - Continue clarifying — ask more route-level questions
103
- ```
104
-
105
- If behavior change is confirmed, route to `feature-workflow` and stop refactor routing. If behavior change is only suspected, offer `Route to feature-workflow (Recommended)`, `Confirm behavior-preserving constraints`, or `Continue clarifying`.
106
-
107
- For an auto-discovered list, offer construct command, inspect summary, update/re-plan, or ignore and plan the new request. Explicit command intent counts as path selection.
108
-
109
- ## Workflow Handoff Brief
110
-
111
- When handing off to a planner, launcher, or feature router, include this prompt brief. Do not write it to disk.
112
-
113
- ```markdown
114
- ### Source
115
- - workflow: refactor-workflow
116
- - selected_path: pipeline_path | existing_list_command | behavior_change_reroute
117
-
118
- ### User Goal
119
- - original_request: <preserve the user's wording>
120
- - normalized_goal: <lightly normalized restructuring goal>
121
-
122
- ### Scope
123
- - included: <explicitly in scope>
124
- - excluded: <explicitly out of scope or unknown>
125
-
126
- ### Behavior Preservation
127
- - must_remain_unchanged: <public behavior, outcomes, APIs, workflows, tests>
128
- - suspected_behavior_changes: <items that may need feature-workflow>
129
-
130
- ### Materials
131
- - provided_paths: <paths/directories>
132
- - provided_docs_or_urls: <docs, links, screenshots, specs>
133
- - notes: <constraints or emphasis>
134
-
135
- ### Decision
136
- - route_reason: <why selected>
137
- - user_confirmed: yes
138
-
139
- ### Next Skill Instruction
140
- - Planner: own code analysis for planning, preservation strategy, validation, generation, and planner-local review; return the validated list without performing the refactor.
141
- - Launcher: own runtime configuration and command construction; do not re-plan, implement, or execute the command.
142
- ```
143
-
144
- The direct path has no planner/launcher handoff. Preserve original intent and behavior constraints in the exit guidance.
145
-
146
- ## Selected Path Execution
147
-
148
- ### Direct Path guidance
149
-
150
- 1. Confirm one formal behavior-preserving requirement.
151
- 2. Explain the independent direct topology in §Execution Topology.
152
- 3. Preserve requirement and behavior constraints in one concise next-entry instruction.
153
- 4. End `refactor-workflow`. Do not start coding, invoke lifecycle skills, monitor the direct workflow, or reclaim control after it starts.
154
-
155
- If scope grows or behavior changes, remain in this router and offer Pipeline Path or `feature-workflow`.
156
-
157
- ### Pipeline Path
158
-
159
- 1. Invoke `refactor-planner` with the handoff brief.
160
- 2. The planner owns code analysis, decomposition, preservation strategy, validation, and review.
161
- 3. After a validated `.prizmkit/plans/refactor-list.json` returns, show item count, ordering, preservation strategy, and review/validation outcome.
162
- 4. Ask whether to construct the runtime command.
163
- 5. If yes, invoke `refactor-pipeline-launcher`.
164
-
165
- Do not duplicate strict-behavior-check or runtime configuration questions.
166
-
167
- ### Existing list command
168
-
169
- Route explicit run/status/logs/retry/stop command requests to `refactor-pipeline-launcher`. Ask construct command / inspect / update when the list was only auto-discovered.
170
-
171
- ## Resume Guidance
172
-
173
- | State found | Action |
174
- |---|---|
175
- | Direct workflow state exists | Exit this router and tell the user to resume its recorded requirement workflow |
176
- | Valid refactor list with command intent | Invoke `refactor-pipeline-launcher` |
177
- | Valid refactor list with planning intent | Invoke `refactor-planner` |
178
- | Interrupted refactor task branch exists | Route to `recovery-workflow` for the exact continuation command |
179
- | No artifacts | Start behavior classification and route selection |
180
-
181
- ## Error Handling
182
-
183
- | Situation | Action |
184
- |---|---|
185
- | Product behavior change is confirmed | Route to `feature-workflow` and stop refactor routing |
186
- | Planning only | Route to `refactor-planner` and stop after its summary |
187
- | Existing-list command requested | Route to `refactor-pipeline-launcher` |
188
- | No obvious behavior checks | Recommend Pipeline Path unless scope is clearly local |
189
- | Direct candidate reveals broader risk | Keep control here and offer Pipeline Path |
190
- | Planner needs detail | Let `refactor-planner` ask its own questions |
191
- | Launcher finds configuration issues | Let `refactor-pipeline-launcher` own them |
192
-
193
- ## Handoff Map
194
-
195
- | From | To | Condition |
196
- |---|---|---|
197
- | `refactor-workflow` | `feature-workflow` | Request requires product behavior change |
198
- | `refactor-workflow` | `refactor-planner` | User selects Pipeline Path |
199
- | `refactor-planner` | `refactor-workflow` | Planning completed from this workflow's Pipeline Path |
200
- | `refactor-workflow` | `refactor-pipeline-launcher` | User requests command construction or an existing-list operation |
201
-
202
- ## Output
203
-
204
- - Direct guidance: behavior-preservation summary, independent direct-entry topology, and preserved requirement text; no code change or implementation result.
205
- - Pipeline Path: handoff brief, validated `.prizmkit/plans/refactor-list.json`, and a command returned by `refactor-pipeline-launcher`.