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.
- package/bundled/VERSION.json +3 -3
- package/bundled/adapters/claude/settings-adapter.js +4 -4
- package/bundled/adapters/codebuddy/settings-adapter.js +1 -1
- package/bundled/agents/prizm-dev-team-critic.md +9 -9
- package/bundled/agents/prizm-dev-team-dev.md +13 -13
- package/bundled/agents/prizm-dev-team-reviewer.md +2 -2
- package/bundled/dev-pipeline/.env.example +6 -6
- package/bundled/dev-pipeline/README.md +32 -32
- package/bundled/dev-pipeline/assets/prizm-dev-team-integration.md +1 -1
- package/bundled/dev-pipeline/launch-bugfix-daemon.sh +6 -3
- package/bundled/dev-pipeline/launch-feature-daemon.sh +6 -3
- package/bundled/dev-pipeline/launch-refactor-daemon.sh +6 -3
- package/bundled/dev-pipeline/lib/common.sh +36 -7
- package/bundled/dev-pipeline/reset-bug.sh +9 -7
- package/bundled/dev-pipeline/reset-feature.sh +9 -7
- package/bundled/dev-pipeline/reset-refactor.sh +9 -7
- package/bundled/dev-pipeline/run-bugfix.sh +25 -24
- package/bundled/dev-pipeline/run-feature.sh +29 -32
- package/bundled/dev-pipeline/run-recovery.sh +22 -4
- package/bundled/dev-pipeline/run-refactor.sh +27 -28
- package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +14 -14
- package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +9 -4
- package/bundled/dev-pipeline/scripts/generate-recovery-prompt.py +18 -12
- package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +9 -4
- package/bundled/dev-pipeline/scripts/parse-stream-progress.py +1 -1
- package/bundled/dev-pipeline/scripts/update-bug-status.py +9 -1
- package/bundled/dev-pipeline/scripts/update-feature-status.py +13 -1
- package/bundled/dev-pipeline/scripts/update-refactor-status.py +9 -1
- package/bundled/dev-pipeline/templates/agent-prompts/critic-plan-challenge.md +1 -1
- package/bundled/dev-pipeline/templates/bootstrap-prompt.md +2 -2
- package/bundled/dev-pipeline/templates/bootstrap-tier1.md +8 -8
- package/bundled/dev-pipeline/templates/bootstrap-tier2.md +11 -11
- package/bundled/dev-pipeline/templates/bootstrap-tier3.md +9 -9
- package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +6 -6
- package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +3 -3
- package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +5 -5
- package/bundled/dev-pipeline/templates/sections/phase-commit.md +6 -6
- package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-base.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +2 -2
- package/bundled/dev-pipeline/templates/sections/phase0-init.md +1 -1
- package/bundled/dev-pipeline/tests/test-path-resolution.sh +100 -0
- package/bundled/rules/USAGE.md +2 -2
- package/bundled/rules/_rules-metadata.json +1 -1
- package/bundled/rules/prizm/prizm-commit-workflow.md +1 -1
- package/bundled/rules/prizm/prizm-documentation.md +4 -4
- package/bundled/rules/prizm/prizm-progressive-loading.md +3 -3
- package/bundled/skills/_metadata.json +4 -4
- package/bundled/skills/app-planner/SKILL.md +35 -7
- package/bundled/skills/bug-fix-workflow/SKILL.md +6 -6
- package/bundled/skills/bug-planner/SKILL.md +5 -5
- package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +21 -21
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +21 -21
- package/bundled/skills/feature-planner/SKILL.md +5 -5
- package/bundled/skills/feature-workflow/SKILL.md +8 -8
- package/bundled/skills/prizm-kit/SKILL.md +10 -10
- package/bundled/skills/prizmkit-committer/SKILL.md +2 -2
- package/bundled/skills/prizmkit-implement/SKILL.md +2 -2
- package/bundled/skills/prizmkit-init/SKILL.md +17 -18
- package/bundled/skills/prizmkit-plan/SKILL.md +3 -3
- package/bundled/skills/prizmkit-plan/references/verification-checklist.md +2 -2
- package/bundled/skills/prizmkit-prizm-docs/SKILL.md +17 -17
- package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +45 -45
- package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +9 -9
- package/bundled/skills/prizmkit-prizm-docs/references/op-rebuild.md +1 -1
- package/bundled/skills/prizmkit-prizm-docs/references/op-status.md +2 -2
- package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +3 -3
- package/bundled/skills/prizmkit-prizm-docs/references/op-validate.md +1 -1
- package/bundled/skills/prizmkit-retrospective/SKILL.md +10 -10
- package/bundled/skills/prizmkit-retrospective/references/knowledge-injection-steps.md +3 -3
- package/bundled/skills/prizmkit-retrospective/references/structural-sync-steps.md +1 -1
- package/bundled/skills/recovery-workflow/SKILL.md +15 -15
- package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -1
- package/bundled/skills/refactor-pipeline-launcher/SKILL.md +21 -21
- package/bundled/skills/refactor-planner/SKILL.md +6 -6
- package/bundled/skills/refactor-workflow/SKILL.md +9 -9
- package/bundled/team/prizm-dev-team.json +1 -1
- package/bundled/templates/hooks/commit-intent.json +2 -2
- package/bundled/templates/hooks/diff-prizm-docs.sh +8 -8
- package/bundled/templates/hooks/prizm-pre-commit.sh +4 -4
- package/bundled/templates/hooks/validate-prizm-docs.sh +4 -4
- package/bundled/templates/project-memory-template.md +4 -4
- package/package.json +1 -1
- package/src/clean.js +1 -3
- package/src/config.js +1 -1
- package/src/gitignore-template.js +4 -59
- package/src/scaffold.js +12 -11
- 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
|
|
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
|
|
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
|
|
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) —
|
|
15
|
-
2. **Background daemon** —
|
|
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
|
|
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
|
|
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) —
|
|
15
|
-
2. **Background daemon** —
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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
|
|