prizmkit 1.1.25 → 1.1.26

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.
@@ -1,5 +1,5 @@
1
1
  {
2
- "frameworkVersion": "1.1.25",
3
- "bundledAt": "2026-04-12T02:12:31.973Z",
4
- "bundledFrom": "b63b063"
2
+ "frameworkVersion": "1.1.26",
3
+ "bundledAt": "2026-04-12T02:27:49.522Z",
4
+ "bundledFrom": "c191f35"
5
5
  }
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.1.25",
2
+ "version": "1.1.26",
3
3
  "skills": {
4
4
  "prizm-kit": {
5
5
  "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",
@@ -164,15 +164,15 @@ AskUserQuestion:
164
164
  header: "Approach"
165
165
  options:
166
166
  - label: "Fix now (fast path)"
167
- description: "Implement the fix directly in this session"
168
- - label: "Add to bug list"
169
- description: "Add to .prizmkit/plans/bug-fix-list.json for pipeline execution later"
167
+ description: "Implement the fix directly in this session — branch → test → fix → review → commit"
168
+ - label: "Add to bug-fix-list.json (pipeline)"
169
+ description: "Add this bug to .prizmkit/plans/bug-fix-list.json via bug-planner, then use bugfix-pipeline-launcher to launch autonomous pipeline execution"
170
170
  - label: "Full diagnosis"
171
171
  description: "Continue with in-depth analysis before deciding"
172
172
  ```
173
173
 
174
174
  - **Fix now** → Proceed with Fast Path Workflow (Phase 0 branch already set up)
175
- - **Add to bug list** → Invoke `bug-planner` to add this bug to the list, then end this workflow
175
+ - **Add to bug-fix-list.json** → Invoke `bug-planner` to add this bug to `.prizmkit/plans/bug-fix-list.json`, then suggest user run `bugfix-pipeline-launcher` to start the pipeline. End this workflow.
176
176
  - **Full diagnosis** → Continue with full diagnosis (Phase 2 Triage)
177
177
 
178
178
  **Complex bug → Planning Path** (ANY is true):
@@ -191,15 +191,15 @@ AskUserQuestion:
191
191
  options:
192
192
  - label: "Plan and fix now"
193
193
  description: "Create a plan and fix it in this session using /prizmkit-plan + /prizmkit-implement"
194
- - label: "Add to bug list"
195
- description: "Add to .prizmkit/plans/bug-fix-list.json for pipeline execution later"
194
+ - label: "Add to bug-fix-list.json (pipeline)"
195
+ description: "Add this bug to .prizmkit/plans/bug-fix-list.json via bug-planner, then use bugfix-pipeline-launcher to launch autonomous pipeline execution"
196
196
  ```
197
197
 
198
198
  - **Plan and fix now** → Invoke `/prizmkit-plan` with `artifact_dir=.prizmkit/bugfix/<BUG_ID>/`:
199
199
  1. prizmkit-plan generates `spec.md` + `plan.md` under `.prizmkit/bugfix/<BUG_ID>/`
200
200
  2. Invoke `/prizmkit-implement` to execute the plan
201
201
  3. After implementation, resume this workflow at Phase 5 (Review)
202
- - **Add to bug list** → Invoke `bug-planner` to add this bug to the list, then end this workflow
202
+ - **Add to bug-fix-list.json** → Invoke `bug-planner` to add this bug to `.prizmkit/plans/bug-fix-list.json`, then suggest user run `bugfix-pipeline-launcher` to start the pipeline. End this workflow.
203
203
 
204
204
  **NEVER proceed with direct code changes without explicit user confirmation via `AskUserQuestion`. Do NOT render options as plain text — the user must be able to click/select.**
205
205
 
@@ -250,12 +250,75 @@ Once brainstorming is complete, produce a structured requirements summary:
250
250
  ### Confirmed by user: ✓
251
251
  ```
252
252
 
253
- Present this summary to the user and get explicit confirmation before proceeding to Phase 2.
253
+ Present this summary to the user and get explicit confirmation before proceeding.
254
254
 
255
255
  **CHECKPOINT CP-FW-0**: Requirements fully clarified and confirmed by user.
256
256
 
257
257
  ---
258
258
 
259
+ ### Step 1.7: Complexity Assessment & Approach Selection
260
+
261
+ After confirming requirements, assess whether this feature needs the full pipeline or can be done directly in the current session.
262
+
263
+ **Simple feature → Fast Path candidate** (ALL must be true):
264
+ - Single module, no cross-module architectural impact
265
+ - ≤2 new files to create
266
+ - No new external dependencies or infrastructure changes
267
+ - Straightforward implementation (CRUD, utility, simple UI component)
268
+ - Clear acceptance criteria with existing patterns to follow
269
+ - No dependency on other unbuilt features
270
+
271
+ **User choice required (mandatory)** — Use `AskUserQuestion` to present interactive selectable options:
272
+
273
+ ```
274
+ AskUserQuestion:
275
+ question: "This feature appears straightforward. How would you like to proceed?"
276
+ header: "Approach"
277
+ options:
278
+ - label: "Implement now (fast path)"
279
+ description: "Plan and implement directly in this session using /prizmkit-plan + /prizmkit-implement"
280
+ - label: "Add to feature list (pipeline)"
281
+ description: "Generate .prizmkit/plans/feature-list.json via feature-planner, then launch pipeline for autonomous execution"
282
+ ```
283
+
284
+ - **Implement now** → Fast Path Workflow:
285
+ 1. Invoke `/prizmkit-plan` with the requirements summary → generates `spec.md` + `plan.md`
286
+ 2. Invoke `/prizmkit-implement` to execute the plan
287
+ 3. After implementation, run `/prizmkit-code-review` for quality check
288
+ 4. Commit via `/prizmkit-committer` with `feat(<scope>):` prefix
289
+ 5. Run `/prizmkit-retrospective` to sync `.prizm-docs/`
290
+ 6. **End workflow** — skip Phase 2/3/4
291
+ - **Add to feature list** → Continue to Phase 2 (Plan via pipeline)
292
+
293
+ **Complex feature → Planning Path** (ANY is true):
294
+ - Cross-module impact (>2 modules affected)
295
+ - New infrastructure, dependencies, or architectural patterns required
296
+ - Multiple interrelated features with dependency ordering
297
+ - Data model or API design decisions needed
298
+ - Requires integration with external services
299
+
300
+ **User choice required (mandatory)** — Use `AskUserQuestion` to present interactive selectable options:
301
+
302
+ ```
303
+ AskUserQuestion:
304
+ question: "This feature is complex and will benefit from structured planning. How would you like to proceed?"
305
+ header: "Approach"
306
+ options:
307
+ - label: "Plan and implement now"
308
+ description: "Create a plan and implement in this session using /prizmkit-plan + /prizmkit-implement"
309
+ - label: "Add to feature list (pipeline)"
310
+ description: "Generate .prizmkit/plans/feature-list.json via feature-planner, then launch pipeline for autonomous execution"
311
+ ```
312
+
313
+ - **Plan and implement now** → Invoke `/prizmkit-plan` with requirements → `/prizmkit-implement` → `/prizmkit-code-review` → `/prizmkit-committer` → `/prizmkit-retrospective`. **End workflow** — skip Phase 2/3/4.
314
+ - **Add to feature list** → Continue to Phase 2 (Plan via pipeline)
315
+
316
+ **NEVER proceed without explicit user confirmation via `AskUserQuestion`. Do NOT render options as plain text — the user must be able to click/select.**
317
+
318
+ **CHECKPOINT CP-FW-0.5**: Approach selected by user (fast path or pipeline).
319
+
320
+ ---
321
+
259
322
  ## Phase 2: Plan
260
323
 
261
324
  **Goal**: Generate structured .prizmkit/plans/feature-list.json from the clarified requirements.
@@ -251,12 +251,76 @@ Once brainstorming is complete, produce a structured goals summary:
251
251
  ### Confirmed by user: ✓
252
252
  ```
253
253
 
254
- Present this summary to the user and get explicit confirmation before proceeding to Phase 2.
254
+ Present this summary to the user and get explicit confirmation before proceeding.
255
255
 
256
256
  **CHECKPOINT CP-RW-0**: Refactoring goals fully clarified and confirmed by user.
257
257
 
258
258
  ---
259
259
 
260
+ ### Step 1.7: Complexity Assessment & Approach Selection
261
+
262
+ After confirming refactoring goals, assess whether this refactor needs the full pipeline or can be done directly in the current session.
263
+
264
+ **Simple refactor → Fast Path candidate** (ALL must be true):
265
+ - Single module, no cross-module impact
266
+ - ≤3 files affected
267
+ - No public API or interface changes
268
+ - Straightforward transformation (extract method, rename, move file, simplify logic)
269
+ - Existing tests fully cover the affected code paths
270
+ - No risk of behavior change
271
+
272
+ **User choice required (mandatory)** — Use `AskUserQuestion` to present interactive selectable options:
273
+
274
+ ```
275
+ AskUserQuestion:
276
+ question: "This refactoring appears straightforward. How would you like to proceed?"
277
+ header: "Approach"
278
+ options:
279
+ - label: "Refactor now (fast path)"
280
+ description: "Plan and refactor directly in this session using /prizmkit-plan + /prizmkit-implement"
281
+ - label: "Add to refactor list (pipeline)"
282
+ description: "Generate .prizmkit/plans/refactor-list.json via refactor-planner, then launch pipeline for autonomous execution"
283
+ ```
284
+
285
+ - **Refactor now** → Fast Path Workflow:
286
+ 1. Invoke `/prizmkit-plan` with the refactoring goals → generates `spec.md` + `plan.md`
287
+ 2. Invoke `/prizmkit-implement` to execute the plan (behavior preservation verified by tests)
288
+ 3. After implementation, run `/prizmkit-code-review` for quality check
289
+ 4. Commit via `/prizmkit-committer` with `refactor(<scope>):` prefix
290
+ 5. Run `/prizmkit-retrospective` to sync `.prizm-docs/`
291
+ 6. **End workflow** — skip Phase 2/3/4
292
+ - **Add to refactor list** → Continue to Phase 2 (Plan via pipeline)
293
+
294
+ **Complex refactor → Planning Path** (ANY is true):
295
+ - Cross-module impact (>2 modules affected)
296
+ - Public API or interface changes required
297
+ - Multiple interrelated refactoring steps with dependency ordering
298
+ - Comprehensive rewrite of a module
299
+ - Insufficient test coverage in target area (risk of hidden behavior changes)
300
+ - Requires coordination with other ongoing work
301
+
302
+ **User choice required (mandatory)** — Use `AskUserQuestion` to present interactive selectable options:
303
+
304
+ ```
305
+ AskUserQuestion:
306
+ question: "This refactoring is complex and will benefit from structured planning. How would you like to proceed?"
307
+ header: "Approach"
308
+ options:
309
+ - label: "Plan and refactor now"
310
+ description: "Create a plan and refactor in this session using /prizmkit-plan + /prizmkit-implement"
311
+ - label: "Add to refactor list (pipeline)"
312
+ description: "Generate .prizmkit/plans/refactor-list.json via refactor-planner, then launch pipeline for autonomous execution"
313
+ ```
314
+
315
+ - **Plan and refactor now** → Invoke `/prizmkit-plan` with goals → `/prizmkit-implement` → `/prizmkit-code-review` → `/prizmkit-committer` → `/prizmkit-retrospective`. **End workflow** — skip Phase 2/3/4.
316
+ - **Add to refactor list** → Continue to Phase 2 (Plan via pipeline)
317
+
318
+ **NEVER proceed without explicit user confirmation via `AskUserQuestion`. Do NOT render options as plain text — the user must be able to click/select.**
319
+
320
+ **CHECKPOINT CP-RW-0.5**: Approach selected by user (fast path or pipeline).
321
+
322
+ ---
323
+
260
324
  ## Phase 2: Plan
261
325
 
262
326
  **Goal**: Generate structured .prizmkit/plans/refactor-list.json from the clarified refactoring goals.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "prizmkit",
3
- "version": "1.1.25",
3
+ "version": "1.1.26",
4
4
  "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
5
5
  "type": "module",
6
6
  "bin": {