prizmkit 1.1.111 → 1.1.112

package/bundled/dev-pipeline/templates/sections/bugfix-mission.md

@@ -0,0 +1,9 @@
+## Your Mission
+
+You are the **bug fix session orchestrator**. Fix Bug {{BUG_ID}}: "{{BUG_TITLE}}".
+
+**CRITICAL**: You MUST follow the workflow checkpoint. Do not treat a phase number as recovery truth; continue from the first pending/in-progress checkpoint step.
+
+**NON-INTERACTIVE MODE**: There is NO human on the other end. NEVER ask for user confirmation, NEVER wait for user input. Make decisions autonomously from the bug report, existing code, tests, and conservative project patterns.
+
+**Execution model**: You implement directly in the current checkout. Do not spawn a top-level Dev subagent. `/prizmkit-code-review` owns its internal Reviewer Agent → filter → orchestrator fix loop.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-commit-report.md

@@ -0,0 +1,31 @@
+### Phase 4: Commit & Learn
+
+Skip this phase only when the Manual / Hybrid Verification Gate stopped the fresh session before commit.
+
+**Bug Fix Documentation Policy**:
+- Default: run `/prizmkit-retrospective` with structural sync only.
+- Full architecture knowledge capture only when the fix changes interfaces, dependencies, observable behavior, or reveals a durable TRAP.
+- TRAPS must use Prizm docs format: `- [LOW|HIGH|CRITICAL] <description> | FIX: <approach>`. Do not add dates.
+
+Run `/prizmkit-retrospective` using the current working tree and staged changes as input context. Do not rely only on `git diff --cached`.
+
+Stage changed files explicitly; never use `git add -A` or `git add .`.
+
+Run `/prizmkit-committer` with commit prefix:
+
+```text
+fix({{FIX_SCOPE}}): {{BUG_TITLE}}
+```
+
+Do not push.
+
+Write `.prizmkit/bugfix/{{BUG_ID}}/fix-report.md` with:
+- root cause summary;
+- reproduction evidence;
+- fix summary;
+- files changed;
+- review/test/browser evidence;
+- manual/hybrid substitution evidence when applicable;
+- acceptance criteria checklist.
+
+**Checkpoint update**: Set `prizmkit-retrospective`, `prizmkit-committer`, and `bug-report` to `completed` as each finishes.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-critic.md

@@ -0,0 +1,22 @@
+### Plan Challenge — Critic Agent
+
+**Guard**: Verify critic agent file exists before spawning:
+
+```bash
+{{RUNTIME_HELPER_CMD}} artifact exists {{CRITIC_SUBAGENT_PATH}} --exists-marker CRITIC:READY --missing-marker CRITIC:MISSING
+```
+
+If `CRITIC:MISSING`, mark `critic-plan-review` as `skipped` and continue.
+
+**Focus**: Challenge the bug diagnosis and fix plan before implementation:
+- Is the root cause actually supported by the evidence?
+- Does the reproduction test prove the bug before the fix?
+- Is the fix minimal, or does it mask the symptom?
+- Are adjacent regressions likely?
+- Does manual/hybrid verification policy match `{{VERIFICATION_TYPE}}`?
+
+Spawn `prizm-dev-team-critic` with default/no worktree isolation. Do not request AI tool-created worktree isolation.
+
+The Critic writes `.prizmkit/bugfix/{{BUG_ID}}/challenge-report.md`. Resolve CRITICAL/HIGH findings before implementation, or document why the plan stands.
+
+**Checkpoint update**: Set step `critic-plan-review` to `completed` after challenges are resolved, or `skipped` when critic is unavailable.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-diagnose-plan.md

@@ -0,0 +1,23 @@
+### Phase 1: Diagnose & Plan
+
+**Goal**: prove or strongly establish the root cause before editing code.
+
+1. Read `.prizmkit/prizm-docs/root.prizm`, then only the relevant L1/L2 docs for affected modules.
+2. Trace from the error source to the likely root cause:
+   - classify error type;
+   - inspect relevant TRAPS/RULES;
+   - identify affected files and tests;
+   - separate symptom from cause.
+3. Write `.prizmkit/bugfix/{{BUG_ID}}/context-snapshot.md` with concise summaries, not full-file dumps:
+   - Bug Brief
+   - Root Cause Hypothesis
+   - Affected Files and Key Interfaces
+   - Existing/Reproduction Tests
+   - Relevant TRAPS/RULES
+4. Run `/prizmkit-plan` with `artifact_dir=.prizmkit/bugfix/{{BUG_ID}}/`.
+5. Ensure `plan.md` starts with a reproduction test task that would fail before the fix.
+6. Decide `FAST_PATH=true` only when root cause is obvious and plan has no more than 2 tasks.
+
+**CP-BF-1**: `spec.md` and `plan.md` exist, and the first plan task is a reproduction test.
+
+**Checkpoint update**: Set step `bug-diagnosis-and-plan` to `completed`.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-implement.md

@@ -0,0 +1,20 @@
+### Phase 2: Implement & Fix
+
+**Goal**: execute the fix plan with RED → GREEN evidence.
+
+Run `/prizmkit-implement` with `artifact_dir=.prizmkit/bugfix/{{BUG_ID}}/`:
+
+- Execute plan tasks in order.
+- First task creates or identifies a reproduction test that fails before the fix.
+- Subsequent tasks implement the minimal fix.
+- Mark each task `[x]` immediately after completion.
+- Run the smallest relevant reproduction test first; run broader regression checks only after the targeted test is green.
+- Do not refactor unrelated code.
+
+After implementation, verify:
+1. all plan tasks are `[x]`;
+2. reproduction test passes;
+3. no in-scope regression remains unexplained;
+4. acceptance criteria have evidence.
+
+**Checkpoint update**: Set step `prizmkit-implement` to `completed`.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-init.md

@@ -0,0 +1,9 @@
+### Phase 0: Initialize
+
+Create the bugfix artifact directory:
+
+```bash
+{{RUNTIME_HELPER_CMD}} artifact ensure-dir .prizmkit/bugfix/{{BUG_ID}}
+```
+
+**Checkpoint update**: Set step `prizmkit-init` to `completed` after the directory exists.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md

@@ -0,0 +1,15 @@
+### Manual / Hybrid Verification Gate
+
+`verification_type` is `{{VERIFICATION_TYPE}}`.
+
+For a fresh bugfix session, manual/hybrid verification is blocking before commit:
+
+1. Write `{{SESSION_STATUS_PATH}}` with:
+   - `status`: `partial`
+   - `can_resume`: `true`
+   - `resume_from_phase`: `4`
+   - explanation that manual UAT is required before commit
+2. Document the UAT checklist in `.prizmkit/bugfix/{{BUG_ID}}/fix-report.md` or `failure-log.md`.
+3. Stop before `/prizmkit-retrospective` and `/prizmkit-committer`.
+
+Recovery-class sessions (retry, resume, continuation, context overflow) may substitute automated verification for manual/hybrid UAT, but must document the substitution evidence before committing.

package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md

@@ -0,0 +1,29 @@
+### Phase 3: Review
+
+If `FAST_PATH=true`, skip this phase intentionally:
+
+```bash
+{{CHECKPOINT_PYTHON_CMD}} \
+  --checkpoint-path {{CHECKPOINT_PATH}} \
+  --step prizmkit-code-review \
+  --status skipped \
+  --note "FAST_PATH: obvious root cause and <=2 tasks"
+```
+
+Then continue to the next checkpoint step.
+
+Otherwise, run `/prizmkit-code-review` with `artifact_dir=.prizmkit/bugfix/{{BUG_ID}}/`.
+
+The skill runs its internal Reviewer Agent → filter → orchestrator fix loop and writes `review-report.md`.
+
+**Gate Check — Review Report**:
+
+```bash
+{{RUNTIME_HELPER_CMD}} text contains .prizmkit/bugfix/{{BUG_ID}}/review-report.md --pattern "## Verdict"
+```
+
+- `PASS` → proceed.
+- `NEEDS_FIXES` → the skill exhausted its internal rounds; log remaining findings and proceed only when they do not block acceptance criteria.
+- Missing report → one bounded retry or safe inline fallback review, then write `failure-log.md` if still blocked.
+
+**Checkpoint update**: Set step `prizmkit-code-review` to `completed` when review is complete, or `skipped` for FAST_PATH.

package/bundled/dev-pipeline/templates/sections/bugfix-reminders.md

@@ -0,0 +1,11 @@
+## Reminders
+
+- Use L1 skills: `/prizmkit-plan`, `/prizmkit-implement`, `/prizmkit-code-review`, `/prizmkit-retrospective`, `/prizmkit-committer`.
+- All bugfix skills use `artifact_dir=.prizmkit/bugfix/{{BUG_ID}}/`.
+- The first plan task must prove the bug with a reproduction test when feasible.
+- Commit with `fix(<scope>):`, not `feat:`.
+- Do not write TRAP dates into `.prizmkit/prizm-docs/`.
+- Do not use top-level Dev subagents; implement directly as the orchestrator.
+- Checkpoint state is the recovery truth; skipped steps must be marked `skipped`.
+- Browser verification is a mandatory attempt by default; it blocks only when explicitly required.
+- If `DEV_PORT` is unknown, discover it from project config; do not guess port 3000.

package/bundled/dev-pipeline/templates/sections/bugfix-session-context.md

@@ -0,0 +1,7 @@
+## Session Context
+
+- **Bug ID**: {{BUG_ID}} | **Session**: {{SESSION_ID}} | **Run**: {{RUN_ID}}
+- **Bug Title**: {{BUG_TITLE}}
+- **Severity**: {{SEVERITY}}
+- **Mode**: {{PIPELINE_MODE}} | **Critic**: {{CRITIC_ENABLED}}
+- **Verification Type**: {{VERIFICATION_TYPE}}

package/bundled/dev-pipeline/templates/sections/bugfix-session-status.md

@@ -0,0 +1,31 @@
+### Step 3: Report Session Status
+
+Before exiting, write the session status file:
+
+`{{SESSION_STATUS_PATH}}`
+
+```json
+{
+  "session_id": "{{SESSION_ID}}",
+  "bug_id": "{{BUG_ID}}",
+  "status": "<success|partial|failed>",
+  "completed_phases": [1, 2, 3, 4],
+  "current_phase": 4,
+  "checkpoint_reached": "<current checkpoint step>",
+  "fast_path": false,
+  "errors": [],
+  "can_resume": false,
+  "resume_from_phase": null,
+  "artifacts": {
+    "spec_path": ".prizmkit/bugfix/{{BUG_ID}}/spec.md",
+    "plan_path": ".prizmkit/bugfix/{{BUG_ID}}/plan.md",
+    "fix_report_path": ".prizmkit/bugfix/{{BUG_ID}}/fix-report.md"
+  },
+  "git_commit": "<commit hash or null>",
+  "traps_updated": false,
+  "manual_verification_policy": "{{MANUAL_VERIFICATION_POLICY}}",
+  "timestamp": "{{TIMESTAMP}}"
+}
+```
+
+For fresh manual/hybrid partial stops, set `status="partial"`, `can_resume=true`, and `resume_from_phase=4`.

package/bundled/dev-pipeline/templates/sections/bugfix-task-contract.md

@@ -0,0 +1,40 @@
+## Bug Fix Task Contract
+
+### Objective
+
+Fix {{BUG_ID}}: "{{BUG_TITLE}}".
+
+{{BUG_DESCRIPTION}}
+
+{{USER_CONTEXT}}
+
+### Error Source
+
+- **Type**: {{ERROR_SOURCE_TYPE}}
+{{ERROR_SOURCE_DETAILS}}
+
+### Environment
+
+{{ENVIRONMENT}}
+
+### Verification Contract
+
+- **Verification Type**: {{VERIFICATION_TYPE}}
+- **Manual/Hybrid Policy**: {{MANUAL_VERIFICATION_POLICY}}
+
+### Acceptance Criteria
+
+{{ACCEPTANCE_CRITERIA}}
+
+### Gate Checklist
+
+{{AC_CHECKLIST}}
+
+Gate rule:
+- `[x]` means verified with reproduction, implementation, test, review, or documented recovery evidence.
+- Any remaining `[ ]` means the bug fix is incomplete.
+- Blocked gates must be documented in `failure-log.md`; blocked is not success.
+
+### App Global Context
+
+{{GLOBAL_CONTEXT}}

package/bundled/dev-pipeline/templates/sections/failure-capture.md

@@ -2,10 +2,10 @@
 
 If you encounter an unrecoverable error, context overflow, or are about to exit without completing all phases:
 
-1. Write `.prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md` BEFORE exiting:
+1. Write `{{ARTIFACT_DIR}}/failure-log.md` BEFORE exiting:
    ```
    FAILURE_TYPE: timeout | test_failure | review_rejected | context_overflow | unknown
-   PHASE: <which phase failed>
+   PHASE: <failed phase or checkpoint step>
    ROOT_CAUSE: <1-2 sentence explanation>
    ATTEMPTED: <approaches already tried>
    SUGGESTION: <what the next session should try differently>

package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md

@@ -4,7 +4,7 @@ You MUST attempt this phase. Mark it as skipped only when no usable browser tool
 
 **Step 0 — Tool Selection (BLOCKING — decide before any browser action)**:
 
-0a. Check which browser tools are available:
+0a. Check browser tool availability:
 ```bash
 {{RUNTIME_HELPER_CMD}} executable version playwright-cli --arg=--version
 {{RUNTIME_HELPER_CMD}} executable version opencli --arg=--version

package/bundled/dev-pipeline/templates/sections/refactor-artifacts.md

@@ -0,0 +1,17 @@
+## Refactor Artifacts Directory
+
+Use only this durable artifact directory for this refactor:
+
+```text
+.prizmkit/refactor/{{REFACTOR_ID}}/
+├── spec.md
+├── plan.md
+├── context-snapshot.md
+├── review-report.md
+├── refactor-report.md
+├── completion-summary.json
+├── failure-log.md
+└── workflow-checkpoint.json
+```
+
+Do not write refactor artifacts under feature or bugfix artifact directories.

package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md

@@ -0,0 +1,13 @@
+## Critical Paths
+
+| Resource | Path |
+|----------|------|
+| Refactor Artifacts Dir | `.prizmkit/refactor/{{REFACTOR_ID}}/` |
+| Spec | `.prizmkit/refactor/{{REFACTOR_ID}}/spec.md` |
+| Plan | `.prizmkit/refactor/{{REFACTOR_ID}}/plan.md` |
+| Review Report | `.prizmkit/refactor/{{REFACTOR_ID}}/review-report.md` |
+| Refactor Report | `.prizmkit/refactor/{{REFACTOR_ID}}/refactor-report.md` |
+| Completion Summary | `.prizmkit/refactor/{{REFACTOR_ID}}/completion-summary.json` |
+| Workflow Checkpoint | `{{CHECKPOINT_PATH}}` |
+| Session Status Output | `{{SESSION_STATUS_PATH}}` |
+| Project Root | `{{PROJECT_ROOT}}` |

package/bundled/dev-pipeline/templates/sections/refactor-mission.md

@@ -0,0 +1,9 @@
+## Your Mission
+
+You are the **refactor session orchestrator**. Execute Refactor {{REFACTOR_ID}}: "{{REFACTOR_TITLE}}".
+
+**CRITICAL**: Preserve observable behavior. Do not change product behavior unless the refactor contract explicitly requires it.
+
+**Execution model**: You implement directly in the current checkout. Do not spawn a top-level Dev subagent. Do not spawn a top-level Reviewer subagent. `/prizmkit-code-review` owns its internal Reviewer Agent → filter → orchestrator fix loop.
+
+**NON-INTERACTIVE MODE**: There is NO human on the other end. Resolve uncertainty from existing code and conservative project patterns.

package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md

@@ -0,0 +1,37 @@
+### Phase 4: Commit, Report & Completion Summary
+
+**Refactor Documentation Policy**:
+- Default: run `/prizmkit-retrospective` with full sync because refactoring changes structure and interfaces.
+- Skip architecture knowledge injection only for a pure rename with no interface or dependency changes.
+
+Run `/prizmkit-retrospective` using the current working tree and staged changes as input context. Do not rely only on `git diff --cached`.
+
+Stage changed files explicitly; never use `git add -A` or `git add .`.
+
+Run `/prizmkit-committer` with commit prefix:
+
+```text
+refactor({{REFACTOR_ID}}): {{REFACTOR_TITLE}}
+```
+
+Do not push.
+
+Write `.prizmkit/refactor/{{REFACTOR_ID}}/refactor-report.md` with:
+- refactor summary;
+- files/modules changed;
+- behavior-preservation evidence before/after;
+- review findings;
+- browser evidence when applicable;
+- acceptance criteria checklist.
+
+Write `.prizmkit/refactor/{{REFACTOR_ID}}/completion-summary.json` for downstream refactor context:
+
+```json
+{
+  "completion_notes": [
+    "<key structural change, moved/renamed interface, or new module boundary>"
+  ]
+}
+```
+
+**Checkpoint update**: Set `prizmkit-retrospective`, `prizmkit-committer`, `refactor-report`, and `completion-summary` to `completed` as each finishes.

package/bundled/dev-pipeline/templates/sections/refactor-phase-critic.md

@@ -0,0 +1,22 @@
+### Plan Challenge — Critic Agent
+
+**Guard**: Verify critic agent file exists before spawning:
+
+```bash
+{{RUNTIME_HELPER_CMD}} artifact exists {{CRITIC_SUBAGENT_PATH}} --exists-marker CRITIC:READY --missing-marker CRITIC:MISSING
+```
+
+If `CRITIC:MISSING`, mark `critic-plan-review` as `skipped` and continue.
+
+**Focus**: Challenge behavior preservation and plan safety before implementation:
+- Is observable behavior clearly defined and protected?
+- Do existing/new tests cover the behavior affected by this refactor?
+- Is the plan too broad for the stated scope?
+- Are file moves/renames safe for imports, public APIs, and integrations?
+- Is rollback realistic?
+
+Spawn `prizm-dev-team-critic` with default/no worktree isolation. Do not request AI tool-created worktree isolation.
+
+The Critic writes `.prizmkit/refactor/{{REFACTOR_ID}}/challenge-report.md`. Resolve CRITICAL/HIGH findings before implementation, or document why the plan stands.
+
+**Checkpoint update**: Set step `critic-plan-review` to `completed` after challenges are resolved, or `skipped` when critic is unavailable.

package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md

@@ -0,0 +1,16 @@
+### Phase 2: Implement — Orchestrator Direct
+
+**Goal**: execute the refactor plan while preserving behavior.
+
+Run `/prizmkit-implement` directly with `artifact_dir=.prizmkit/refactor/{{REFACTOR_ID}}/`.
+
+Rules:
+- You are the implementer; do not spawn a top-level Dev subagent.
+- Establish a baseline test result before structural changes when feasible.
+- Execute plan tasks in order and mark each `[x]` immediately.
+- After each behavior-sensitive task, run the smallest relevant behavior-preservation check.
+- Add or update tests only to lock existing behavior, not to change expected behavior.
+- If tests fail unexpectedly, treat it as a behavior-preservation failure and fix before proceeding.
+- Document changed module boundaries and any deviations from the plan in `context-snapshot.md`.
+
+**Checkpoint update**: Set step `prizmkit-implement` to `completed` when all tasks are `[x]` and behavior-preservation evidence is recorded.

package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md

@@ -0,0 +1,9 @@
+### Phase 0: Initialize
+
+Create the refactor artifact directory:
+
+```bash
+{{RUNTIME_HELPER_CMD}} artifact ensure-dir .prizmkit/refactor/{{REFACTOR_ID}}
+```
+
+**Checkpoint update**: Set step `prizmkit-init` to `completed` after the directory exists.

package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md

@@ -0,0 +1,22 @@
+### Phase 1: Plan — Specification & Plan Generation
+
+**Goal**: produce a behavior-preserving refactor plan before editing code.
+
+Run `/prizmkit-plan` with `artifact_dir=.prizmkit/refactor/{{REFACTOR_ID}}/`.
+
+The spec.md must include:
+- refactor goals and acceptance criteria;
+- explicit scope boundaries;
+- behavior preservation contract;
+- existing tests and gaps.
+
+The plan.md must include:
+- safe task ordering: baseline checks → safe renames/moves → extractions → structural changes;
+- files/modules to touch;
+- behavior-preservation checks for each task;
+- rollback strategy;
+- Tasks section with `[ ]` checkboxes.
+
+Resolve uncertain refactor details from existing code and conservative project patterns. Do not expand scope beyond the task contract.
+
+**Checkpoint update**: Set step `prizmkit-plan` to `completed` after `spec.md` and `plan.md` exist.

package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md

@@ -0,0 +1,19 @@
+### Phase 3: Review — Code Review & Behavior Verification
+
+Run `/prizmkit-code-review` directly with `artifact_dir=.prizmkit/refactor/{{REFACTOR_ID}}/`.
+
+Do not spawn a top-level Reviewer subagent. The code-review skill owns its internal Reviewer Agent → filter → orchestrator fix loop.
+
+**Gate Check — Review Report**:
+
+```bash
+{{RUNTIME_HELPER_CMD}} text contains .prizmkit/refactor/{{REFACTOR_ID}}/review-report.md --pattern "## Verdict"
+```
+
+- `PASS` → proceed.
+- `NEEDS_FIXES` → the skill exhausted its internal rounds; log remaining findings and proceed only when they do not block behavior preservation.
+- Missing report → one bounded retry or safe inline fallback review, then write `failure-log.md` if still blocked.
+
+Verify the review explicitly checks behavior preservation, public API compatibility, imports, tests, and rollback assumptions.
+
+**Checkpoint update**: Set step `prizmkit-code-review` to `completed` when review is complete.

package/bundled/dev-pipeline/templates/sections/refactor-reminders.md

@@ -0,0 +1,11 @@
+## Reminders
+
+- Use L1 skills: `/prizmkit-plan`, `/prizmkit-implement`, `/prizmkit-code-review`, `/prizmkit-retrospective`, `/prizmkit-committer`.
+- All refactor skills use `artifact_dir=.prizmkit/refactor/{{REFACTOR_ID}}/`.
+- Behavior preservation is the first priority.
+- Do not spawn top-level Dev or Reviewer subagents.
+- Main orchestrator runs `/prizmkit-code-review` directly.
+- Commit with `refactor(<scope>):`, not `feat:` or `fix:`.
+- Checkpoint state is the recovery truth; skipped steps must be marked `skipped`.
+- Browser verification is a mandatory attempt by default; it blocks only when explicitly required.
+- If `DEV_PORT` is unknown, discover it from project config; do not guess port 3000.

package/bundled/dev-pipeline/templates/sections/refactor-session-context.md

@@ -0,0 +1,7 @@
+## Session Context
+
+- **Refactor ID**: {{REFACTOR_ID}} | **Session**: {{SESSION_ID}} | **Run**: {{RUN_ID}}
+- **Title**: {{REFACTOR_TITLE}}
+- **Type**: {{REFACTOR_TYPE}}
+- **Priority**: {{PRIORITY}} | **Complexity**: {{COMPLEXITY}}
+- **Mode**: {{PIPELINE_MODE}} | **Critic**: {{CRITIC_ENABLED}}

package/bundled/dev-pipeline/templates/sections/refactor-session-status.md

@@ -0,0 +1,28 @@
+### Step 3: Report Session Status
+
+Before exiting, write the session status file:
+
+`{{SESSION_STATUS_PATH}}`
+
+```json
+{
+  "session_id": "{{SESSION_ID}}",
+  "refactor_id": "{{REFACTOR_ID}}",
+  "status": "<success|partial|failed>",
+  "completed_phases": [1, 2, 3, 4],
+  "current_phase": 4,
+  "checkpoint_reached": "<current checkpoint step>",
+  "errors": [],
+  "can_resume": false,
+  "resume_from_phase": null,
+  "artifacts": {
+    "spec_path": ".prizmkit/refactor/{{REFACTOR_ID}}/spec.md",
+    "plan_path": ".prizmkit/refactor/{{REFACTOR_ID}}/plan.md",
+    "report_path": ".prizmkit/refactor/{{REFACTOR_ID}}/refactor-report.md",
+    "completion_summary_path": ".prizmkit/refactor/{{REFACTOR_ID}}/completion-summary.json"
+  },
+  "git_commit": "<commit hash>",
+  "behavior_preserved": true,
+  "timestamp": "{{TIMESTAMP}}"
+}
+```

package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md

@@ -0,0 +1,52 @@
+## Refactor Task Contract
+
+### Objective
+
+Execute {{REFACTOR_ID}}: "{{REFACTOR_TITLE}}".
+
+{{REFACTOR_DESCRIPTION}}
+
+{{USER_CONTEXT}}
+
+### Scope
+
+**Files:**
+{{SCOPE_FILES}}
+
+**Modules:**
+{{SCOPE_MODULES}}
+
+### Behavior Preservation
+
+- **Strategy**: {{BEHAVIOR_STRATEGY}}
+
+{{BEHAVIOR_PRESERVATION}}
+
+### Existing Tests
+
+{{EXISTING_TESTS}}
+
+### New Tests Needed
+
+{{NEW_TESTS_NEEDED}}
+
+### Acceptance Criteria
+
+{{ACCEPTANCE_CRITERIA}}
+
+### Gate Checklist
+
+{{AC_CHECKLIST}}
+
+Gate rule:
+- `[x]` means verified with behavior-preservation evidence.
+- Any remaining `[ ]` means the refactor is incomplete.
+- Blocked gates must be documented in `failure-log.md`; blocked is not success.
+
+### Dependencies
+
+{{DEPENDENCIES}}
+
+### App Global Context
+
+{{GLOBAL_CONTEXT}}

package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py

@@ -884,7 +884,8 @@ class TestDirectOrchestratorImplementationPrompts:
         assert FORBIDDEN_DEV_FIX_PLACEHOLDER not in replacements
         assert FORBIDDEN_DEV_RESUME_PLACEHOLDER not in replacements
         assert "{{AGENT_PROMPT_CRITIC_PLAN_CHALLENGE}}" in replacements
-        assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" in replacements
+        assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" not in replacements
+        assert (templates_dir / "agent-prompts" / "reviewer-review.md").exists() is False
         assert (templates_dir / "agent-prompts" / "dev-implement.md").exists() is False
         assert (templates_dir / "agent-prompts" / FORBIDDEN_DEV_FIX_PROMPT).exists() is False
         assert (templates_dir / "agent-prompts" / FORBIDDEN_DEV_RESUME_PROMPT).exists() is False
@@ -923,9 +924,19 @@ class TestDirectOrchestratorImplementationPrompts:
             assert "Implement — Orchestrator Direct" in rendered
             assert "Spawn Dev subagent" not in rendered
             assert "Spawn Dev agent" not in rendered
+            assert "Spawn Reviewer agent" not in rendered
+            assert "Reviewer Agent Def" not in rendered
+            assert "subagent_type=\"prizm-dev-team-reviewer\"" not in rendered
             assert "Implement — Dev" not in rendered
             assert "{{AGENT_PROMPT_DEV_IMPLEMENT}}" not in rendered
+            assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" not in rendered
+            assert "reviewer-review.md" not in rendered
             assert "dev-implement.md" not in rendered
+            assert "Bug Fix Documentation Policy" not in rendered
+            assert "For bug-fix sessions" not in rendered
+            assert "fix(<scope>)" not in rendered
+            assert "port check 3000" not in rendered
+            assert "localhost:3000" not in rendered
             assert FORBIDDEN_REVIEW_DEV_FIX not in rendered
             assert FORBIDDEN_REVIEWER_DEV_SPAWN not in rendered
             assert FORBIDDEN_EXPLORE_SUBAGENT not in rendered
@@ -1311,7 +1322,6 @@ class TestHeadlessPromptCleanupF033:
         refactor_prompt = _render_refactor_prompt(tmp_path / "refactor-mixed", platform="claude")
 
         assert replacements["{{REVIEWER_SUBAGENT_PATH}}"].endswith(".claude/agents/prizm-dev-team-reviewer.md")
-        assert ".claude/agents/prizm-dev-team-reviewer.md" in refactor_prompt
         assert ".codex/agents/prizm-dev-team-reviewer.toml" not in refactor_prompt
 
     def test_bugfix_refactor_explicit_codex_override(self, tmp_path, monkeypatch):
@@ -1333,7 +1343,6 @@ class TestHeadlessPromptCleanupF033:
         refactor_prompt = _render_refactor_prompt(tmp_path / "refactor-codex", platform="claude", explicit_platform="codex")
 
         assert replacements["{{REVIEWER_SUBAGENT_PATH}}"].endswith(".codex/agents/prizm-dev-team-reviewer.toml")
-        assert ".codex/agents/prizm-dev-team-reviewer.toml" in refactor_prompt
         assert ".claude/agents/prizm-dev-team-reviewer.md" not in refactor_prompt
 
     def test_explicit_codex_env_still_renders_codex_critic_path(self, tmp_path, monkeypatch):
@@ -1399,7 +1408,9 @@ class TestFeatureBootstrapShellExtraction:
             assert "executable version opencli --arg=--version" in prompt
             assert "process start --pid-file .prizmkit/state/browser-dev-server.pid" in prompt
             assert "process cleanup-pid <pid-from-.prizmkit/state/browser-dev-server.pid>" in prompt
-            assert "port check <DEV_PORT>" in prompt or "port check 3000" in prompt
+            assert "port check <DEV_PORT>" in prompt
+            assert "port check 3000" not in prompt
+            assert "localhost:3000" not in prompt
 
     def test_rendered_legacy_tier_feature_prompts_use_runtime_helper_not_extracted_bash(self, tmp_path):
         cases = [
@@ -1419,7 +1430,8 @@ class TestFeatureBootstrapShellExtraction:
             self.assert_shell_extracted_operations_removed(prompt)
             assert "process start --pid-file .prizmkit/state/browser-dev-server.pid" in prompt
             assert "process cleanup-pid <pid-from-.prizmkit/state/browser-dev-server.pid>" in prompt
-            assert "port check 3000" in prompt
+            assert "port check 3000" not in prompt
+            assert "localhost:3000" not in prompt
 
     def test_legacy_tier_specific_extracted_operations_map_to_helper_commands(self, tmp_path):
         tier1 = _render_feature_prompt(