prizmkit 1.1.42 → 1.1.47

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 (88) hide show
  1. package/bundled/VERSION.json +3 -3
  2. package/bundled/adapters/claude/settings-adapter.js +4 -4
  3. package/bundled/adapters/codebuddy/settings-adapter.js +1 -1
  4. package/bundled/agents/prizm-dev-team-critic.md +9 -9
  5. package/bundled/agents/prizm-dev-team-dev.md +13 -13
  6. package/bundled/agents/prizm-dev-team-reviewer.md +2 -2
  7. package/bundled/dev-pipeline/.env.example +6 -6
  8. package/bundled/dev-pipeline/README.md +32 -32
  9. package/bundled/dev-pipeline/assets/prizm-dev-team-integration.md +1 -1
  10. package/bundled/dev-pipeline/launch-bugfix-daemon.sh +6 -3
  11. package/bundled/dev-pipeline/launch-feature-daemon.sh +6 -3
  12. package/bundled/dev-pipeline/launch-refactor-daemon.sh +6 -3
  13. package/bundled/dev-pipeline/lib/common.sh +36 -7
  14. package/bundled/dev-pipeline/reset-bug.sh +9 -7
  15. package/bundled/dev-pipeline/reset-feature.sh +9 -7
  16. package/bundled/dev-pipeline/reset-refactor.sh +9 -7
  17. package/bundled/dev-pipeline/run-bugfix.sh +25 -24
  18. package/bundled/dev-pipeline/run-feature.sh +29 -32
  19. package/bundled/dev-pipeline/run-recovery.sh +22 -4
  20. package/bundled/dev-pipeline/run-refactor.sh +27 -28
  21. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +14 -14
  22. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +9 -4
  23. package/bundled/dev-pipeline/scripts/generate-recovery-prompt.py +18 -12
  24. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +9 -4
  25. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +1 -1
  26. package/bundled/dev-pipeline/scripts/update-bug-status.py +9 -1
  27. package/bundled/dev-pipeline/scripts/update-feature-status.py +13 -1
  28. package/bundled/dev-pipeline/scripts/update-refactor-status.py +9 -1
  29. package/bundled/dev-pipeline/templates/agent-prompts/critic-plan-challenge.md +1 -1
  30. package/bundled/dev-pipeline/templates/bootstrap-prompt.md +2 -2
  31. package/bundled/dev-pipeline/templates/bootstrap-tier1.md +8 -8
  32. package/bundled/dev-pipeline/templates/bootstrap-tier2.md +11 -11
  33. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +9 -9
  34. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +6 -6
  35. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +3 -3
  36. package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +5 -5
  37. package/bundled/dev-pipeline/templates/sections/phase-commit.md +6 -6
  38. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +1 -1
  39. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-base.md +1 -1
  40. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +2 -2
  41. package/bundled/dev-pipeline/templates/sections/phase0-init.md +1 -1
  42. package/bundled/dev-pipeline/tests/test-path-resolution.sh +100 -0
  43. package/bundled/rules/USAGE.md +2 -2
  44. package/bundled/rules/_rules-metadata.json +1 -1
  45. package/bundled/rules/prizm/prizm-commit-workflow.md +1 -1
  46. package/bundled/rules/prizm/prizm-documentation.md +4 -4
  47. package/bundled/rules/prizm/prizm-progressive-loading.md +3 -3
  48. package/bundled/skills/_metadata.json +4 -4
  49. package/bundled/skills/app-planner/SKILL.md +35 -7
  50. package/bundled/skills/bug-fix-workflow/SKILL.md +6 -6
  51. package/bundled/skills/bug-planner/SKILL.md +5 -5
  52. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +21 -21
  53. package/bundled/skills/feature-pipeline-launcher/SKILL.md +21 -21
  54. package/bundled/skills/feature-planner/SKILL.md +5 -5
  55. package/bundled/skills/feature-workflow/SKILL.md +8 -8
  56. package/bundled/skills/prizm-kit/SKILL.md +10 -10
  57. package/bundled/skills/prizmkit-committer/SKILL.md +2 -2
  58. package/bundled/skills/prizmkit-implement/SKILL.md +2 -2
  59. package/bundled/skills/prizmkit-init/SKILL.md +17 -18
  60. package/bundled/skills/prizmkit-plan/SKILL.md +3 -3
  61. package/bundled/skills/prizmkit-plan/references/verification-checklist.md +2 -2
  62. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +17 -17
  63. package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +45 -45
  64. package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +9 -9
  65. package/bundled/skills/prizmkit-prizm-docs/references/op-rebuild.md +1 -1
  66. package/bundled/skills/prizmkit-prizm-docs/references/op-status.md +2 -2
  67. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +3 -3
  68. package/bundled/skills/prizmkit-prizm-docs/references/op-validate.md +1 -1
  69. package/bundled/skills/prizmkit-retrospective/SKILL.md +10 -10
  70. package/bundled/skills/prizmkit-retrospective/references/knowledge-injection-steps.md +3 -3
  71. package/bundled/skills/prizmkit-retrospective/references/structural-sync-steps.md +1 -1
  72. package/bundled/skills/recovery-workflow/SKILL.md +15 -15
  73. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -1
  74. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +21 -21
  75. package/bundled/skills/refactor-planner/SKILL.md +6 -6
  76. package/bundled/skills/refactor-workflow/SKILL.md +9 -9
  77. package/bundled/team/prizm-dev-team.json +1 -1
  78. package/bundled/templates/hooks/commit-intent.json +2 -2
  79. package/bundled/templates/hooks/diff-prizm-docs.sh +8 -8
  80. package/bundled/templates/hooks/prizm-pre-commit.sh +4 -4
  81. package/bundled/templates/hooks/validate-prizm-docs.sh +4 -4
  82. package/bundled/templates/project-memory-template.md +4 -4
  83. package/package.json +1 -1
  84. package/src/clean.js +1 -3
  85. package/src/config.js +1 -1
  86. package/src/gitignore-template.js +4 -59
  87. package/src/scaffold.js +12 -11
  88. package/src/upgrade.js +3 -3
@@ -107,13 +107,13 @@ Gather project metadata from the project's own configuration and documentation
107
107
 
108
108
  1. **Identify project**: Read project name and description from these sources (first match wins):
109
109
  - `.prizmkit/config.json` (`project_name`, `description` fields)
110
- - `.prizm-docs/root.prizm` (project overview section)
110
+ - `.prizmkit/prizm-docs/root.prizm` (project overview section)
111
111
  - `CLAUDE.md` or `CODEBUDDY.md` (project instructions)
112
112
  - `package.json` / `pyproject.toml` / `Cargo.toml` (name + description fields)
113
113
  - If none found, ask the user
114
114
  2. **Identify tech stack**: Read from these sources (first match wins):
115
115
  - `.prizmkit/config.json` `tech_stack` (preferred — contains language, frameworks, DB, etc.)
116
- - `.prizm-docs/root.prizm` (architecture section)
116
+ - `.prizmkit/prizm-docs/root.prizm` (architecture section)
117
117
  - Auto-detect from project files (`package.json`, `requirements.txt`, `go.mod`, etc.)
118
118
  - If none found, ask the user
119
119
  3. **Identify testing framework**: Read from `.prizmkit/config.json` `tech_stack.testing`, or auto-detect from package.json/requirements.txt/etc., or ask user
@@ -223,7 +223,7 @@ Only proceed to Phase 5 after user confirms.
223
223
 
224
224
  ### Phase 5: Generate & Validate
225
225
 
226
- 1. **Generate `.prizmkit/plans/bug-fix-list.json`**: Conform to `dev-pipeline/templates/bug-fix-list-schema.json`
226
+ 1. **Generate `.prizmkit/plans/bug-fix-list.json`**: Conform to `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`
227
227
  2. **Validate against schema**: Run `python3 ${SKILL_DIR}/scripts/validate-bug-list.py .prizmkit/plans/bug-fix-list.json --feature-list .prizmkit/plans/feature-list.json`. If the script is unavailable, use the checklist in `${SKILL_DIR}/references/schema-validation.md`.
228
228
  3. **Write file** to `.prizmkit/plans/` (or user-specified path)
229
229
  4. **Output**: File path, summary, and next steps
@@ -287,7 +287,7 @@ Batch-parse failed test output:
287
287
  Validate existing `.prizmkit/plans/bug-fix-list.json`:
288
288
 
289
289
  1. Check JSON syntax
290
- 2. Validate against `dev-pipeline/templates/bug-fix-list-schema.json`
290
+ 2. Validate against `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`
291
291
  3. Check for:
292
292
  - Duplicate IDs
293
293
  - Missing required fields
@@ -351,6 +351,6 @@ Common errors handled inline:
351
351
 
352
352
  ## Output
353
353
 
354
- - `.prizmkit/plans/bug-fix-list.json` conforming to `dev-pipeline/templates/bug-fix-list-schema.json`
354
+ - `.prizmkit/plans/bug-fix-list.json` conforming to `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`
355
355
  - Validation report (if validation run)
356
356
  - Summary report (if summary run)
@@ -11,8 +11,8 @@ Launch the autonomous bug fix pipeline from within an AI CLI conversation. Suppo
11
11
 
12
12
  Three execution modes are available. The user chooses one before configuring other options:
13
13
 
14
- 1. **Foreground** (recommended) — `dev-pipeline/run-bugfix.sh run`. Visible output, direct error feedback, no orphaned processes.
15
- 2. **Background daemon** — `dev-pipeline/launch-bugfix-daemon.sh`. Runs fully detached, survives AI CLI session closure.
14
+ 1. **Foreground** (recommended) — `.prizmkit/dev-pipeline/run-bugfix.sh run`. Visible output, direct error feedback, no orphaned processes.
15
+ 2. **Background daemon** — `.prizmkit/dev-pipeline/launch-bugfix-daemon.sh`. Runs fully detached, survives AI CLI session closure.
16
16
  3. **Manual** — Display the assembled command(s) only. Do not execute anything. User runs them on their own.
17
17
 
18
18
  **Background mode documentation**: When the user chooses background/daemon mode, record the choice and PID in `.prizmkit/bugfix-pipeline-run.log` (append-only) with timestamp, so the decision is traceable:
@@ -47,7 +47,7 @@ Three execution modes are available. The user chooses one before configuring oth
47
47
 
48
48
  Before any action, validate:
49
49
 
50
- 1. **bugfix pipeline exists**: Confirm `dev-pipeline/launch-bugfix-daemon.sh` and `dev-pipeline/run-bugfix.sh` are present and executable
50
+ 1. **bugfix pipeline exists**: Confirm `.prizmkit/dev-pipeline/launch-bugfix-daemon.sh` and `.prizmkit/dev-pipeline/run-bugfix.sh` are present and executable
51
51
  2. **For start**: `.prizmkit/plans/bug-fix-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
52
52
  3. **Dependencies**: `jq`, `python3`, AI CLI (`cbc` or `claude`) must be in PATH
53
53
  4. **Browser tools** (optional): If any bug has `browser_interaction` field, check the corresponding tool is available. Bugs may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
@@ -80,7 +80,7 @@ Detect user intent from their message, then follow the corresponding workflow:
80
80
 
81
81
  2. **Check not already running**:
82
82
  ```bash
83
- dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null
83
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null
84
84
  ```
85
85
  If running, inform user and ask: "Bugfix pipeline is already running. Want to restart it, check status, or view logs?"
86
86
 
@@ -106,7 +106,7 @@ Detect user intent from their message, then follow the corresponding workflow:
106
106
  ```
107
107
  If pipeline state already exists, use the status command instead:
108
108
  ```bash
109
- python3 dev-pipeline/scripts/update-bug-status.py \
109
+ python3 .prizmkit/dev-pipeline/scripts/update-bug-status.py \
110
110
  --bug-list .prizmkit/plans/bug-fix-list.json \
111
111
  --state-dir .prizmkit/state/bugfix \
112
112
  --action status 2>/dev/null
@@ -196,34 +196,34 @@ Detect user intent from their message, then follow the corresponding workflow:
196
196
 
197
197
  **Foreground command:**
198
198
  ```bash
199
- VERBOSE=1 dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
199
+ VERBOSE=1 .prizmkit/dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
200
200
  ```
201
201
  With all options:
202
202
  ```bash
203
203
  VERBOSE=1 MAX_RETRIES=5 SESSION_TIMEOUT=3600 ENABLE_DEPLOY=1 \
204
- dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
204
+ .prizmkit/dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
205
205
  ```
206
206
 
207
207
  **Background daemon command:**
208
208
  ```bash
209
- dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json --env "VERBOSE=1"
209
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json --env "VERBOSE=1"
210
210
  ```
211
211
  With all options:
212
212
  ```bash
213
- dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json \
213
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json \
214
214
  --env "VERBOSE=1 MAX_RETRIES=5 ENABLE_DEPLOY=1"
215
215
  ```
216
216
 
217
217
  **Manual mode**: Print the assembled command(s) and **stop here**. Do not execute anything. Do not proceed to step 7.
218
218
  ```
219
219
  # To run in foreground:
220
- VERBOSE=1 dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
220
+ VERBOSE=1 .prizmkit/dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
221
221
 
222
222
  # To run in background (detached):
223
- dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json --env "VERBOSE=1"
223
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json --env "VERBOSE=1"
224
224
 
225
225
  # To check status:
226
- dev-pipeline/run-bugfix.sh status .prizmkit/plans/bug-fix-list.json
226
+ .prizmkit/dev-pipeline/run-bugfix.sh status .prizmkit/plans/bug-fix-list.json
227
227
  ```
228
228
 
229
229
  7. **Confirm and launch** (Foreground and Background only — Manual mode ends at step 6):
@@ -237,12 +237,12 @@ Detect user intent from their message, then follow the corresponding workflow:
237
237
  **If foreground**: Pipeline runs to completion in the terminal. After it finishes:
238
238
  - Summarize results: total bugs, fixed, failed, skipped
239
239
  - If all fixed: each bug session has already run `prizmkit-retrospective` internally (structural sync by default; full retrospective when the fix changed interfaces, dependencies, or observable behavior). Ask user what's next.
240
- - If some failed: show failed bug IDs and suggest `dev-pipeline/reset-bug.sh <B-XXX> --clean --run` for a fresh retry
240
+ - If some failed: show failed bug IDs and suggest `.prizmkit/dev-pipeline/reset-bug.sh <B-XXX> --clean --run` for a fresh retry
241
241
 
242
242
  **If background daemon**:
243
243
  1. Verify launch:
244
244
  ```bash
245
- dev-pipeline/launch-bugfix-daemon.sh status
245
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh status
246
246
  ```
247
247
  2. Start log monitoring — Use the Bash tool with `run_in_background: true`:
248
248
  ```bash
@@ -260,12 +260,12 @@ Detect user intent from their message, then follow the corresponding workflow:
260
260
 
261
261
  1. **Check daemon status**:
262
262
  ```bash
263
- dev-pipeline/launch-bugfix-daemon.sh status
263
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh status
264
264
  ```
265
265
 
266
266
  2. **Show bug-level progress**:
267
267
  ```bash
268
- python3 dev-pipeline/scripts/update-bug-status.py \
268
+ python3 .prizmkit/dev-pipeline/scripts/update-bug-status.py \
269
269
  --bug-list .prizmkit/plans/bug-fix-list.json \
270
270
  --state-dir .prizmkit/state/bugfix \
271
271
  --action status
@@ -284,12 +284,12 @@ Detect user intent from their message, then follow the corresponding workflow:
284
284
 
285
285
  1. **Stop the daemon**:
286
286
  ```bash
287
- dev-pipeline/launch-bugfix-daemon.sh stop
287
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh stop
288
288
  ```
289
289
 
290
290
  2. **Verify stopped**:
291
291
  ```bash
292
- dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null || true
292
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null || true
293
293
  ```
294
294
 
295
295
  3. **Inform user**: "Bugfix pipeline stopped. State is preserved -- you can resume later with 'start bug fix' and it will pick up where it left off."
@@ -300,7 +300,7 @@ Detect user intent from their message, then follow the corresponding workflow:
300
300
 
301
301
  1. **Check if running**:
302
302
  ```bash
303
- dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null
303
+ .prizmkit/dev-pipeline/launch-bugfix-daemon.sh status 2>/dev/null
304
304
  ```
305
305
 
306
306
  2. **If running** -- Start live tail with Bash tool `run_in_background: true`:
@@ -328,7 +328,7 @@ Detect user intent from their message, then follow the corresponding workflow:
328
328
  When user says "retry B-001":
329
329
 
330
330
  ```bash
331
- dev-pipeline/reset-bug.sh B-001 --clean --run .prizmkit/plans/bug-fix-list.json
331
+ .prizmkit/dev-pipeline/reset-bug.sh B-001 --clean --run .prizmkit/plans/bug-fix-list.json
332
332
  ```
333
333
 
334
334
  **Note:** `reset-bug.sh --clean --run` performs a full clean (deletes session history and artifacts) before retrying — this gives a fresh start.
@@ -347,7 +347,7 @@ dev-pipeline/reset-bug.sh B-001 --clean --run .prizmkit/plans/bug-fix-list.json
347
347
  | `playwright-cli` not installed | Browser verification skipped for playwright bugs (non-blocking). Suggest: `npm install -g @playwright/cli@latest && playwright-cli install --skills` |
348
348
  | `opencli` not installed | Browser verification skipped for opencli bugs (non-blocking). Install opencli for Chrome session-based browser verification |
349
349
  | Deploy session failed | Pipeline completed but deploy session exited non-zero. Check `.prizmkit/state/bugfix/deploy/<session_id>/logs/session.log`. Retry manually: `/prizmkit-deploy`. |
350
- | Permission denied on script | Run `chmod +x dev-pipeline/launch-bugfix-daemon.sh dev-pipeline/run-bugfix.sh` |
350
+ | Permission denied on script | Run `chmod +x .prizmkit/dev-pipeline/launch-bugfix-daemon.sh .prizmkit/dev-pipeline/run-bugfix.sh` |
351
351
 
352
352
  ### Integration Notes
353
353
 
@@ -11,8 +11,8 @@ Launch the autonomous development pipeline from within an AI CLI conversation. T
11
11
 
12
12
  Three execution modes are available. The user chooses one before configuring other options:
13
13
 
14
- 1. **Foreground** (recommended) — `dev-pipeline/run-feature.sh run`. Visible output, direct error feedback, no orphaned processes.
15
- 2. **Background daemon** — `dev-pipeline/launch-feature-daemon.sh`. Runs fully detached, survives AI CLI session closure.
14
+ 1. **Foreground** (recommended) — `.prizmkit/dev-pipeline/run-feature.sh run`. Visible output, direct error feedback, no orphaned processes.
15
+ 2. **Background daemon** — `.prizmkit/dev-pipeline/launch-feature-daemon.sh`. Runs fully detached, survives AI CLI session closure.
16
16
  3. **Manual** — Display the assembled command(s) only. Do not execute anything. User runs them on their own.
17
17
 
18
18
  ### When to Use
@@ -48,7 +48,7 @@ Three execution modes are available. The user chooses one before configuring oth
48
48
 
49
49
  Before any action, validate:
50
50
 
51
- 1. **dev-pipeline exists**: Confirm `dev-pipeline/launch-feature-daemon.sh` is present and executable
51
+ 1. **dev-pipeline exists**: Confirm `.prizmkit/dev-pipeline/launch-feature-daemon.sh` is present and executable
52
52
  2. **For start**: `.prizmkit/plans/feature-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
53
53
  3. **Dependencies**: `jq`, `python3`, AI CLI (`cbc` or `claude`) must be in PATH
54
54
  4. **Python version**: Requires Python 3.8+ for dev-pipeline scripts
@@ -82,7 +82,7 @@ Detect user intent from their message, then follow the corresponding workflow:
82
82
 
83
83
  2. **Check not already running**:
84
84
  ```bash
85
- dev-pipeline/launch-feature-daemon.sh status 2>/dev/null
85
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status 2>/dev/null
86
86
  ```
87
87
  If running, inform user and ask: "Pipeline is already running. Want to restart it, check status, or view logs?"
88
88
 
@@ -100,7 +100,7 @@ Detect user intent from their message, then follow the corresponding workflow:
100
100
  ```
101
101
  If pipeline state already exists, use the status command instead:
102
102
  ```bash
103
- python3 dev-pipeline/scripts/update-feature-status.py \
103
+ python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \
104
104
  --feature-list .prizmkit/plans/feature-list.json \
105
105
  --state-dir .prizmkit/state/features \
106
106
  --action status 2>/dev/null
@@ -216,34 +216,34 @@ Detect user intent from their message, then follow the corresponding workflow:
216
216
 
217
217
  **Foreground command:**
218
218
  ```bash
219
- VERBOSE=1 dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
219
+ VERBOSE=1 .prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
220
220
  ```
221
221
  With all options:
222
222
  ```bash
223
223
  VERBOSE=1 ENABLE_CRITIC=true MAX_RETRIES=5 SESSION_TIMEOUT=3600 ENABLE_DEPLOY=1 \
224
- dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json --features F-001:F-005
224
+ .prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json --features F-001:F-005
225
225
  ```
226
226
 
227
227
  **Background daemon command:**
228
228
  ```bash
229
- dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --env "VERBOSE=1"
229
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --env "VERBOSE=1"
230
230
  ```
231
231
  With all options:
232
232
  ```bash
233
- dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --features F-001:F-005 \
233
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --features F-001:F-005 \
234
234
  --env "VERBOSE=1 ENABLE_CRITIC=true MAX_RETRIES=5 ENABLE_DEPLOY=1"
235
235
  ```
236
236
 
237
237
  **Manual mode**: Print the assembled command(s) and **stop here**. Do not execute anything. Do not proceed to step 8.
238
238
  ```
239
239
  # To run in foreground:
240
- VERBOSE=1 dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
240
+ VERBOSE=1 .prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
241
241
 
242
242
  # To run in background (detached):
243
- dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --env "VERBOSE=1"
243
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json --env "VERBOSE=1"
244
244
 
245
245
  # To check status:
246
- dev-pipeline/run-feature.sh status .prizmkit/plans/feature-list.json
246
+ .prizmkit/dev-pipeline/run-feature.sh status .prizmkit/plans/feature-list.json
247
247
  ```
248
248
 
249
249
  8. **Confirm and launch** (Foreground and Background only — Manual mode ends at step 7):
@@ -263,7 +263,7 @@ Detect user intent from their message, then follow the corresponding workflow:
263
263
  **If background daemon**:
264
264
  1. Verify launch:
265
265
  ```bash
266
- dev-pipeline/launch-feature-daemon.sh status
266
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status
267
267
  ```
268
268
  2. Start log monitoring — Use the Bash tool with `run_in_background: true`:
269
269
  ```bash
@@ -281,12 +281,12 @@ Detect user intent from their message, then follow the corresponding workflow:
281
281
 
282
282
  1. **Check daemon status**:
283
283
  ```bash
284
- dev-pipeline/launch-feature-daemon.sh status
284
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status
285
285
  ```
286
286
 
287
287
  2. **Show feature-level progress**:
288
288
  ```bash
289
- python3 dev-pipeline/scripts/update-feature-status.py \
289
+ python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \
290
290
  --feature-list .prizmkit/plans/feature-list.json \
291
291
  --state-dir .prizmkit/state/features \
292
292
  --action status
@@ -305,12 +305,12 @@ Detect user intent from their message, then follow the corresponding workflow:
305
305
 
306
306
  1. **Stop the daemon**:
307
307
  ```bash
308
- dev-pipeline/launch-feature-daemon.sh stop
308
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh stop
309
309
  ```
310
310
 
311
311
  2. **Verify stopped**:
312
312
  ```bash
313
- dev-pipeline/launch-feature-daemon.sh status 2>/dev/null || true
313
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status 2>/dev/null || true
314
314
  ```
315
315
 
316
316
  3. **Inform user**: "Pipeline stopped. State is preserved -- you can resume later with 'start pipeline' and it will pick up where it left off."
@@ -321,7 +321,7 @@ Detect user intent from their message, then follow the corresponding workflow:
321
321
 
322
322
  1. **Check if running**:
323
323
  ```bash
324
- dev-pipeline/launch-feature-daemon.sh status 2>/dev/null
324
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status 2>/dev/null
325
325
  ```
326
326
 
327
327
  2. **If running** -- Start live tail with Bash tool `run_in_background: true`:
@@ -349,7 +349,7 @@ Detect user intent from their message, then follow the corresponding workflow:
349
349
  When user says "retry F-003" or "clean retry F-003":
350
350
 
351
351
  ```bash
352
- dev-pipeline/reset-feature.sh F-003 --clean --run .prizmkit/plans/feature-list.json
352
+ .prizmkit/dev-pipeline/reset-feature.sh F-003 --clean --run .prizmkit/plans/feature-list.json
353
353
  ```
354
354
 
355
355
  Notes:
@@ -406,10 +406,10 @@ After pipeline completion, if features have `browser_interaction` fields and the
406
406
  | PID file stale (process dead) | `launch-feature-daemon.sh` auto-cleans, retry start |
407
407
  | Launch failed (process died immediately) | Show last 20 lines of log: `tail -20 .prizmkit/state/features/pipeline-daemon.log` |
408
408
  | Feature stuck/blocked | Use `reset-feature.sh <F-XXX> --clean --run` for a fresh retry |
409
- | All features blocked/failed | Show status, suggest daemon-safe recovery: `dev-pipeline/reset-feature.sh <F-XXX> --clean --run .prizmkit/plans/feature-list.json` |
409
+ | All features blocked/failed | Show status, suggest daemon-safe recovery: `.prizmkit/dev-pipeline/reset-feature.sh <F-XXX> --clean --run .prizmkit/plans/feature-list.json` |
410
410
  | `playwright-cli` not installed | Browser verification skipped for playwright features (non-blocking). Suggest: `npm install -g @playwright/cli@latest && playwright-cli install --skills` |
411
411
  | `opencli` not installed | Browser verification skipped for opencli features (non-blocking). Install opencli for Chrome session-based browser verification |
412
- | Permission denied on script | Run `chmod +x dev-pipeline/launch-feature-daemon.sh dev-pipeline/run-feature.sh` |
412
+ | Permission denied on script | Run `chmod +x .prizmkit/dev-pipeline/launch-feature-daemon.sh .prizmkit/dev-pipeline/run-feature.sh` |
413
413
  | Pipeline stop failed (process won't die) | Process may be stuck in I/O wait. Try `kill -9 <PID>` manually. Check for orphaned child processes with `ps aux \| grep claude` |
414
414
  | Deploy session failed | Pipeline completed but deploy session exited non-zero. Check `.prizmkit/state/features/deploy/<session_id>/logs/session.log`. Retry manually: `/prizmkit-deploy`. |
415
415
  | `.env.local` missing or incomplete | Warn: database connection variables not found. Suggest creating env file with required connection variables for the project's database |
@@ -107,12 +107,12 @@ Do NOT use this skill when:
107
107
  ## Prerequisites
108
108
 
109
109
  Before questions, check optional context files (never block if absent):
110
- - `.prizm-docs/root.prizm` (architecture/project context — typically created by app-planner with captured decisions)
110
+ - `.prizmkit/prizm-docs/root.prizm` (architecture/project context — typically created by app-planner with captured decisions)
111
111
  - `.prizmkit/config.json` (existing stack preferences and detected tech stack)
112
112
  - `.prizmkit/plans/project-brief.md` (project context from app-planner, if available)
113
113
  - existing `.prizmkit/plans/feature-list.json` (required for incremental mode)
114
114
  - `CLAUDE.md` / `CODEBUDDY.md`
115
- - If `.prizm-docs/root.prizm` is absent and the project has existing source code, scan the directory structure to understand the codebase layout:
115
+ - If `.prizmkit/prizm-docs/root.prizm` is absent and the project has existing source code, scan the directory structure to understand the codebase layout:
116
116
  ```bash
117
117
  find . -maxdepth 2 -type d -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/__pycache__/*' -not -path '*/vendor/*' | sed -e 's;[^/]*/;|____;g;s;____|; |;g'
118
118
  ```
@@ -144,7 +144,7 @@ The `global_context` object in `.prizmkit/plans/feature-list.json` provides tech
144
144
  - `language`, `frontend_framework`, `backend_framework`, `database`, `testing_strategy` (all recommended)
145
145
  - Additional: `frontend_styling`, `orm`, `bundler`, `runtime`
146
146
 
147
- All `global_context` fields are optional — including recommended fields improves downstream code generation quality. See `dev-pipeline/templates/feature-list-schema.json` for the full schema definition.
147
+ All `global_context` fields are optional — including recommended fields improves downstream code generation quality. See `.prizmkit/dev-pipeline/templates/feature-list-schema.json` for the full schema definition.
148
148
 
149
149
 
150
150
  ---
@@ -183,7 +183,7 @@ Execute the planning workflow in conversation mode with mandatory checkpoints:
183
183
  > "Do you have any reference materials I should review before planning? This can include:
184
184
  > - **Code paths** — files or directories I should read to understand existing implementation
185
185
  > - **Documents** — design docs, PRDs, API specs, architecture proposals, or internal wiki pages
186
- > - **Knowledge docs** — `.prizm-docs/` files, README files, or project-specific documentation
186
+ > - **Knowledge docs** — `.prizmkit/prizm-docs/` files, README files, or project-specific documentation
187
187
  > - **Images** — wireframes, mockups, architecture diagrams, or screenshots
188
188
  > - **Web links** — reference implementations, API documentation pages, or relevant articles
189
189
  >
@@ -291,7 +291,7 @@ A feature is **exempt** when ANY true:
291
291
 
292
292
  ## Output Rules
293
293
 
294
- `.prizmkit/plans/feature-list.json` must conform to `dev-pipeline/templates/feature-list-schema.json` (`$schema` = `dev-pipeline-feature-list-v1`).
294
+ `.prizmkit/plans/feature-list.json` must conform to `.prizmkit/dev-pipeline/templates/feature-list-schema.json` (`$schema` = `dev-pipeline-feature-list-v1`).
295
295
 
296
296
  Key requirements:
297
297
  - non-empty `features` array
@@ -124,7 +124,7 @@ Ask the user to describe what they want to build. Listen for:
124
124
  Ask:
125
125
  1. **Existing code** — "Is there existing code I should look at? Which files or directories are relevant?"
126
126
  2. **Design documents** — "Do you have any design docs, wireframes, API specs, or PRDs I should read?"
127
- 3. **Knowledge docs** — "Are there related `.prizm-docs/`, README files, or internal wiki pages?"
127
+ 3. **Knowledge docs** — "Are there related `.prizmkit/prizm-docs/`, README files, or internal wiki pages?"
128
128
  4. **Reference projects** — "Any reference implementations or similar projects I should look at for inspiration?"
129
129
 
130
130
  Record everything the user provides — these become inputs for Step 1.3.
@@ -139,7 +139,7 @@ Record everything the user provides — these become inputs for Step 1.3.
139
139
  |-------|-------------|---------|
140
140
  | Agent A | User-provided code paths — read existing source files | Understand current architecture, patterns, conventions |
141
141
  | Agent B | User-provided documents — design docs, specs, PRDs | Understand intended requirements and constraints |
142
- | Agent C | `.prizm-docs/` — root.prizm, L1/L2 docs, TRAPS, RULES | Understand existing architecture knowledge and known pitfalls |
142
+ | Agent C | `.prizmkit/prizm-docs/` — root.prizm, L1/L2 docs, TRAPS, RULES | Understand existing architecture knowledge and known pitfalls |
143
143
  | Agent D | Database/schema files + `.prizmkit/config.json` | Understand data model and tech stack preferences |
144
144
 
145
145
  **Also gather** (can be included in any agent's task):
@@ -156,7 +156,7 @@ Record everything the user provides — these become inputs for Step 1.3.
156
156
  Present what you learned from the parallel reading:
157
157
  - Current project structure and patterns (with specific references)
158
158
  - Existing data model and schema conventions
159
- - Known TRAPS and pitfalls from `.prizm-docs/`
159
+ - Known TRAPS and pitfalls from `.prizmkit/prizm-docs/`
160
160
  - Integration points with existing modules
161
161
 
162
162
  Then ask targeted questions based on what you read. **Adapt question depth to the feature complexity** — a simple CRUD feature needs fewer questions than a real-time collaboration system.
@@ -251,7 +251,7 @@ Once brainstorming is complete, produce a structured requirements summary:
251
251
  - [Requirement]
252
252
 
253
253
  ### Reference Materials Reviewed
254
- - [List of code paths, documents, .prizm-docs/ files that were read]
254
+ - [List of code paths, documents, .prizmkit/prizm-docs/ files that were read]
255
255
 
256
256
  ### Confirmed by user: ✓
257
257
  ```
@@ -292,7 +292,7 @@ AskUserQuestion:
292
292
  2. Invoke `/prizmkit-implement` to execute the plan
293
293
  3. After implementation, run `/prizmkit-code-review` for quality check
294
294
  4. Commit via `/prizmkit-committer` with `feat(<scope>):` prefix
295
- 5. Run `/prizmkit-retrospective` to sync `.prizm-docs/`
295
+ 5. Run `/prizmkit-retrospective` to sync `.prizmkit/prizm-docs/`
296
296
  6. **End workflow** — skip Phase 2/3/4
297
297
  - **Add to feature list** → Continue to Phase 2 (Plan via pipeline)
298
298
 
@@ -392,7 +392,7 @@ AskUserQuestion:
392
392
 
393
393
  1. **Initial status check**:
394
394
  ```bash
395
- dev-pipeline/launch-feature-daemon.sh status
395
+ .prizmkit/dev-pipeline/launch-feature-daemon.sh status
396
396
  ```
397
397
 
398
398
  2. **Offer monitoring options**:
@@ -402,7 +402,7 @@ AskUserQuestion:
402
402
 
403
403
  3. **Periodic progress reports** (when user asks):
404
404
  ```bash
405
- python3 dev-pipeline/scripts/update-feature-status.py \
405
+ python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \
406
406
  --feature-list .prizmkit/plans/feature-list.json \
407
407
  --state-dir .prizmkit/state/features \
408
408
  --action status
@@ -508,4 +508,4 @@ All internal asset paths use `${SKILL_DIR}` placeholder for cross-IDE compatibil
508
508
  - Pipeline execution (Phase 3)
509
509
  - Progress updates (Phase 4)
510
510
  - Multiple git commits with `feat(<scope>):` prefix
511
- - Updated `.prizm-docs/` (via prizmkit-retrospective per feature)
511
+ - Updated `.prizmkit/prizm-docs/` (via prizmkit-retrospective per feature)
@@ -17,15 +17,15 @@ read docs → plan → implement → code-review → retrospective → committer
17
17
  Each task begins by reading context at two levels:
18
18
 
19
19
  **Application level** (read every session):
20
- - `.prizm-docs/root.prizm` — L0 project architecture index (modules, tech stack, conventions)
20
+ - `.prizmkit/prizm-docs/root.prizm` — L0 project architecture index (modules, tech stack, conventions)
21
21
  - `.prizmkit/plans/project-brief.md` — user's product vision checklist (generated by app-planner)
22
22
  - `.prizmkit/config.json` — tech stack config, deploy strategy
23
23
 
24
24
  **Task level** (read for the specific task):
25
25
  - `spec.md` / `plan.md` — task specification and implementation plan
26
- - `.prizm-docs/<module>.prizm` (L1/L2) — architecture docs for affected modules (TRAPS, DECISIONS, INTERFACES)
26
+ - `.prizmkit/prizm-docs/<module>.prizm` (L1/L2) — architecture docs for affected modules (TRAPS, DECISIONS, INTERFACES)
27
27
 
28
- Each cycle produces spec, plan, and task artifacts that create a traceable record of what was built and why. `.prizm-docs/` stays in sync through retrospective, so the next session starts with up-to-date context.
28
+ Each cycle produces spec, plan, and task artifacts that create a traceable record of what was built and why. `.prizmkit/prizm-docs/` stays in sync through retrospective, so the next session starts with up-to-date context.
29
29
 
30
30
  **Fast path** — for small, well-scoped changes, always ask user whether to use fast path:
31
31
  ```
@@ -42,13 +42,13 @@ PrizmKit supports any development scenario through the same skill chain. `/prizm
42
42
  | **Bug Fix** | `spec.md` → `plan.md` → code | Complex defects, regressions, crash fixes. Simple bugs can use fast path directly. |
43
43
  | **Refactor** | `spec.md` → `plan.md` → code | Restructure, extract, rename, performance. No behavior change. |
44
44
 
45
- All three follow the same per-task flow. Detailed documentation policies (when to update `.prizm-docs/`, when to skip steps) are defined within each skill — not here.
45
+ All three follow the same per-task flow. Detailed documentation policies (when to update `.prizmkit/prizm-docs/`, when to skip steps) are defined within each skill — not here.
46
46
 
47
47
  ### Best Practices for AI-Driven Development
48
48
 
49
49
  **Monorepo structure recommended**: Keep frontend, backend, and shared libraries in one repository. AI needs visibility into the full call chain — cross-repo references are invisible to it. If you have a multi-repo setup, add all related repos to the AI workspace so module boundaries and API contracts are discoverable.
50
50
 
51
- **Module organization**: Ensure every meaningful module has a `.prizm-docs/` L1 doc. AI reads TRAPS and DECISIONS before modifying files — undocumented modules get no guardrails.
51
+ **Module organization**: Ensure every meaningful module has a `.prizmkit/prizm-docs/` L1 doc. AI reads TRAPS and DECISIONS before modifying files — undocumented modules get no guardrails.
52
52
 
53
53
  **Small, focused tasks**: Break large features into tasks that can each be completed in one AI session. The pipeline handles this automatically via `/prizmkit-plan` task decomposition.
54
54
 
@@ -59,23 +59,23 @@ All three follow the same per-task flow. Detailed documentation policies (when t
59
59
  | `/prizmkit-plan` | Specify + plan: natural language → spec.md → plan.md + tasks | "specify", "plan", "new feature", "I want to add...", "architect", "break it down" |
60
60
  | `/prizmkit-implement` | Execute plan.md tasks, write code (TDD) | "implement", "build", "code it", "start coding" |
61
61
  | `/prizmkit-code-review` | Diagnose issues + produce Fix Instructions | "review", "check code", "is it ready to commit" |
62
- | `/prizmkit-retrospective` | Sync .prizm-docs/ with code changes | "retrospective", "retro", "sync docs", "wrap up" |
62
+ | `/prizmkit-retrospective` | Sync .prizmkit/prizm-docs/ with code changes | "retrospective", "retro", "sync docs", "wrap up" |
63
63
  | `/prizmkit-committer` | Safe git commit with Conventional Commits | "commit", "submit", "finish", "ship it" |
64
64
  | `/prizmkit-deploy` | Generate/update deployment documentation | "deploy docs", "deployment guide", "how to deploy" |
65
- | `/prizmkit-init` | Project bootstrap + .prizm-docs/ setup | "init", "initialize", "take over this project" |
65
+ | `/prizmkit-init` | Project bootstrap + .prizmkit/prizm-docs/ setup | "init", "initialize", "take over this project" |
66
66
  | `/prizmkit-prizm-docs` | Doc management (init/status/rebuild/validate) | "check docs", "rebuild docs", "validate docs" |
67
67
 
68
68
  **Reading guide**:
69
- - Need code structure/modules/interfaces/traps/decisions? → `.prizm-docs/`
69
+ - Need code structure/modules/interfaces/traps/decisions? → `.prizmkit/prizm-docs/`
70
70
 
71
71
  ## Quick Start (First-Time Setup)
72
72
 
73
73
  1. `npx prizmkit install .` → installs skills, rules (`prizm-documentation.md`, `prizm-commit-workflow.md`), hooks, platform scaffolding
74
- 2. `/prizmkit-init` → scans project code, generates `.prizm-docs/`, detects tech stack, populates `.prizmkit/config.json`
74
+ 2. `/prizmkit-init` → scans project code, generates `.prizmkit/prizm-docs/`, detects tech stack, populates `.prizmkit/config.json`
75
75
  3. `/prizmkit-plan` → specify your first feature → produces spec.md + plan.md
76
76
  4. `/prizmkit-implement` → TDD implementation following the plan
77
77
  5. `/prizmkit-code-review` → review before commit
78
- 6. `/prizmkit-retrospective` → sync `.prizm-docs/` with changes
78
+ 6. `/prizmkit-retrospective` → sync `.prizmkit/prizm-docs/` with changes
79
79
  7. `/prizmkit-committer` → safe Conventional Commit
80
80
 
81
81
  > **Note**: Rules and hooks are installed by `npx prizmkit install`, not by `/prizmkit-init`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: "prizmkit-committer"
3
- description: "Pure git commit workflow with safety checks. Stages files, generates Conventional Commits message, and commits. Does NOT modify .prizm-docs/ — run /prizmkit-retrospective first. Trigger on: 'commit', 'submit', 'finish', 'done', 'ship it'. (project)"
3
+ description: "Pure git commit workflow with safety checks. Stages files, generates Conventional Commits message, and commits. Does NOT modify .prizmkit/prizm-docs/ — run /prizmkit-retrospective first. Trigger on: 'commit', 'submit', 'finish', 'done', 'ship it'. (project)"
4
4
  ---
5
5
 
6
6
  # PrizmKit Committer
@@ -15,7 +15,7 @@ description: "Pure git commit workflow with safety checks. Stages files, generat
15
15
  | Required State | Check | If Missing |
16
16
  |---|---|---|
17
17
  | Uncommitted changes exist | `git status` shows modified/added/untracked files | Inform user "nothing to commit" and stop |
18
- | `.prizm-docs/` synced (feature/refactor) | `/prizmkit-retrospective` has run | Run `/prizmkit-retrospective` first |
18
+ | `.prizmkit/prizm-docs/` synced (feature/refactor) | `/prizmkit-retrospective` has run | Run `/prizmkit-retrospective` first |
19
19
  | Code review passed (pipeline mode) | `review-report.md` in artifact directory has `## Verdict: PASS` | Run `/prizmkit-code-review` first |
20
20
 
21
21
  ### Workflow
@@ -30,9 +30,9 @@ description: "Execute plan.md tasks with TDD approach. Respects task ordering an
30
30
  Before implementation, load context once:
31
31
 
32
32
  1. **Task context**: Read `plan.md` (including Tasks section) and `spec.md` from the artifact directory. If other companion documents exist in the directory (e.g., `refactor-analysis.md`), read them for additional context.
33
- 2. **Architecture context**: Read `.prizm-docs/root.prizm` (L0 — project overview, module index, tech stack, conventions) and relevant L1/L2 docs for affected modules. Pay special attention to TRAPS (known pitfalls) and DECISIONS (architectural choices).
33
+ 2. **Architecture context**: Read `.prizmkit/prizm-docs/root.prizm` (L0 — project overview, module index, tech stack, conventions) and relevant L1/L2 docs for affected modules. Pay special attention to TRAPS (known pitfalls) and DECISIONS (architectural choices).
34
34
 
35
- > `.prizm-docs/` uses a 3-level hierarchy: L0 (`root.prizm`) is the project-wide index. L1 (e.g., `auth.prizm`) covers a module — its key files, interfaces, dependencies, traps, and decisions. L2 is for sub-modules with their own complexity. Implement reads these docs to avoid repeating known mistakes; `/prizmkit-retrospective` is responsible for updating them after implementation.
35
+ > `.prizmkit/prizm-docs/` uses a 3-level hierarchy: L0 (`root.prizm`) is the project-wide index. L1 (e.g., `auth.prizm`) covers a module — its key files, interfaces, dependencies, traps, and decisions. L2 is for sub-modules with their own complexity. Implement reads these docs to avoid repeating known mistakes; `/prizmkit-retrospective` is responsible for updating them after implementation.
36
36
 
37
37
  ## Execution
38
38