prizmkit 1.0.122 → 1.0.123

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.122",
-  "bundledAt": "2026-03-27T16:12:14.647Z",
-  "bundledFrom": "69c231a"
+  "frameworkVersion": "1.0.123",
+  "bundledAt": "2026-03-27T16:40:06.103Z",
+  "bundledFrom": "601c3b6"
 }

package/bundled/dev-pipeline/README.md

@@ -159,7 +159,7 @@ Manages `run.sh` as a background daemon process with PID tracking and log consol
 | `logs` | View pipeline logs. `--follow` for live tail, `--lines N` for last N lines |
 | `restart` | Stop + start |
 
-**`--mode` options:** `lite`, `standard`, `full`, `self-evolve`
+**`--mode` options:** `lite`, `standard`, `full`
 
 **`--env` format:** Pass environment variables as a quoted string:
 
@@ -308,7 +308,7 @@ python3 scripts/generate-bootstrap-prompt.py \
   --output <path> \
   [--state-dir <path>] \
   [--template <path>] \
-  [--mode lite|standard|full|self-evolve]
+  [--mode lite|standard|full]
 ```
 
 **Template auto-selection by complexity:**
@@ -318,7 +318,6 @@ python3 scripts/generate-bootstrap-prompt.py \
 | `low` | lite | `bootstrap-tier1.md` (single agent) |
 | `medium` | standard | `bootstrap-tier2.md` (dual agent) |
 | `high` / `critical` | full | `bootstrap-tier3.md` (full team) |
-| (override) | self-evolve | `bootstrap-tier3.md` + framework guardrails |
 
 **Output (JSON to stdout):**
 
@@ -331,7 +330,7 @@ The `model` field is extracted from the feature's `"model"` field in feature-lis
 **Conditional blocks resolved:**
 - `{{IF_RESUME}}` / `{{IF_FRESH_START}}` — Resume vs fresh start
 - `{{IF_INIT_NEEDED}}` / `{{IF_INIT_DONE}}` — PrizmKit init status
-- `{{IF_MODE_LITE}}` / `{{IF_MODE_STANDARD}}` / `{{IF_MODE_FULL}}` / `{{IF_MODE_SELF_EVOLVE}}` — Pipeline mode blocks
+- `{{IF_MODE_LITE}}` / `{{IF_MODE_STANDARD}}` / `{{IF_MODE_FULL}}` — Pipeline mode blocks
 
 ---
 
@@ -570,7 +569,7 @@ Also exports: `log_info`, `log_warn`, `log_error`, `log_success` (with timestamp
 |----------|---------|---------|-------------|
 | `MAX_RETRIES` | `3` | run.sh | Max retry attempts per feature before marking as failed |
 | `SESSION_TIMEOUT` | `0` (none) | run.sh, retry-feature.sh, run-bugfix.sh, retry-bug.sh | Timeout in seconds per AI CLI session. 0 = no timeout |
-| `PIPELINE_MODE` | (auto) | run.sh, launch-daemon.sh | Override mode for all features: `lite\|standard\|full\|self-evolve` |
+| `PIPELINE_MODE` | (auto) | run.sh, launch-daemon.sh | Override mode for all features: `lite\|standard\|full` |
 | `DEV_BRANCH` | auto-generated | run.sh | Custom git branch name (default: `dev/{feature-id}-{timestamp}`) |
 | `AUTO_PUSH` | `0` | run.sh | Set to `1` to auto-push branch to remote after successful session |
 
@@ -920,7 +919,7 @@ dev-pipeline/
 +-- templates/
 |   +-- bootstrap-tier1.md           # Tier 1 prompt template (single agent, lite)
 |   +-- bootstrap-tier2.md           # Tier 2 prompt template (dual agent, standard)
-|   +-- bootstrap-tier3.md           # Tier 3 prompt template (full team, full/self-evolve)
+|   +-- bootstrap-tier3.md           # Tier 3 prompt template (full team, full)
 |   +-- bootstrap-prompt.md          # Legacy monolithic template (fallback)
 |   +-- bugfix-bootstrap-prompt.md   # Bug-fix session prompt template
 |   +-- feature-list-schema.json     # JSON schema for feature-list.json

package/bundled/dev-pipeline/assets/prizm-dev-team-integration.md

@@ -29,8 +29,8 @@ dev-pipeline (outer loop)
 
 | Agent | Definition Path | Type |
 |-------|----------------|------|
-| Dev | `core/agents/prizm-dev-team-dev.md` | prizm-dev-team-dev |
-| Reviewer | `core/agents/prizm-dev-team-reviewer.md` | prizm-dev-team-reviewer |
+| Dev | `.claude/agents/prizm-dev-team-dev.md` (or `.codebuddy/agents/`) | prizm-dev-team-dev |
+| Reviewer | `.claude/agents/prizm-dev-team-reviewer.md` (or `.codebuddy/agents/`) | prizm-dev-team-reviewer |
 
 Note: The Orchestrator role is handled by the main agent (session orchestrator) directly — no separate agent definition needed.
 

package/bundled/dev-pipeline/launch-daemon.sh

@@ -110,15 +110,15 @@ cmd_start() {
             --mode)
                 shift
                 if [[ $# -eq 0 ]]; then
-                    log_error "--mode requires a value (lite|standard|full|self-evolve)"
+                    log_error "--mode requires a value (lite|standard|full)"
                     exit 1
                 fi
                 case "$1" in
-                    lite|standard|full|self-evolve)
+                    lite|standard|full)
                         mode_override="$1"
                         ;;
                     *)
-                        log_error "Invalid mode: $1 (must be lite, standard, full, or self-evolve)"
+                        log_error "Invalid mode: $1 (must be lite, standard, or full)"
                         exit 1
                         ;;
                 esac
@@ -578,7 +578,7 @@ Commands:
   help                                            Show this help
 
 Options:
-  --mode <lite|standard|full|self-evolve>   Override pipeline mode for all features
+  --mode <lite|standard|full>              Override pipeline mode for all features
   --features <filter>                       Run only specified features (e.g. F-001,F-003 or F-001:F-010)
   --env "KEY=VAL ..."                        Set environment variables
 
@@ -587,9 +587,9 @@ Examples:
   ./launch-daemon.sh start my-features.json       # Start with custom feature list
   ./launch-daemon.sh start --features F-001:F-005  # Run only features F-001 through F-005
   ./launch-daemon.sh start --features F-001,F-003,F-007  # Run specific features
-  ./launch-daemon.sh start --mode self-evolve     # Self-evolve mode (framework development)
+  ./launch-daemon.sh start --mode full              # Full mode for complex features
   ./launch-daemon.sh start --env "MAX_RETRIES=5 SESSION_TIMEOUT=7200"
-  ./launch-daemon.sh start feature-list.json --mode self-evolve --env "VERBOSE=1"
+  ./launch-daemon.sh start feature-list.json --mode full --env "VERBOSE=1"
   ./launch-daemon.sh status                       # Check if running (JSON on stdout)
   ./launch-daemon.sh logs --follow                # Live log tailing
   ./launch-daemon.sh logs --lines 100             # Last 100 lines

package/bundled/dev-pipeline/run.sh

@@ -27,7 +27,7 @@ set -euo pipefail
 #   LOG_CLEANUP_ENABLED   Run periodic log cleanup (default: 1)
 #   LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)
 #   LOG_MAX_TOTAL_MB      Keep total logs under N MB via oldest-first cleanup (default: 1024)
-#   PIPELINE_MODE         Override mode for all features: lite|standard|full|self-evolve (used by daemon)
+#   PIPELINE_MODE         Override mode for all features: lite|standard|full (used by daemon)
 #   DEV_BRANCH            Custom dev branch name (default: auto-generated dev/{feature_id}-YYYYMMDDHHmm)
 #   AUTO_PUSH             Auto-push to remote after successful feature (default: 0). Set to 1 to enable.
 # ============================================================
@@ -419,11 +419,11 @@ run_one() {
                     exit 1
                 fi
                 case "$1" in
-                    lite|standard|full|self-evolve)
+                    lite|standard|full)
                         mode_override="$1"
                         ;;
                     *)
-                        log_error "Invalid mode: $1 (must be lite, standard, full, or self-evolve)"
+                        log_error "Invalid mode: $1 (must be lite, standard, or full)"
                         exit 1
                         ;;
                 esac
@@ -513,14 +513,6 @@ run_one() {
         log_success "Pipeline initialized with $features_count features"
     fi
 
-    # Auto-detect framework repo: if scripts/bundle.js exists, enable self-evolve mode
-    local project_root
-    project_root=$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "")
-    if [[ -z "$mode_override" && -n "$project_root" && -f "$project_root/scripts/bundle.js" ]]; then
-        log_info "Detected PrizmKit framework repo — auto-enabling self-evolve mode"
-        mode_override="self-evolve"
-    fi
-
     # Verify feature exists
     local feature_title
     feature_title=$(python3 -c "
@@ -752,37 +744,6 @@ sys.exit(1)
 
     echo ""
     if [[ "$session_status" == "success" ]]; then
-        # Self-evolve mode: run framework validation after successful session
-        if [[ "$mode_override" == "self-evolve" ]]; then
-            log_info "Self-evolve mode: running framework validation..."
-            if bash "$SCRIPTS_DIR/validate-framework.sh" 2>&1; then
-                log_success "Framework validation passed"
-            else
-                log_warn "Framework validation failed — review issues above"
-                session_status="framework_validation_failed"
-            fi
-
-            # Check for reload_needed marker in session status
-            local session_status_file="$session_dir/session-status.json"
-            if [[ -f "$session_status_file" ]]; then
-                local reload_needed
-                reload_needed=$(python3 -c "
-import json, sys
-with open(sys.argv[1]) as f:
-    data = json.load(f)
-print(data.get('reload_needed', False))
-" "$session_status_file" 2>/dev/null || echo "False")
-                if [[ "$reload_needed" == "True" ]]; then
-                    echo ""
-                    log_warn "╔══════════════════════════════════════════════════════════════╗"
-                    log_warn "║  RELOAD NEEDED: This session modified pipeline skills or     ║"
-                    log_warn "║  templates that are used by the dev-pipeline itself.          ║"
-                    log_warn "║  Changes will take effect in the NEXT session.                ║"
-                    log_warn "╚══════════════════════════════════════════════════════════════╝"
-                fi
-            fi
-        fi
-
         log_success "════════════════════════════════════════════════════"
         log_success "  $feature_id completed successfully!"
         log_success "════════════════════════════════════════════════════"
@@ -991,18 +952,6 @@ for f in data.get('stuck_features', []):
             main_prompt_args+=(--mode "$PIPELINE_MODE")
         fi
 
-        # Auto-detect framework repo: if scripts/bundle.js exists, enable self-evolve mode
-        if [[ -z "${PIPELINE_MODE:-}" ]]; then
-            local _project_root
-            _project_root=$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "")
-            if [[ -n "$_project_root" && -f "$_project_root/scripts/bundle.js" ]]; then
-                if [[ $session_count -eq 0 ]]; then
-                    log_info "Detected PrizmKit framework repo — auto-enabling self-evolve mode"
-                fi
-                main_prompt_args+=(--mode "self-evolve")
-            fi
-        fi
-
         local gen_output
         gen_output=$(python3 "$SCRIPTS_DIR/generate-bootstrap-prompt.py" "${main_prompt_args[@]}" 2>/dev/null) || {
             log_error "Failed to generate bootstrap prompt for $feature_id"
@@ -1102,7 +1051,7 @@ show_help() {
     echo "Single Feature Options (run <feature-id>):"
     echo "  --dry-run                   Generate bootstrap prompt only, don't spawn session"
     echo "  --resume-phase N            Override resume phase (default: auto-detect)"
-    echo "  --mode <lite|standard|full|self-evolve> Override pipeline mode (bypasses estimated_complexity)"
+    echo "  --mode <lite|standard|full> Override pipeline mode (bypasses estimated_complexity)"
     echo "  --clean                     Delete artifacts and reset before running"
     echo "  --no-reset                  Skip feature status reset step"
     echo "  --timeout N                 Session timeout in seconds (default: 0 = no limit)"
@@ -1117,7 +1066,7 @@ show_help() {
     echo "  LOG_CLEANUP_ENABLED   Run log cleanup before execution (default: 1)"
     echo "  LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)"
     echo "  LOG_MAX_TOTAL_MB      Keep total logs under N MB (default: 1024)"
-    echo "  PIPELINE_MODE         Override mode for all features: lite|standard|full|self-evolve"
+    echo "  PIPELINE_MODE         Override mode for all features: lite|standard|full"
     echo ""
     echo "Examples:"
     echo "  ./run.sh run                                         # Run all features"

package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py

@@ -84,7 +84,7 @@ def parse_args():
     )
     parser.add_argument(
         "--mode",
-        choices=["lite", "standard", "full", "self-evolve"],
+        choices=["lite", "standard", "full"],
         default=None,
         help="Override pipeline mode (default: auto-detect from complexity)",
     )
@@ -283,35 +283,15 @@ def process_mode_blocks(content, pipeline_mode, init_done):
     """Process pipeline mode and init conditional blocks.
 
     Keeps the block matching the current mode, removes the others.
-    For self-evolve mode: keeps SELF_EVOLVE blocks AND FULL blocks
-    (since self-evolve is full + framework guardrails).
     """
-    is_self_evolve = pipeline_mode == "self-evolve"
-
-    # Step 1: Handle SELF_EVOLVE conditional blocks first
-    se_open = "{{IF_MODE_SELF_EVOLVE}}"
-    se_close = "{{END_IF_MODE_SELF_EVOLVE}}"
-    if is_self_evolve:
-        # Keep content, remove tags
-        content = content.replace(se_open + "\n", "")
-        content = content.replace(se_open, "")
-        content = content.replace(se_close + "\n", "")
-        content = content.replace(se_close, "")
-    else:
-        # Remove entire SELF_EVOLVE blocks
-        pattern = re.escape(se_open) + r".*?" + re.escape(se_close) + r"\n?"
-        content = re.sub(pattern, "", content, flags=re.DOTALL)
-
-    # Step 2: Handle lite/standard/full blocks
-    # self-evolve inherits full mode for the standard tier blocks
-    effective_mode = "full" if is_self_evolve else pipeline_mode
+    # Handle lite/standard/full blocks
     modes = ["lite", "standard", "full"]
 
     for mode in modes:
         tag_open = "{{{{IF_MODE_{}}}}}".format(mode.upper())
         tag_close = "{{{{END_IF_MODE_{}}}}}".format(mode.upper())
 
-        if mode == effective_mode:
+        if mode == pipeline_mode:
             # Keep content, remove tags
             content = content.replace(tag_open + "\n", "")
             content = content.replace(tag_open, "")
@@ -472,8 +452,6 @@ def build_replacements(args, feature, features, global_context, script_dir):
     else:
         pipeline_mode = determine_pipeline_mode(complexity)
 
-    is_self_evolve = pipeline_mode == "self-evolve"
-
     # Auto-detect resume: if all planning artifacts exist and resume_phase
     # is "null" (fresh start), skip to Phase 6
     effective_resume = args.resume_phase
@@ -512,7 +490,6 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "{{HAS_SPEC}}": "true" if artifacts["has_spec"] else "false",
         "{{HAS_PLAN}}": "true" if artifacts["has_plan"] else "false",
         "{{ARTIFACTS_COMPLETE}}": "true" if artifacts["all_complete"] else "false",
-        "{{IS_SELF_EVOLVE}}": "true" if is_self_evolve else "false",
     }
 
     return replacements, effective_resume
@@ -584,7 +561,6 @@ def main():
             "lite": "bootstrap-tier1.md",
             "standard": "bootstrap-tier2.md",
             "full": "bootstrap-tier3.md",
-            "self-evolve": "bootstrap-tier3.md",
         }
         _tier_file = _tier_file_map.get(_mode, "bootstrap-tier2.md")
         _tier_path = os.path.join(script_dir, "..", "templates", _tier_file)

package/bundled/dev-pipeline/templates/bootstrap-tier1.md

@@ -88,8 +88,13 @@ ls .prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md 2>/dev/null && echo "EXI
 
 If MISSING — build it now:
 1. Read `.prizm-docs/root.prizm` and relevant L1 prizm docs
-2. Scan `src/` for files related to this feature; read each one
-3. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
+2. Detect source code directories: read KEY_FILES and STRUCTURE sections from `root.prizm` to identify where source code lives (e.g. `src/`, `app/`, `lib/`, `cmd/`, `packages/`, or project root). If `root.prizm` is missing, scan the project tree:
+   ```bash
+   find . -maxdepth 2 -type f \( -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.rs" \) -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/vendor/*' | head -30
+   ```
+   Identify the top-level source directories from the results.
+3. Scan the detected source directories for files related to this feature; read each one
+4. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
    - **Section 1 — Feature Brief**: feature description + acceptance criteria (copy from above)
    - **Section 2 — Project Structure**: run the following to get a visual directory tree, then paste output:
      ```bash
@@ -108,6 +113,12 @@ ls .prizmkit/specs/{{FEATURE_SLUG}}/ 2>/dev/null
 If plan.md missing, write it directly:
 - `plan.md`: key components, data flow, files to create/modify, and a Tasks section with `[ ]` checkboxes (each task = one implementable unit). Keep under 80 lines.
 
+**Database Design Gate** (if feature involves data persistence — new tables, schema changes, new entities):
+Before proceeding past CP-1:
+1. Scan for existing schema files (`*.prisma`, `*.sql`, `migrations/`, `models/`, `*.entity.*`) and read them
+2. Ensure new tables/fields follow existing naming conventions and constraint patterns
+3. Resolve all uncertain DB design decisions before writing Tasks — document choices in plan.md
+
 **CP-1**: plan.md exists with Tasks section.
 
 ### Phase 3: Implement + Test

package/bundled/dev-pipeline/templates/bootstrap-tier2.md

@@ -38,9 +38,9 @@ You are running in headless mode with a FINITE context window. Exceeding it will
 1. **context-snapshot.md is your single source of truth** — After Phase 1 builds it, ALWAYS read context-snapshot.md instead of re-reading individual source files
 2. **Never re-read your own writes** — After you create/modify a file, do NOT read it back to verify. Trust your write was correct.
 3. **Stay focused** — Do NOT explore code unrelated to this feature. No curiosity-driven reads.
-4. **One task at a time** — In Phase 3 (implement), complete and test one task before starting the next.
+4. **One task at a time** — In Phase 4 (implement), complete and test one task before starting the next.
 5. **Minimize tool output** — When running commands, use `| head -20` or `| tail -20` to limit output. Never dump entire test suites or logs.
-6. **No intermediate commits** — Do NOT run `git add`/`git commit` during Phase 1-4. All changes are committed once at the end in Phase 5 via `/prizmkit-committer`.
+6. **No intermediate commits** — Do NOT run `git add`/`git commit` during Phase 1-5. All changes are committed once at the end in Phase 6 via `/prizmkit-committer`.
 7. **Capture test output once** — When running the test suite, always use `$TEST_CMD 2>&1 | tee /tmp/test-out.txt | tail -20`. Then grep `/tmp/test-out.txt` for details. Never re-run the suite just to apply a different filter.
 
 ---
@@ -90,7 +90,7 @@ cat .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md 2>/dev/null || echo "NO_PREV
 ```
 If failure-log.md exists:
 - Read ROOT_CAUSE and SUGGESTION — adjust your approach accordingly
-- Read DISCOVERED_TRAPS — if any are genuine, inject into .prizm-docs/ during Phase 5 retrospective
+- Read DISCOVERED_TRAPS — if any are genuine, inject into .prizm-docs/ during Phase 6 retrospective
 - Do NOT delete failure-log.md until this session completes all phases and commits successfully
 
 ```bash
@@ -99,8 +99,13 @@ ls .prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md 2>/dev/null && echo "EXI
 
 If MISSING — build it now:
 1. Read `.prizm-docs/root.prizm` and relevant L1/L2 prizm docs
-2. Scan `src/` for files related to this feature; read each one
-3. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
+2. Detect source code directories: read KEY_FILES and STRUCTURE sections from `root.prizm` to identify where source code lives (e.g. `src/`, `app/`, `lib/`, `cmd/`, `packages/`, or project root). If `root.prizm` is missing, scan the project tree:
+   ```bash
+   find . -maxdepth 2 -type f \( -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.rs" \) -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/vendor/*' | head -30
+   ```
+   Identify the top-level source directories from the results.
+3. Scan the detected source directories for files related to this feature; read each one
+4. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
    - **Section 1 — Feature Brief**: feature description + acceptance criteria (copy from above)
    - **Section 2 — Project Structure**: run the following to get a visual directory tree, then paste output:
      ```bash
@@ -111,12 +116,12 @@ If MISSING — build it now:
      ### Files to Modify
      | File | Why Needed | Key Interfaces |
      |------|-----------|----------------|
-     | `src/config.js` | Add runtime config layer | `config` (Zod object), `configSchema` |
+     | `<source-dir>/config.js` | Add runtime config layer | `config` (Zod object), `configSchema` |
 
      ### Files for Reference
      | File | Why Needed | Key Interfaces |
      |------|-----------|----------------|
-     | `src/security/permission-guard.js` | Permission check integration | `checkCommandPermission(userId, cmd)` |
+     | `<source-dir>/security/permission-guard.js` | Permission check integration | `checkCommandPermission(userId, cmd)` |
 
      ### Known TRAPS (from .prizm-docs/)
      - <trap entries extracted from L1/L2 docs>
@@ -139,7 +144,23 @@ Before proceeding past CP-1, verify:
 
 **CP-1**: plan.md exists with Tasks section.
 
-### Phase 3: Implement — Dev Subagent
+### Phase 3: Analyze — Reviewer Subagent
+
+Spawn Reviewer agent (Agent tool, subagent_type="prizm-dev-team-reviewer", run_in_background=false).
+
+Prompt:
+> "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
+> 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST — Section 3 has project context, Section 4 has file manifest.
+> 2. Run prizmkit-analyze: cross-check `plan.md` (including Tasks section) against feature description and acceptance criteria for consistency.
+> 3. Before flagging CRITICAL or HIGH issues, read the relevant source files listed in the File Manifest to verify.
+> Report: CRITICAL, HIGH, MEDIUM issues found (or 'No issues found')."
+
+Wait for Reviewer to return.
+- If CRITICAL issues found: fix them yourself — read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` for full project context. Fix ONLY the listed CRITICAL issues in plan.md. Then re-run analyze (max 1 round).
+
+**CP-2**: No CRITICAL issues.
+
+### Phase 4: Implement — Dev Subagent
 
 **Build artifacts rule** (passed to Dev): After any build/compile command (`go build`, `npm run build`, `tsc`, etc.), ensure the output binary or build directory is in `.gitignore`. Never commit compiled binaries, build output, or generated artifacts.
 
@@ -171,7 +192,7 @@ grep -q "## Implementation Log" .prizmkit/specs/{{FEATURE_SLUG}}/context-snapsho
 ```
 If GATE:MISSING — send message to Dev (re-spawn if needed): "Write the '## Implementation Log' section to context-snapshot.md before I can proceed to review. Include: files changed/created, key decisions, deviations from plan, notable discoveries."
 
-### Phase 4: Review + Test — Reviewer Subagent
+### Phase 5: Review + Test — Reviewer Subagent
 
 Spawn Reviewer subagent (Agent tool, subagent_type="prizm-dev-team-reviewer", run_in_background=false).
 
@@ -198,29 +219,29 @@ If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write the '#
 
 - If NEEDS_FIXES: spawn Dev to fix (Dev reads Fix Instructions in snapshot), re-run Review (max 3 rounds)
 
-**CP-2**: Tests pass, verdict is not NEEDS_FIXES.
+**CP-3**: Tests pass, verdict is not NEEDS_FIXES.
 
-### Phase 5: Architecture Sync & Commit (SINGLE COMMIT)
+### Phase 6: Architecture Sync & Commit (SINGLE COMMIT)
 
-**5a.** Run `/prizmkit-retrospective` — maintains `.prizm-docs/` (architecture index):
+**6a.** Run `/prizmkit-retrospective` — maintains `.prizm-docs/` (architecture index):
 1. **Structural sync**: Use `git diff --cached --name-status` to locate changed modules, update KEY_FILES/INTERFACES/DEPENDENCIES/file counts in affected `.prizm-docs/` files
 2. **Architecture knowledge** (feature sessions only): Extract TRAPS/RULES/DECISIONS from completed work into `.prizm-docs/`
 3. Stage doc changes: `git add .prizm-docs/`
 ⚠️ Do NOT commit here. Only stage.
 
-**5b.** Stage all feature code explicitly (NEVER use `git add -A` or `git add .`):
+**6b.** Stage all feature code explicitly (NEVER use `git add -A` or `git add .`):
 ```bash
 git add <specific-files-created-or-modified>
 git add .prizm-docs/
 ```
 
-**5c.** Run `/prizmkit-committer` → THE ONLY commit for this feature:
+**6c.** Run `/prizmkit-committer` → THE ONLY commit for this feature:
 `feat({{FEATURE_ID}}): {{FEATURE_TITLE}}`
 This single commit includes: feature code + tests + .prizm-docs/ updates. Do NOT push.
 - MANDATORY: commit must be done via `/prizmkit-committer` skill. Do NOT run manual `git add`/`git commit` as a substitute.
 - Do NOT run `update-feature-status.py` here — the pipeline runner handles feature-list.json updates automatically after session exit.
 
-**5d.** Final verification:
+**6d.** Final verification:
 ```bash
 git status --short
 ```
@@ -260,13 +281,13 @@ rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
 
 ## Reminders
 
-- Tier 2: orchestrator builds context+plan, Dev implements, Reviewer reviews+tests — use direct Agent spawn for agents
+- Tier 2: orchestrator builds context+plan, Analyzer checks consistency, Dev implements, Reviewer reviews+tests — use direct Agent spawn for agents
 - Build context-snapshot.md FIRST; all subagents read it instead of re-reading source files
 - context-snapshot.md is append-only: orchestrator writes Sections 1-4, Dev appends Implementation Log, Reviewer appends Review Notes
 - Gate checks enforce Implementation Log and Review Notes are written before proceeding
 - Do NOT use `run_in_background=true` when spawning subagents
 - `/prizmkit-committer` is mandatory, and must not be replaced with manual git commit commands
-- Do NOT run `git add`/`git commit` during Phase 1-4 — all changes are committed once in Phase 5
+- Do NOT run `git add`/`git commit` during Phase 1-5 — all changes are committed once in Phase 6
 - If any files remain after the commit, amend the existing commit — do NOT create a follow-up commit
 - When staging files, always use explicit file names — NEVER use `git add -A` or `git add .`
 - On timeout: check snapshot + git diff HEAD → model:lite → remaining steps only → max 2 retries per phase → orchestrator fallback

package/bundled/dev-pipeline/templates/bootstrap-tier3.md

@@ -31,38 +31,6 @@ You are the **session orchestrator**. Implement Feature {{FEATURE_ID}}: "{{FEATU
 
 {{GLOBAL_CONTEXT}}
 
-{{IF_MODE_SELF_EVOLVE}}
-## Framework Self-Development Context
-
-**You are developing the PrizmKit framework itself.** This is NOT a regular project — you are modifying the tool that powers this pipeline. Extra guardrails apply.
-
-### Framework Structure
-
-```
-core/skills/          — Skill definitions (each has _metadata.json)
-core/agents/          — Agent .md definitions (YAML frontmatter required)
-core/team/            — Team config (dev repo only, NOT installed)
-dev-pipeline/         — Pipeline scripts + templates (installed with --pipeline)
-  templates/          — Bootstrap prompt templates (tier1/2/3)
-  scripts/            — Python/bash pipeline scripts
-create-prizmkit/      — npm package / CLI installer
-  bundled/            — Pre-bundled assets (auto-generated, NEVER edit directly)
-tests/                — Validation + unit tests
-```
-
-### 5 Key Invariants (MUST be preserved)
-
-1. **Skill ↔ _metadata.json 1:1 mapping**: Every directory in `core/skills/` MUST have a `_metadata.json`. Every `_metadata.json` must reference an existing skill directory.
-2. **Template variables resolve completely**: All `{{PLACEHOLDER}}` in `dev-pipeline/templates/` must be resolvable by `generate-bootstrap-prompt.py`. No unresolved placeholders in output.
-3. **Agent YAML frontmatter is valid**: Every `.md` in `core/agents/` must have valid YAML frontmatter with required fields (name, description, tools).
-4. **Bundle is generated, never hand-edited**: `create-prizmkit/bundled/` is auto-generated by `scripts/bundle.js`. Manual edits will be overwritten.
-5. **CI must pass**: `npm run ci` (validate-all + bundle + verify-bundle + eslint + vitest) must pass after every change.
-
-### Version Isolation
-
-LLM context is frozen at prompt time. Modifying a skill source file during this session will NOT change the behavior of that skill within this session. The real risk is structural inconsistency.
-{{END_IF_MODE_SELF_EVOLVE}}
-
 ## ⚠️ Context Budget Rules (CRITICAL — read before any phase)
 
 You are running in headless mode with a FINITE context window. Exceeding it will crash the session and lose all work. Follow these rules strictly:
@@ -165,9 +133,9 @@ ls .prizmkit/specs/{{FEATURE_SLUG}}/ 2>/dev/null
 - `context-snapshot.md` exists → use it directly, skip Phase 1
 - Some missing → generate only missing files
 
-Before planning, check whether feature code already exists in the project:
+Before planning, check whether feature code already exists in the project (search in source directories identified from `root.prizm` or the project tree scan):
 ```bash
-grep -r "{{FEATURE_SLUG}}" src/ --include="*.js" --include="*.ts" -l 2>/dev/null | head -20
+grep -r "{{FEATURE_SLUG}}" . --include="*.js" --include="*.ts" --include="*.py" --include="*.go" --include="*.java" --include="*.rb" --include="*.rs" -l --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=dist --exclude-dir=build --exclude-dir=vendor --exclude-dir=.prizmkit 2>/dev/null | head -20
 ```
 
 Record result as `EXISTING_CODE` (list of files, or empty).
@@ -177,8 +145,13 @@ If `EXISTING_CODE` is non-empty: your spec/plan/tasks must reflect this existing
 **Step A — Build Context Snapshot** (skip if `context-snapshot.md` already exists):
 
 1. Read `.prizm-docs/root.prizm` and relevant L1/L2 prizm docs
-2. Scan `src/` for files related to this feature; read each one
-3. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
+2. Detect source code directories: read KEY_FILES and STRUCTURE sections from `root.prizm` to identify where source code lives (e.g. `src/`, `app/`, `lib/`, `cmd/`, `packages/`, or project root). If `root.prizm` is missing, scan the project tree:
+   ```bash
+   find . -maxdepth 2 -type f \( -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.go" -o -name "*.java" -o -name "*.rb" -o -name "*.rs" \) -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/vendor/*' | head -30
+   ```
+   Identify the top-level source directories from the results.
+3. Scan the detected source directories for files related to this feature; read each one
+4. Write `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md`:
    - **Section 1 — Feature Brief**: feature description + acceptance criteria (copy from above)
    - **Section 2 — Project Structure**: run the following to get a visual directory tree, then paste output:
      ```bash
@@ -189,12 +162,12 @@ If `EXISTING_CODE` is non-empty: your spec/plan/tasks must reflect this existing
      ### Files to Modify
      | File | Why Needed | Key Interfaces |
      |------|-----------|----------------|
-     | `src/config.js` | Add runtime config layer | `config` (Zod object), `configSchema` |
+     | `<source-dir>/config.js` | Add runtime config layer | `config` (Zod object), `configSchema` |
 
      ### Files for Reference
      | File | Why Needed | Key Interfaces |
      |------|-----------|----------------|
-     | `src/security/permission-guard.js` | Permission check integration | `checkCommandPermission(userId, cmd)` |
+     | `<source-dir>/security/permission-guard.js` | Permission check integration | `checkCommandPermission(userId, cmd)` |
 
      ### Known TRAPS (from .prizm-docs/)
      - <trap entries extracted from L1/L2 docs>
@@ -214,6 +187,13 @@ ls .prizmkit/specs/{{FEATURE_SLUG}}/spec.md .prizmkit/specs/{{FEATURE_SLUG}}/pla
 
 > All files go under `.prizmkit/specs/{{FEATURE_SLUG}}/`. Confirm each with `ls` after writing.
 
+**Database Design Gate** (if feature involves data persistence — new tables, schema changes, new entities):
+Before proceeding past CP-1, verify:
+1. Plan.md Data Model section references existing schema/model files (scan for `*.prisma`, `*.sql`, `migrations/`, `models/`, `*.entity.*` files; read them if not already in context-snapshot)
+2. All new tables/fields follow existing naming conventions, ID strategy, timestamp patterns, and constraint style
+3. No `[NEEDS CLARIFICATION]` remains in Data Model section — resolve by reading existing code and making a conservative choice that matches existing patterns. Document the resolution in plan.md.
+4. If a DB design decision genuinely cannot be resolved from existing code alone, document the assumption made and flag it in the Implementation Log for user review.
+
 **CP-1**: Both spec.md and plan.md exist.
 
 ### Phase 3: Analyze — Reviewer Agent
@@ -245,17 +225,6 @@ grep -c '^\- \[ \]' .prizmkit/specs/{{FEATURE_SLUG}}/plan.md 2>/dev/null || echo
 
 Spawn Dev agent (Agent tool, subagent_type="prizm-dev-team-dev", run_in_background=false).
 
-{{IF_MODE_SELF_EVOLVE}}
-**Framework Self-Evolve — Dev Extra Instructions**:
-Append the following to the Dev agent prompt:
-> "FRAMEWORK RULES (self-evolve mode):
-> - If you modify any file in `core/skills/`, also update `_metadata.json` in the same skill directory.
-> - If you modify `dev-pipeline/templates/*.md`, verify all `{{PLACEHOLDER}}` markers have matching entries in `generate-bootstrap-prompt.py`.
-> - Before marking implementation complete, run `node tests/validate-all.js` and fix any failures.
-> - NEVER directly modify files in `create-prizmkit/bundled/` — those are auto-generated by `scripts/bundle.js`.
-> - If you modify any file in `dev-pipeline/scripts/` or `dev-pipeline/templates/` or `core/skills/` that this pipeline uses, note this in your Implementation Log for reload_needed tracking."
-{{END_IF_MODE_SELF_EVOLVE}}
-
 Prompt:
 > "Read {{DEV_SUBAGENT_PATH}}. Implement feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}) using TDD.
 > **IMPORTANT**: Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST.
@@ -298,18 +267,6 @@ All tasks `[x]`, tests pass.
 
 Spawn Reviewer agent (Agent tool, subagent_type="prizm-dev-team-reviewer", run_in_background=false).
 
-{{IF_MODE_SELF_EVOLVE}}
-**Framework Self-Evolve — Reviewer Extra Instructions**:
-Append the following to the Reviewer agent prompt:
-> "FRAMEWORK REVIEW DIMENSIONS (self-evolve mode):
-> In addition to standard code review, check:
-> 1. **Structural integrity**: Every `core/skills/*/` must have `_metadata.json`. Run `node tests/validate-all.js` to verify.
-> 2. **Template safety**: If any `dev-pipeline/templates/*.md` was modified, check that all `{{PLACEHOLDER}}` markers are properly balanced (open/close) and resolvable.
-> 3. **Agent frontmatter**: If any `core/agents/*.md` was modified, validate YAML frontmatter has required fields (name, description, tools).
-> 4. **CI gate**: Run `npm run ci` and report the result. Any failure is CRITICAL.
-> 5. **Bundle safety**: Verify no files in `create-prizmkit/bundled/` were directly modified (check `git diff --name-only` for bundled/ changes)."
-{{END_IF_MODE_SELF_EVOLVE}}
-
 Prompt:
 > "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 > **IMPORTANT**: Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST.
@@ -346,20 +303,6 @@ If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write the '#
 
 ### Phase 6: Retrospective & Commit (SINGLE COMMIT) — DO NOT SKIP
 
-{{IF_MODE_SELF_EVOLVE}}
-**Framework Validation Gate (self-evolve mode)**:
-
-Before proceeding with commit, run the full framework CI pipeline:
-
-```bash
-bash {{VALIDATOR_SCRIPTS_DIR}}/validate-framework.sh
-```
-
-- If ALL steps pass → proceed with commit below.
-- If any step fails → fix the issue and re-run. Maximum 2 fix-and-retry rounds.
-- After 2 failed rounds → exit and let the pipeline runner handle the failure.
-{{END_IF_MODE_SELF_EVOLVE}}
-
 **For bug fixes**: run `/prizmkit-retrospective` for structural sync only (skip knowledge injection unless a new TRAPS was discovered). Use `fix(<scope>):` commit prefix.
 
 **6a.** Check if feature already committed:

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

@@ -191,17 +191,3 @@ class TestProcessModeBlocks:
         tpl = "{{IF_INIT_NEEDED}}\nneed init\n{{END_IF_INIT_NEEDED}}"
         result = process_mode_blocks(tpl, "standard", init_done=False)
         assert "need init" in result
-
-    def test_self_evolve_keeps_self_evolve_and_full(self):
-        tpl = (
-            "{{IF_MODE_SELF_EVOLVE}}se content{{END_IF_MODE_SELF_EVOLVE}}"
-            "{{IF_MODE_FULL}}full content{{END_IF_MODE_FULL}}"
-        )
-        result = process_mode_blocks(tpl, "self-evolve", init_done=True)
-        assert "se content" in result
-        assert "full content" in result
-
-    def test_self_evolve_removes_lite(self):
-        tpl = "{{IF_MODE_LITE}}lite content{{END_IF_MODE_LITE}}"
-        result = process_mode_blocks(tpl, "self-evolve", init_done=True)
-        assert "lite content" not in result