prizmkit 1.1.6 → 1.1.8

package/bundled/skills/prizmkit-verify/scripts/verify-light.py

@@ -0,0 +1,402 @@
+#!/usr/bin/env python3
+"""PrizmKit Light Verification Script — static checks for framework integrity.
+
+Usage:
+    python3 verify-light.py                    # Run all rounds
+    python3 verify-light.py --round R1         # Run specific round
+    python3 verify-light.py --round R1 R2 R4   # Run multiple rounds
+"""
+
+import argparse
+import json
+import os
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+# --- Configuration ---
+
+PROJECT_ROOT = Path(__file__).resolve().parents[5]  # core/skills/prizmkit-skill/prizmkit-verify/scripts/verify-light.py → root (5 levels up)
+
+SKILL_LAYER_DIR = PROJECT_ROOT / "core" / "skills" / "prizmkit-skill"
+PIPELINE_LAYER_DIR = PROJECT_ROOT / "core" / "skills" / "orchestration-skill" / "pipelines"
+WORKFLOW_LAYER_DIR = PROJECT_ROOT / "core" / "skills" / "orchestration-skill" / "workflows"
+DEV_PIPELINE_DIR = PROJECT_ROOT / "dev-pipeline"
+ALL_SKILLS_DIR = PROJECT_ROOT / "core" / "skills"
+
+# Expected items per layer
+EXPECTED_PIPELINE_SKILLS = {
+    "app-planner", "feature-planner", "bug-planner", "refactor-planner",
+    "feature-pipeline-launcher", "bugfix-pipeline-launcher", "refactor-pipeline-launcher",
+}
+EXPECTED_WORKFLOW_SKILLS = {
+    "feature-workflow", "bug-fix-workflow", "refactor-workflow", "recovery-workflow",
+}
+
+# --- Helpers ---
+
+class Result:
+    def __init__(self):
+        self.passed = 0
+        self.warned = 0
+        self.failed = 0
+        self.details = []
+
+    def ok(self, msg):
+        self.passed += 1
+        self.details.append(("PASS", msg))
+
+    def warn(self, msg):
+        self.warned += 1
+        self.details.append(("WARN", msg))
+
+    def fail(self, msg):
+        self.failed += 1
+        self.details.append(("FAIL", msg))
+
+    @property
+    def status(self):
+        if self.failed > 0:
+            return "FAIL"
+        if self.warned > 0:
+            return "WARN"
+        return "PASS"
+
+    def summary(self):
+        return f"PASS={self.passed} WARN={self.warned} FAIL={self.failed}"
+
+
+def parse_frontmatter(skill_md_path):
+    """Extract YAML frontmatter from SKILL.md."""
+    text = skill_md_path.read_text(encoding="utf-8")
+    match = re.match(r"^---\n(.*?)\n---", text, re.DOTALL)
+    if not match:
+        return {}
+    fm = {}
+    for line in match.group(1).split("\n"):
+        if ":" in line:
+            key, val = line.split(":", 1)
+            fm[key.strip()] = val.strip().strip('"').strip("'")
+    return fm
+
+
+def find_skill_dirs(base_dir):
+    """Find all directories containing SKILL.md under base_dir."""
+    return sorted(
+        d for d in base_dir.iterdir()
+        if d.is_dir() and (d / "SKILL.md").exists()
+    )
+
+
+def collect_all_skill_names():
+    """Collect all known skill names across all categories."""
+    names = set()
+    for category_dir in ALL_SKILLS_DIR.iterdir():
+        if not category_dir.is_dir() or category_dir.name.startswith("."):
+            continue
+        # Direct skill dirs
+        for d in category_dir.iterdir():
+            if d.is_dir() and (d / "SKILL.md").exists():
+                names.add(d.name)
+            # Nested (pipelines/, workflows/)
+            if d.is_dir() and not (d / "SKILL.md").exists():
+                for sub in d.iterdir():
+                    if sub.is_dir() and (sub / "SKILL.md").exists():
+                        names.add(sub.name)
+    return names
+
+
+# --- Round Checks ---
+
+def run_r1(result: Result):
+    """R1: L1 Skill Layer Light checks."""
+    print("\n=== R1: L1 Skill Layer ===")
+    skill_dirs = find_skill_dirs(SKILL_LAYER_DIR)
+    all_skill_names = collect_all_skill_names()
+
+    if not skill_dirs:
+        result.fail("No skill directories found in prizmkit-skill/")
+        return
+
+    print(f"  Found {len(skill_dirs)} skills")
+
+    for skill_dir in skill_dirs:
+        skill_name = skill_dir.name
+        skill_md = skill_dir / "SKILL.md"
+
+        # 1. Frontmatter validation
+        fm = parse_frontmatter(skill_md)
+        if not fm.get("name"):
+            result.fail(f"[{skill_name}] Missing 'name' in frontmatter")
+        elif fm["name"] != skill_name:
+            result.fail(f"[{skill_name}] name '{fm['name']}' != dir '{skill_name}'")
+        else:
+            result.ok(f"[{skill_name}] Frontmatter name OK")
+
+        if not fm.get("description"):
+            result.fail(f"[{skill_name}] Missing 'description' in frontmatter")
+        else:
+            result.ok(f"[{skill_name}] Frontmatter description OK")
+
+        # 2. ${SKILL_DIR} reference resolution
+        content = skill_md.read_text(encoding="utf-8")
+        refs = re.findall(r'\$\{SKILL_DIR\}/([^\s`"\')]+)', content)
+        for ref in refs:
+            resolved = skill_dir / ref
+            if resolved.exists():
+                result.ok(f"[{skill_name}] Asset ref '{ref}' exists")
+            else:
+                result.fail(f"[{skill_name}] Asset ref '{ref}' NOT FOUND at {resolved}")
+
+        # 3. Cross-skill references
+        cross_refs = re.findall(r'(?<!\w)/prizmkit-[\w-]+(?=[\s`"\',\)])', content)
+        for ref in cross_refs:
+            ref_name = ref.lstrip("/")
+            if ref_name in all_skill_names:
+                result.ok(f"[{skill_name}] Cross-ref '{ref_name}' exists")
+            else:
+                result.warn(f"[{skill_name}] Cross-ref '{ref_name}' not found as skill dir")
+
+    # 4. ESLint
+    try:
+        lint_result = subprocess.run(
+            ["npm", "run", "lint"], capture_output=True, text=True,
+            cwd=str(PROJECT_ROOT), timeout=30,
+        )
+        errors = len(re.findall(r"(\d+) error[^s]", lint_result.stdout + lint_result.stderr))
+        if lint_result.returncode == 0 or errors == 0:
+            result.ok("ESLint: 0 errors")
+        else:
+            result.fail(f"ESLint: {errors} errors found")
+    except (subprocess.TimeoutExpired, FileNotFoundError) as e:
+        result.warn(f"ESLint: could not run ({e})")
+
+    # 5. Ruff
+    try:
+        ruff_result = subprocess.run(
+            ["npm", "run", "lint:py"], capture_output=True, text=True,
+            cwd=str(PROJECT_ROOT), timeout=30,
+        )
+        if ruff_result.returncode == 0:
+            result.ok("Ruff: all checks passed")
+        else:
+            result.fail(f"Ruff: {ruff_result.stdout.strip()}")
+    except (subprocess.TimeoutExpired, FileNotFoundError) as e:
+        result.warn(f"Ruff: could not run ({e})")
+
+
+def run_r2(result: Result):
+    """R2: L2 Pipeline Layer Light checks."""
+    print("\n=== R2: L2 Pipeline Layer ===")
+    skill_dirs = find_skill_dirs(PIPELINE_LAYER_DIR)
+    found_names = {d.name for d in skill_dirs}
+
+    # Check expected skills present
+    for expected in EXPECTED_PIPELINE_SKILLS:
+        if expected in found_names:
+            result.ok(f"[{expected}] Skill exists")
+        else:
+            result.fail(f"[{expected}] Expected skill NOT FOUND")
+
+    # Frontmatter validation
+    for skill_dir in skill_dirs:
+        fm = parse_frontmatter(skill_dir / "SKILL.md")
+        if fm.get("name") == skill_dir.name and fm.get("description"):
+            result.ok(f"[{skill_dir.name}] Frontmatter OK")
+        else:
+            result.fail(f"[{skill_dir.name}] Frontmatter invalid: {fm}")
+
+    # Schema version consistency
+    scenarios = [
+        ("feature", "feature-list-schema.json", "init-pipeline.py"),
+        ("bugfix", "bug-fix-list-schema.json", "init-bugfix-pipeline.py"),
+        ("refactor", "refactor-list-schema.json", "init-refactor-pipeline.py"),
+    ]
+    for scenario, schema_file, init_script in scenarios:
+        schema_path = DEV_PIPELINE_DIR / "templates" / schema_file
+        init_path = DEV_PIPELINE_DIR / "scripts" / init_script
+
+        if not schema_path.exists():
+            result.fail(f"[{scenario}] Schema file missing: {schema_file}")
+            continue
+        if not init_path.exists():
+            result.fail(f"[{scenario}] Init script missing: {init_script}")
+            continue
+
+        # Extract schema const value
+        try:
+            schema_data = json.loads(schema_path.read_text())
+            schema_const = (
+                schema_data.get("properties", {})
+                .get("$schema", {})
+                .get("const", "NOT_FOUND")
+            )
+        except json.JSONDecodeError:
+            result.fail(f"[{scenario}] Schema file is not valid JSON")
+            continue
+
+        # Extract expected schema from init script
+        init_content = init_path.read_text()
+        match = re.search(r'EXPECTED_SCHEMA\s*=\s*["\']([^"\']+)', init_content)
+        init_expected = match.group(1) if match else "NOT_FOUND"
+
+        if schema_const == init_expected:
+            result.ok(f"[{scenario}] Schema version match: {schema_const}")
+        else:
+            result.fail(f"[{scenario}] Schema version MISMATCH: template={schema_const}, init={init_expected}")
+
+    # Launcher script path references
+    for scenario, script in [("feature", "run-feature.sh"), ("bugfix", "run-bugfix.sh"), ("refactor", "run-refactor.sh")]:
+        script_path = DEV_PIPELINE_DIR / script
+        if script_path.exists() and os.access(script_path, os.X_OK):
+            result.ok(f"[{scenario}] Script {script} exists and executable")
+        elif script_path.exists():
+            result.warn(f"[{scenario}] Script {script} exists but NOT executable")
+        else:
+            result.fail(f"[{scenario}] Script {script} NOT FOUND")
+
+
+def run_r3(result: Result):
+    """R3: L3 Workflow Layer Light checks."""
+    print("\n=== R3: L3 Workflow Layer ===")
+    skill_dirs = find_skill_dirs(WORKFLOW_LAYER_DIR)
+    found_names = {d.name for d in skill_dirs}
+    pipeline_names = {d.name for d in find_skill_dirs(PIPELINE_LAYER_DIR)}
+
+    # Check expected skills
+    for expected in EXPECTED_WORKFLOW_SKILLS:
+        if expected in found_names:
+            result.ok(f"[{expected}] Workflow exists")
+        else:
+            result.fail(f"[{expected}] Expected workflow NOT FOUND")
+
+    for skill_dir in skill_dirs:
+        skill_name = skill_dir.name
+        skill_md = skill_dir / "SKILL.md"
+
+        # Frontmatter
+        fm = parse_frontmatter(skill_md)
+        if fm.get("name") == skill_name and fm.get("description"):
+            result.ok(f"[{skill_name}] Frontmatter OK")
+        else:
+            result.fail(f"[{skill_name}] Frontmatter invalid")
+
+        # Pipeline skill references
+        content = skill_md.read_text(encoding="utf-8")
+        for pipeline_ref in re.findall(r'`([\w-]+-planner|[\w-]+-pipeline-launcher)`', content):
+            if pipeline_ref in pipeline_names:
+                result.ok(f"[{skill_name}] Pipeline ref '{pipeline_ref}' exists")
+            else:
+                result.warn(f"[{skill_name}] Pipeline ref '{pipeline_ref}' not found")
+
+        # Checkpoint naming
+        checkpoints = re.findall(r'CP-\w+-\d+', content)
+        if checkpoints:
+            result.ok(f"[{skill_name}] {len(checkpoints)} checkpoints found (CP-*-N pattern)")
+        else:
+            result.warn(f"[{skill_name}] No checkpoint markers found")
+
+
+def run_r4(result: Result):
+    """R4: L4 Script Layer Light checks."""
+    print("\n=== R4: L4 Script Layer ===")
+
+    # 1. Shell scripts executable
+    for sh_file in sorted(DEV_PIPELINE_DIR.glob("*.sh")):
+        if os.access(sh_file, os.X_OK):
+            result.ok(f"[{sh_file.name}] Executable")
+        else:
+            result.fail(f"[{sh_file.name}] NOT executable")
+
+    # 2. Python scripts compile
+    scripts_dir = DEV_PIPELINE_DIR / "scripts"
+    if scripts_dir.exists():
+        for py_file in sorted(scripts_dir.glob("*.py")):
+            try:
+                subprocess.run(
+                    [sys.executable, "-m", "py_compile", str(py_file)],
+                    capture_output=True, text=True, timeout=10,
+                )
+                result.ok(f"[{py_file.name}] Compiles OK")
+            except subprocess.TimeoutExpired:
+                result.warn(f"[{py_file.name}] Compile check timed out")
+
+    # 3. Bash lib sourcing
+    for run_script in ["run-feature.sh", "run-bugfix.sh", "run-refactor.sh"]:
+        script_path = DEV_PIPELINE_DIR / run_script
+        if not script_path.exists():
+            result.fail(f"[{run_script}] NOT FOUND")
+            continue
+        content = script_path.read_text(encoding="utf-8")
+        for lib in ["common.sh", "heartbeat.sh", "branch.sh"]:
+            if lib in content:
+                result.ok(f"[{run_script}] Sources {lib}")
+            else:
+                result.fail(f"[{run_script}] Does NOT source {lib}")
+
+    # 4. JSON templates valid
+    templates_dir = DEV_PIPELINE_DIR / "templates"
+    if templates_dir.exists():
+        for json_file in sorted(templates_dir.glob("*.json")):
+            try:
+                json.loads(json_file.read_text())
+                result.ok(f"[{json_file.name}] Valid JSON")
+            except json.JSONDecodeError as e:
+                result.fail(f"[{json_file.name}] Invalid JSON: {e}")
+
+    # 5. Test file existence
+    tests_dir = DEV_PIPELINE_DIR / "tests"
+    if tests_dir.exists():
+        test_files = list(tests_dir.glob("test_*.py"))
+        if test_files:
+            result.ok(f"Test files found: {len(test_files)}")
+        else:
+            result.warn("No test_*.py files found in dev-pipeline/tests/")
+    else:
+        result.warn("dev-pipeline/tests/ directory not found")
+
+
+# --- Main ---
+
+def main():
+    parser = argparse.ArgumentParser(description="PrizmKit Light Verification")
+    parser.add_argument("--round", nargs="*", default=["R1", "R2", "R3", "R4"],
+                        help="Rounds to run (R1, R2, R3, R4)")
+    args = parser.parse_args()
+
+    rounds_to_run = [r.upper() for r in args.round]
+    result = Result()
+
+    round_map = {"R1": run_r1, "R2": run_r2, "R3": run_r3, "R4": run_r4}
+
+    for round_name in rounds_to_run:
+        if round_name in round_map:
+            round_map[round_name](result)
+        else:
+            print(f"  Unknown round: {round_name}")
+
+    # Print results
+    print("\n" + "=" * 60)
+    print(f"  RESULT: {result.status}")
+    print(f"  {result.summary()}")
+    print("=" * 60)
+
+    if result.failed > 0:
+        print("\n  FAILURES:")
+        for status, msg in result.details:
+            if status == "FAIL":
+                print(f"    {msg}")
+
+    if result.warned > 0:
+        print("\n  WARNINGS:")
+        for status, msg in result.details:
+            if status == "WARN":
+                print(f"    {msg}")
+
+    print()
+    return 0 if result.failed == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/bundled/skills/recovery-workflow/SKILL.md

@@ -25,8 +25,8 @@ User says:
 | Workflow | Branch Pattern | Key Artifacts |
 |----------|---------------|---------------|
 | bug-fix-workflow | `fix/<BUG_ID>-*` | `.prizmkit/bugfix/<BUG_ID>/fix-plan.md`, `fix-report.md` |
-| feature-workflow | `feat/*` | `feature-list.json`, `dev-pipeline/state/features/` |
-| refactor-workflow | `refactor/*` | `refactor-list.json`, `dev-pipeline/state/refactors/` |
+| feature-workflow | `feat/*` | `.prizmkit/plans/feature-list.json`, `.prizmkit/state/features/features/` |
+| refactor-workflow | `refactor/*` | `.prizmkit/plans/refactor-list.json`, `.prizmkit/state/refactor/refactors/` |
 
 ---
 
@@ -71,9 +71,9 @@ The script uses **priority-ordered signature matching**:
 1. Current branch matches fix/*           → bug-fix-workflow
 2. .prizmkit/bugfix/ directory has content → bug-fix-workflow
 3. Current branch matches refactor/*       → refactor-workflow
-4. refactor-list.json exists               → refactor-workflow
+4. .prizmkit/plans/refactor-list.json exists               → refactor-workflow
 5. Current branch matches feat/*           → feature-workflow
-6. feature-list.json exists                → feature-workflow
+6. .prizmkit/plans/feature-list.json exists                → feature-workflow
 7. None of the above                       → no workflow detected
 ```
 
@@ -161,6 +161,7 @@ If the user declines, suggest alternatives:
 1. **Read the workflow's SKILL.md** from `core/skills/orchestration-skill/workflows/{workflow-type}/SKILL.md`
 2. **Read existing artifacts** to restore context — check in this order for the most efficient recovery:
    - If `session-summary.md` exists in the artifact directory → read it first. It provides a lightweight summary of completed tasks, key decisions, active TRAPS, and remaining work from the interrupted session.
+     > **Note**: `session-summary.md` is generated by the pipeline's bootstrap prompt system (`generate-bootstrap-prompt.py`) at the end of each AI CLI session. It may not exist if the session crashed before completion or if running in interactive (non-pipeline) mode. If absent, reconstruct context from the artifacts below.
    - Then read remaining artifacts: spec, plan, code diffs, bug descriptions, etc.
 3. **Read relevant `.prizm-docs/`** — load project context (L0 root, relevant L1). If `session-summary.md` was found, use its "Files Changed" section to focus L1/L2 loading on affected modules only.
 
@@ -174,7 +175,7 @@ Phase inference table:
 
 | Detected State | Resume From | Actions |
 |---------------|------------|---------|
-| On `fix/<BUG_ID>-*` branch, no artifacts | Phase 1: Deep Bug Diagnosis | Read bug description from `bug-fix-list.json`. Start interactive diagnosis Q&A |
+| On `fix/<BUG_ID>-*` branch, no artifacts | Phase 1: Deep Bug Diagnosis | Read bug description from `.prizmkit/plans/bug-fix-list.json`. Start interactive diagnosis Q&A |
 | `fix-plan.md` exists, no code changes | Phase 4: Fix | Read fix-plan.md. Implement the fix following the plan |
 | `fix-plan.md` + code changes exist | Phase 5: Review | Invoke `/prizmkit-code-review` on all changes |
 | All docs + review passed | Phase 6: User Verification | Ask user to verify the fix works |
@@ -194,11 +195,11 @@ Phase inference table:
 
 | Detected State | Resume From | Actions |
 |---------------|------------|---------|
-| No `feature-list.json` | Phase 1: Brainstorm | Cannot recover conversation context. Start requirement clarification, but leverage any workspace content (README, existing code) for context |
-| `feature-list.json` exists, no pipeline state | Phase 3: Launch | Invoke `feature-pipeline-launcher` to start the pipeline |
-| `feature-list.json` + pipeline state exists | Phase 4: Monitor | Check pipeline status via `feature-pipeline-launcher` (Intent B: Check Status) |
+| No `.prizmkit/plans/feature-list.json` | Phase 1: Brainstorm | Cannot recover conversation context. Start requirement clarification, but leverage any workspace content (README, existing code) for context |
+| `.prizmkit/plans/feature-list.json` exists, no pipeline state | Phase 3: Launch | Invoke `feature-pipeline-launcher` to start the pipeline |
+| `.prizmkit/plans/feature-list.json` + pipeline state exists | Phase 4: Monitor | Check pipeline status via `feature-pipeline-launcher` (Intent B: Check Status) |
 
-**Note**: Feature-workflow recovery is simpler because Phases 3-4 are pipeline-driven. The main recovery value is avoiding re-brainstorming (Phase 1) when `feature-list.json` already exists.
+**Note**: Feature-workflow recovery is simpler because Phases 3-4 are pipeline-driven. The main recovery value is avoiding re-brainstorming (Phase 1) when `.prizmkit/plans/feature-list.json` already exists.
 
 ---
 
@@ -208,9 +209,9 @@ Phase inference table (mirrors feature-workflow):
 
 | Detected State | Resume From | Actions |
 |---------------|------------|---------|
-| No `refactor-list.json` | Phase 1: Brainstorm | Start refactoring goal clarification |
-| `refactor-list.json` exists, no pipeline state | Phase 3: Launch | Invoke `refactor-pipeline-launcher` to start the pipeline |
-| `refactor-list.json` + pipeline state exists | Phase 4: Monitor | Check pipeline status |
+| No `.prizmkit/plans/refactor-list.json` | Phase 1: Brainstorm | Start refactoring goal clarification |
+| `.prizmkit/plans/refactor-list.json` exists, no pipeline state | Phase 3: Launch | Invoke `refactor-pipeline-launcher` to start the pipeline |
+| `.prizmkit/plans/refactor-list.json` + pipeline state exists | Phase 4: Monitor | Check pipeline status |
 
 ---
 
@@ -242,9 +243,9 @@ Recovery complete.
 | No workflow signature matches | Show guidance message, suggest original workflow skills |
 | Branch exists but artifacts are inconsistent | Trust git as ground truth, report discrepancy in detection report |
 | Test failures in existing code | Report in detection summary; user decides whether to continue |
-| Multiple workflows could match (e.g., on main but both feature-list.json and bug-fix artifacts exist) | Pick highest priority (bug-fix > refactor > feature), mention others in report |
+| Multiple workflows could match (e.g., on main but both .prizmkit/plans/feature-list.json and bug-fix artifacts exist) | Pick highest priority (bug-fix > refactor > feature), mention others in report |
 | Detection script fails | Fall back to manual detection (run individual git/file checks in bash) |
-| Bug ID not found in bug-fix-list.json | Continue with branch-only context; note that full bug description is unavailable |
+| Bug ID not found in .prizmkit/plans/bug-fix-list.json | Continue with branch-only context; note that full bug description is unavailable |
 
 ---
 

package/bundled/skills/recovery-workflow/evals/evals.json

@@ -22,16 +22,16 @@
       "id": 3,
       "name": "feature-list-exists",
       "prompt": "resume",
-      "expected_output": "Should auto-detect feature-workflow from feature-list.json. Should detect feature-list.json exists but no pipeline state → infer Phase 3 (Launch). Should invoke feature-pipeline-launcher to start the pipeline.",
-      "setup_description": "On main branch, create feature-list.json with 3 features. No dev-pipeline/state/features/ directory.",
+      "expected_output": "Should auto-detect feature-workflow from .prizmkit/plans/feature-list.json. Should detect .prizmkit/plans/feature-list.json exists but no pipeline state → infer Phase 3 (Launch). Should invoke feature-pipeline-launcher to start the pipeline.",
+      "setup_description": "On main branch, create .prizmkit/plans/feature-list.json with 3 features. No .prizmkit/state/features/features/ directory.",
       "files": []
     },
     {
       "id": 4,
       "name": "refactor-monitoring",
       "prompt": "pick up where it left off",
-      "expected_output": "Should auto-detect refactor-workflow from refactor-list.json + pipeline state. Should infer Phase 4 (Monitor). Should check pipeline status and report results.",
-      "setup_description": "On main branch, create refactor-list.json with 2 items. Create dev-pipeline/state/refactors/ with status files showing 1 completed, 1 in-progress.",
+      "expected_output": "Should auto-detect refactor-workflow from .prizmkit/plans/refactor-list.json + pipeline state. Should infer Phase 4 (Monitor). Should check pipeline status and report results.",
+      "setup_description": "On main branch, create .prizmkit/plans/refactor-list.json with 2 items. Create .prizmkit/state/refactor/refactors/ with status files showing 1 completed, 1 in-progress.",
       "files": []
     },
     {
@@ -39,7 +39,7 @@
       "name": "no-workflow-detected",
       "prompt": "恢复",
       "expected_output": "Should detect no workflow signatures in workspace. Should display guidance message suggesting /feature-workflow, /bug-fix-workflow, or /refactor-workflow. Should NOT attempt any recovery actions.",
-      "setup_description": "Clean workspace on main branch. No feature-list.json, no bug-fix artifacts, no refactor-list.json, no fix/* or feat/* or refactor/* branches.",
+      "setup_description": "Clean workspace on main branch. No .prizmkit/plans/feature-list.json, no bug-fix artifacts, no .prizmkit/plans/refactor-list.json, no fix/* or feat/* or refactor/* branches.",
       "files": []
     }
   ]

package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py

@@ -85,7 +85,14 @@ def detect_workflow_type(project_root):
         return ("refactor-workflow", {"branch": branch})
 
     # Priority 4: refactor-list.json exists → refactor-workflow
-    if os.path.isfile(os.path.join(project_root, "refactor-list.json")):
+    # Check both new and old paths for backward compatibility
+    new_refactor = os.path.join(project_root, ".prizmkit", "plans", "refactor-list.json")
+    old_refactor = os.path.join(project_root, "refactor-list.json")
+    if os.path.isfile(new_refactor):
+        return ("refactor-workflow", {"branch": branch})
+    elif os.path.isfile(old_refactor):
+        print(f"⚠️  Migration notice: refactor-list.json found in root. "
+              f"Please move to .prizmkit/plans/refactor-list.json", file=sys.stderr)
         return ("refactor-workflow", {"branch": branch})
 
     # Priority 5: feat/* branch → feature-workflow
@@ -93,7 +100,14 @@ def detect_workflow_type(project_root):
         return ("feature-workflow", {"branch": branch})
 
     # Priority 6: feature-list.json exists → feature-workflow
-    if os.path.isfile(os.path.join(project_root, "feature-list.json")):
+    # Check both new and old paths for backward compatibility
+    new_feature = os.path.join(project_root, ".prizmkit", "plans", "feature-list.json")
+    old_feature = os.path.join(project_root, "feature-list.json")
+    if os.path.isfile(new_feature):
+        return ("feature-workflow", {"branch": branch})
+    elif os.path.isfile(old_feature):
+        print(f"⚠️  Migration notice: feature-list.json found in root. "
+              f"Please move to .prizmkit/plans/feature-list.json", file=sys.stderr)
         return ("feature-workflow", {"branch": branch})
 
     # No match
@@ -164,10 +178,27 @@ def _infer_pipeline_workflow_phase(project_root, list_filename, state_subdir, wo
       No list file                → Phase 1: Brainstorm
       List file, no pipeline state → Phase 3: Launch
       List file + pipeline state   → Phase 4: Monitor
+
+    Checks new path (.prizmkit/plans/<list_filename>) first, then falls back
+    to old root-level path with a migration warning.
     """
-    has_list = os.path.isfile(os.path.join(project_root, list_filename))
-    state_dir = os.path.join(project_root, "dev-pipeline", "state", state_subdir)
-    has_pipeline_state = os.path.isdir(state_dir) and bool(os.listdir(state_dir))
+    # Check new path first, then old path with fallback warning
+    new_list_path = os.path.join(project_root, ".prizmkit", "plans", list_filename)
+    old_list_path = os.path.join(project_root, list_filename)
+    has_list = os.path.isfile(new_list_path)
+    if not has_list and os.path.isfile(old_list_path):
+        has_list = True
+        print(f"⚠️  Migration notice: {list_filename} found in root. "
+              f"Please move to .prizmkit/plans/{list_filename}", file=sys.stderr)
+
+    # Check new state path first, then old path with fallback warning
+    new_state_dir = os.path.join(project_root, ".prizmkit", "state", state_subdir)
+    old_state_dir = os.path.join(project_root, "dev-pipeline", "state", state_subdir)
+    has_pipeline_state = os.path.isdir(new_state_dir) and bool(os.listdir(new_state_dir))
+    if not has_pipeline_state and os.path.isdir(old_state_dir) and bool(os.listdir(old_state_dir)):
+        has_pipeline_state = True
+        print(f"⚠️  Migration notice: pipeline state found at dev-pipeline/state/{state_subdir}. "
+              f"Please move to .prizmkit/state/{state_subdir}", file=sys.stderr)
 
     artifacts = {
         f"{workflow_label}_list_exists": has_list,
@@ -176,16 +207,16 @@ def _infer_pipeline_workflow_phase(project_root, list_filename, state_subdir, wo
 
     if has_list and has_pipeline_state:
         return 4, "Monitor", artifacts, \
-            f"{list_filename} + pipeline state exist", \
+            f".prizmkit/plans/{list_filename} + pipeline state exist", \
             "check pipeline status and report results"
 
     if has_list:
         return 3, "Launch", artifacts, \
-            f"{list_filename} exists, no pipeline state", \
+            f".prizmkit/plans/{list_filename} exists, no pipeline state", \
             "launch pipeline → monitor progress"
 
     return 1, "Brainstorm", artifacts, \
-        f"no {list_filename} found", \
+        f"no .prizmkit/plans/{list_filename} found", \
         f"{workflow_label} goal clarification → plan → launch → monitor"
 
 
@@ -199,7 +230,7 @@ def infer_feature_phase(project_root):
 def infer_refactor_phase(project_root):
     """Infer refactor-workflow phase from artifacts and pipeline state."""
     return _infer_pipeline_workflow_phase(
-        project_root, "refactor-list.json", "refactors", "refactor"
+        project_root, "refactor-list.json", "refactor", "refactor"
     )
 
 
@@ -256,6 +287,9 @@ def detect_code_changes(project_root, main_branch="main"):
     files that represent actual implementation work.
     """
     IGNORED_FILES = {
+        ".prizmkit/plans/feature-list.json",
+        ".prizmkit/plans/bug-fix-list.json",
+        ".prizmkit/plans/refactor-list.json",
         "feature-list.json",
         "bug-fix-list.json",
         "refactor-list.json",
@@ -265,7 +299,6 @@ def detect_code_changes(project_root, main_branch="main"):
     }
     IGNORED_PREFIXES = (
         ".prizmkit/",
-        "dev-pipeline/state/",
         ".prizm-docs/",
         ".claude/",
         ".codebuddy/",