prizmkit 1.1.7 → 1.1.8

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/",

package/bundled/skills/refactor-pipeline-launcher/SKILL.md

@@ -46,7 +46,7 @@ Three execution modes are available. The user chooses one before configuring oth
 Before any action, validate:
 
 1. **refactor pipeline exists**: Confirm `dev-pipeline/launch-refactor-daemon.sh` and `dev-pipeline/run-refactor.sh` are present and executable
-2. **For start**: `refactor-list.json` must exist in project root (or user-specified path)
+2. **For start**: `.prizmkit/plans/refactor-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
 3. **Dependencies**: `jq`, `python3`, AI CLI (`cbc` or `claude`) must be in PATH
 4. **Python version**: Requires Python 3.8+ for dev-pipeline scripts
 
@@ -55,8 +55,8 @@ Quick check:
 command -v jq && command -v python3 && (command -v cbc || command -v claude) && echo "All dependencies OK"
 ```
 
-If `refactor-list.json` is missing, inform user:
-> "No refactor-list.json found. Run the `refactor-planner` skill first to generate one, or provide a path to your refactor list."
+If `.prizmkit/plans/refactor-list.json` is missing, inform user:
+> "No .prizmkit/plans/refactor-list.json found. Run the `refactor-planner` skill first to generate one, or provide a path to your refactor list."
 
 ### Workflow
 
@@ -68,7 +68,7 @@ Detect user intent from their message, then follow the corresponding workflow:
 
 1. **Check prerequisites**:
    ```bash
-   ls refactor-list.json 2>/dev/null && echo "Found" || echo "Missing"
+   ls .prizmkit/plans/refactor-list.json 2>/dev/null && echo "Found" || echo "Missing"
    ```
 
 2. **Check not already running**:
@@ -81,7 +81,7 @@ Detect user intent from their message, then follow the corresponding workflow:
    ```bash
    python3 -c "
    import json
-   with open('refactor-list.json') as f:
+   with open('.prizmkit/plans/refactor-list.json') as f:
        data = json.load(f)
    refactors = data.get('refactors', [])
    print(f'Total refactor tasks: {len(refactors)}')
@@ -101,8 +101,8 @@ Detect user intent from their message, then follow the corresponding workflow:
    If pipeline state already exists, use the status command instead:
    ```bash
    python3 dev-pipeline/scripts/update-refactor-status.py \
-     --refactor-list refactor-list.json \
-     --state-dir dev-pipeline/refactor-state \
+     --refactor-list .prizmkit/plans/refactor-list.json \
+     --state-dir .prizmkit/state/refactor \
      --action status 2>/dev/null
    ```
 
@@ -177,34 +177,34 @@ Detect user intent from their message, then follow the corresponding workflow:
 
    **Foreground command:**
    ```bash
-   VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/run-refactor.sh run refactor-list.json
+   VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
    ```
    With all options:
    ```bash
    VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 MAX_RETRIES=5 SESSION_TIMEOUT=3600 \
-     dev-pipeline/run-refactor.sh run refactor-list.json
+     dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
    ```
 
    **Background daemon command:**
    ```bash
-   dev-pipeline/launch-refactor-daemon.sh start refactor-list.json --env "VERBOSE=1 STRICT_BEHAVIOR_CHECK=1"
+   dev-pipeline/launch-refactor-daemon.sh start .prizmkit/plans/refactor-list.json --env "VERBOSE=1 STRICT_BEHAVIOR_CHECK=1"
    ```
    With all options:
    ```bash
-   dev-pipeline/launch-refactor-daemon.sh start refactor-list.json \
+   dev-pipeline/launch-refactor-daemon.sh start .prizmkit/plans/refactor-list.json \
      --env "VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 MAX_RETRIES=5"
    ```
 
    **Manual mode**: Print the assembled command(s) and **stop here**. Do not execute anything. Do not proceed to step 8.
    ```
    # To run in foreground:
-   VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/run-refactor.sh run refactor-list.json
+   VERBOSE=1 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
 
    # To run in background (detached):
-   dev-pipeline/launch-refactor-daemon.sh start refactor-list.json --env "VERBOSE=1 STRICT_BEHAVIOR_CHECK=1"
+   dev-pipeline/launch-refactor-daemon.sh start .prizmkit/plans/refactor-list.json --env "VERBOSE=1 STRICT_BEHAVIOR_CHECK=1"
 
    # To check status:
-   dev-pipeline/run-refactor.sh status refactor-list.json
+   dev-pipeline/run-refactor.sh status .prizmkit/plans/refactor-list.json
    ```
 
 8. **Confirm and launch** (Foreground and Background only — Manual mode ends at step 7):
@@ -227,7 +227,7 @@ Detect user intent from their message, then follow the corresponding workflow:
       ```
    2. Start log monitoring — Use the Bash tool with `run_in_background: true`:
       ```bash
-      tail -f dev-pipeline/refactor-state/pipeline-daemon.log
+      tail -f .prizmkit/state/refactor/pipeline-daemon.log
       ```
    3. Report to user:
       - Pipeline PID
@@ -247,14 +247,14 @@ Detect user intent from their message, then follow the corresponding workflow:
 2. **Show refactor-level progress**:
    ```bash
    python3 dev-pipeline/scripts/update-refactor-status.py \
-     --refactor-list refactor-list.json \
-     --state-dir dev-pipeline/refactor-state \
+     --refactor-list .prizmkit/plans/refactor-list.json \
+     --state-dir .prizmkit/state/refactor \
      --action status
    ```
 
 3. **Show recent log activity** (last 20 lines):
    ```bash
-   tail -20 dev-pipeline/refactor-state/pipeline-daemon.log
+   tail -20 .prizmkit/state/refactor/pipeline-daemon.log
    ```
 
 4. **Summarize** to user: total refactors, completed, in-progress, failed, pending.
@@ -286,20 +286,20 @@ Detect user intent from their message, then follow the corresponding workflow:
 
 2. **If running** -- Start live tail with Bash tool `run_in_background: true`:
    ```bash
-   tail -f dev-pipeline/refactor-state/pipeline-daemon.log
+   tail -f .prizmkit/state/refactor/pipeline-daemon.log
    ```
 
 3. **If not running** -- Show last 50 lines:
    ```bash
-   tail -50 dev-pipeline/refactor-state/pipeline-daemon.log
+   tail -50 .prizmkit/state/refactor/pipeline-daemon.log
    ```
 
 4. **For per-refactor session logs** (when user asks about a specific refactor):
    ```bash
    # Check refactor status for last session ID
-   cat dev-pipeline/refactor-state/refactors/<REFACTOR_ID>/status.json 2>/dev/null
+   cat .prizmkit/state/refactor/refactors/<REFACTOR_ID>/status.json 2>/dev/null
    # Then tail that refactor's session log
-   tail -100 dev-pipeline/refactor-state/refactors/<REFACTOR_ID>/sessions/<SESSION_ID>/logs/session.log
+   tail -100 .prizmkit/state/refactor/refactors/<REFACTOR_ID>/sessions/<SESSION_ID>/logs/session.log
    ```
 
 ---
@@ -309,18 +309,18 @@ Detect user intent from their message, then follow the corresponding workflow:
 When user says "retry R-001":
 
 ```bash
-dev-pipeline/retry-refactor.sh R-001 refactor-list.json
+dev-pipeline/retry-refactor.sh R-001 .prizmkit/plans/refactor-list.json
 ```
 
 When user says "clean retry R-001" or "retry R-001 from scratch":
 
 ```bash
-dev-pipeline/reset-refactor.sh R-001 --clean --run refactor-list.json
+dev-pipeline/reset-refactor.sh R-001 --clean --run .prizmkit/plans/refactor-list.json
 ```
 
 Environment variables (optional):
 ```bash
-SESSION_TIMEOUT=3600 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/retry-refactor.sh R-001 refactor-list.json
+SESSION_TIMEOUT=3600 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/retry-refactor.sh R-001 .prizmkit/plans/refactor-list.json
 ```
 
 Notes:
@@ -334,23 +334,23 @@ Notes:
 
 | Error | Action |
 |-------|--------|
-| `refactor-list.json` not found | Tell user to run `refactor-planner` skill first |
-| Circular dependencies in refactor list | Fix dependency graph in `refactor-list.json` before launching |
+| `.prizmkit/plans/refactor-list.json` not found | Tell user to run `refactor-planner` skill first |
+| Circular dependencies in refactor list | Fix dependency graph in `.prizmkit/plans/refactor-list.json` before launching |
 | Test baseline failing | Fix failing tests before starting refactoring -- behavior preservation requires a green baseline |
 | `jq` not installed | Suggest: `brew install jq` |
 | `cbc`/`claude` not in PATH | Check AI CLI installation |
 | Refactor pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `launch-refactor-daemon.sh` auto-cleans, retry start |
-| Launch failed (process died immediately) | Show last 20 lines of log: `tail -20 dev-pipeline/refactor-state/pipeline-daemon.log` |
+| Launch failed (process died immediately) | Show last 20 lines of log: `tail -20 .prizmkit/state/refactor/pipeline-daemon.log` |
 | Refactor stuck/blocked | Use `retry-refactor.sh <R-XXX>` to retry; use `reset-refactor.sh <R-XXX> --clean --run` for fresh start |
-| All refactors blocked/failed | Show status, suggest recovery: `dev-pipeline/reset-refactor.sh <R-XXX> --clean --run refactor-list.json` |
+| All refactors blocked/failed | Show status, suggest recovery: `dev-pipeline/reset-refactor.sh <R-XXX> --clean --run .prizmkit/plans/refactor-list.json` |
 | Permission denied on script | Run `chmod +x dev-pipeline/launch-refactor-daemon.sh dev-pipeline/run-refactor.sh` |
 
 ### Integration Notes
 
-- **After refactor-planner**: This is the natural next step. When user finishes refactor planning and has `refactor-list.json`, suggest launching the refactor pipeline.
+- **After refactor-planner**: This is the natural next step. When user finishes refactor planning and has `.prizmkit/plans/refactor-list.json`, suggest launching the refactor pipeline.
 - **Session independence**: The pipeline runs completely detached. User can close the AI CLI session, open a new session later, and use this skill to check progress or stop the pipeline.
 - **Single instance**: Only one refactor pipeline can run at a time. The PID file prevents duplicates.
-- **Pipeline coexistence**: Refactor pipeline uses `refactor-state/` separate from `state/` (features) and `bugfix-state/` (bugs), so all three pipelines can run simultaneously without conflict.
+- **Pipeline coexistence**: Refactor pipeline uses `.prizmkit/state/refactor/` separate from `.prizmkit/state/features/` (features) and `.prizmkit/state/bugfix/` (bugs), so all three pipelines can run simultaneously without conflict.
 - **State preservation**: Stopping and restarting the pipeline resumes from where it left off -- completed refactors are not re-run.
 - **HANDOFF**: After pipeline completes all refactors, each session has already run `prizmkit-retrospective` internally. Ask user what's next.

package/bundled/skills/refactor-planner/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "refactor-planner"
-description: "Interactive refactoring planner. Understands refactoring intent through dialogue, analyzes current code structure, produces validated refactor-list.json for dev-pipeline execution. Use whenever users discuss refactoring planning, code restructuring scope, or preparing refactor-list.json."
+description: "Interactive refactoring planner. Understands refactoring intent through dialogue, analyzes current code structure, produces validated .prizmkit/plans/refactor-list.json for dev-pipeline execution. Use whenever users discuss refactoring planning, code restructuring scope, or preparing .prizmkit/plans/refactor-list.json."
 ---
 
 # refactor planner
@@ -9,7 +9,7 @@ Plan executable refactoring items for dev-pipeline:
 - **Scope Assessment**: analyze current code structure and identify refactoring targets
 - **Item Decomposition**: break refactoring goals into well-ordered, behavior-preserving items
 
-Always produce a validated `refactor-list.json` that conforms to `dev-pipeline-refactor-list-v1`.
+Always produce a validated `.prizmkit/plans/refactor-list.json` that conforms to `dev-pipeline-refactor-list-v1`.
 
 ## Invocation Commitment (Hard Rule)
 
@@ -31,24 +31,24 @@ The user chose this skill intentionally. Respect that choice.
 - Create, modify, or delete source code files (*.js, *.ts, *.py, *.go, *.html, *.css, etc.)
 - Execute refactoring operations (rename, move, extract, etc.)
 - Run build/install/test commands
-- Execute any implementation action beyond writing `refactor-list.json`
+- Execute any implementation action beyond writing `.prizmkit/plans/refactor-list.json`
 
 **Your ONLY writable outputs are:**
-1. `refactor-list.json` (project root)
+1. `.prizmkit/plans/refactor-list.json` (`.prizmkit/plans/`)
 2. Draft backups in `.prizmkit/planning/`
 
 **After planning is complete**, you MUST:
 1. Present the summary and recommended next step
 2. **Ask the user explicitly** whether they want to proceed to execution
 3. If the user agrees -> recommend invoking `refactor-pipeline-launcher` or running `run-refactor.sh` (do NOT execute it yourself)
-4. If the user wants to adjust -> continue refining `refactor-list.json`
+4. If the user wants to adjust -> continue refining `.prizmkit/plans/refactor-list.json`
 5. **NEVER auto-execute** the pipeline, launcher, or any implementation step
 
 ## When to Use
 
 Trigger this skill for requests like:
 - "Plan refactoring", "Scope a restructuring"
-- "Prepare refactor-list.json", "Prepare dev-pipeline input for refactoring"
+- "Prepare .prizmkit/plans/refactor-list.json", "Prepare dev-pipeline input for refactoring"
 - "Assess code for refactoring", "Identify refactoring targets"
 - "Plan a code migration", "Decompose a large refactor"
 
@@ -86,7 +86,7 @@ Before questions, check optional context files (never block if absent):
 - `.prizm-docs/root.prizm` (architecture/project context)
 - `.prizmkit/config.json` (existing stack preferences and detected tech stack)
 - Existing test suite (critical for behavior preservation assessment)
-- Existing `refactor-list.json` (if appending additional items)
+- Existing `.prizmkit/plans/refactor-list.json` (if appending additional items)
 - If `.prizm-docs/root.prizm` is absent and the project has existing source code, scan the directory structure:
   ```bash
   find . -maxdepth 2 -type d -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/__pycache__/*' -not -path '*/vendor/*' | sed -e 's;[^/]*/;|____;g;s;____|; |;g'
@@ -106,13 +106,13 @@ Full Q&A -> code analysis -> item generation. Used when starting from scratch or
 When an existing analysis report (e.g., `refactor-analysis.md`) is available, skip the analysis phase and proceed directly to item decomposition.
 
 ### Mode C: Validate
-Validate an existing `refactor-list.json` without regenerating it:
+Validate an existing `.prizmkit/plans/refactor-list.json` without regenerating it:
 ```bash
-python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py validate --input refactor-list.json
+python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py validate --input .prizmkit/plans/refactor-list.json
 ```
 
 ### Mode D: Summary
-Display a human-readable summary of an existing `refactor-list.json`:
+Display a human-readable summary of an existing `.prizmkit/plans/refactor-list.json`:
 - Item count, dependency graph, complexity distribution, behavior preservation strategies
 
 ## Interactive Mode — Core Workflow
@@ -262,17 +262,17 @@ If issues found, discuss with user and resolve before proceeding.
 
 ### Phase 7: Generate & Validate
 
-**Goal**: Produce `refactor-list.json` and validate it.
+**Goal**: Produce `.prizmkit/plans/refactor-list.json` and validate it.
 
-1. Generate `refactor-list.json` at project root
+1. Generate `.prizmkit/plans/refactor-list.json` at `.prizmkit/plans/`
 2. Run validation:
    ```bash
-   python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py validate --input refactor-list.json
+   python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py validate --input .prizmkit/plans/refactor-list.json
    ```
 3. If validation fails -> fix issues and re-validate (max 3 attempts)
 4. If validation passes -> present final summary
 
-**CHECKPOINT CP-RP-6**: `refactor-list.json` generated and validated.
+**CHECKPOINT CP-RP-6**: `.prizmkit/plans/refactor-list.json` generated and validated.
 
 ## Checkpoints (Mandatory Gates)
 
@@ -284,13 +284,13 @@ If issues found, discuss with user and resolve before proceeding.
 | **CP-RP-3** | Items Decomposed | All items have deps, complexity, preservation strategy | 4 |
 | **CP-RP-4** | Items Confirmed | User confirmed/modified/skipped each item | 5 |
 | **CP-RP-5** | Completeness OK | DAG valid, preservation strategies declared, no gaps | 6 |
-| **CP-RP-6** | Output Valid | `refactor-list.json` passes validation script | 7 |
+| **CP-RP-6** | Output Valid | `.prizmkit/plans/refactor-list.json` passes validation script | 7 |
 
-**Resume Detection**: If existing artifacts found (partial `refactor-list.json`, draft in `.prizmkit/planning/`), offer to resume from the appropriate checkpoint.
+**Resume Detection**: If existing artifacts found (partial `.prizmkit/plans/refactor-list.json`, draft in `.prizmkit/planning/`), offer to resume from the appropriate checkpoint.
 
 ## Output Rules
 
-`refactor-list.json` must satisfy:
+`.prizmkit/plans/refactor-list.json` must satisfy:
 - `$schema` = `dev-pipeline-refactor-list-v1`
 - Non-empty `refactors` array
 - Sequential IDs: `R-001`, `R-002`, ...
@@ -428,7 +428,7 @@ Recommend these three options in this strict order:
 1. **Preferred**: invoke `refactor-pipeline-launcher` skill (natural-language handoff)
 2. **Fallback A**: run daemon wrapper
    ```bash
-   ./dev-pipeline/launch-refactor-daemon.sh start refactor-list.json
+   ./dev-pipeline/launch-refactor-daemon.sh start .prizmkit/plans/refactor-list.json
    ./dev-pipeline/launch-refactor-daemon.sh status
    ```
 3. **Fallback B**: run direct foreground script
@@ -445,7 +445,7 @@ Key behaviors:
 - Warnings only -> proceed with user approval
 - Critical errors -> group by type, auto-fix where possible, max 3 total attempts
 - Interrupted session -> detect checkpoint from existing artifacts, offer resume or restart
-- `refactor-list.json` MUST be written to project root (same level as `package.json` / `.git`)
+- `.prizmkit/plans/refactor-list.json` MUST be written to `.prizmkit/plans/` (project root level: `./{root}/.prizmkit/plans/refactor-list.json`)
 
 ### Resume Detection
 
@@ -453,8 +453,8 @@ Key behaviors:
 |---------------|------------|
 | Nothing | Phase 1: Project Context |
 | Draft in `.prizmkit/planning/` | Phase matching draft state |
-| Partial `refactor-list.json` | Phase 6: Completeness Review |
-| Valid `refactor-list.json` | Mode D: Summary |
+| Partial `.prizmkit/plans/refactor-list.json` | Phase 6: Completeness Review |
+| Valid `.prizmkit/plans/refactor-list.json` | Mode D: Summary |
 
 ## Session Exit Gate
 
@@ -464,11 +464,11 @@ Prevent accidental session exit without deliverable completion.
 Activate exit gate when ALL are true:
 - User invoked `/refactor-planner` (not just mentioned refactoring)
 - Current phase < Phase 7 (validation not yet passed)
-- No valid `refactor-list.json` has been written in this session
+- No valid `.prizmkit/plans/refactor-list.json` has been written in this session
 
 ### Gate Behavior
 When the session appears to be ending:
-1. **Remind**: "You set out to produce `refactor-list.json` but we haven't completed it yet."
+1. **Remind**: "You set out to produce `.prizmkit/plans/refactor-list.json` but we haven't completed it yet."
 2. **Offer 3 options**:
    - **(a) Continue to completion** — resume from current phase
    - **(b) Save draft & exit** — write current progress as draft, exit session

package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py

@@ -4,14 +4,14 @@ validate-and-generate-refactor.py - Validate and generate refactor-list.json fil
 for the dev-pipeline system.
 
 Commands:
-  validate    Validate an existing refactor-list.json
-  template    Generate a blank template refactor-list.json
-  summary     Print a summary table of refactors from a refactor-list.json
+  validate    Validate an existing .prizmkit/plans/refactor-list.json
+  template    Generate a blank template .prizmkit/plans/refactor-list.json
+  summary     Print a summary table of refactors from a .prizmkit/plans/refactor-list.json
 
 Usage:
-  python3 validate-and-generate-refactor.py validate --input refactor-list.json [--output validated.json]
-  python3 validate-and-generate-refactor.py template --output refactor-list.json
-  python3 validate-and-generate-refactor.py summary --input refactor-list.json [--format markdown|json]
+  python3 validate-and-generate-refactor.py validate --input .prizmkit/plans/refactor-list.json [--output validated.json]
+  python3 validate-and-generate-refactor.py template --output .prizmkit/plans/refactor-list.json
+  python3 validate-and-generate-refactor.py summary --input .prizmkit/plans/refactor-list.json [--format markdown|json]
 
 Python 3.6+ required. No external dependencies.
 """
@@ -712,15 +712,15 @@ def cmd_summary(args):
 
 def main():
     parser = argparse.ArgumentParser(
-        description="Validate and generate refactor-list.json files for the dev-pipeline system.",
+        description="Validate and generate .prizmkit/plans/refactor-list.json files for the dev-pipeline system.",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=(
             "Examples:\n"
-            "  %(prog)s validate --input refactor-list.json\n"
-            "  %(prog)s validate --input refactor-list.json --output validated.json\n"
-            "  %(prog)s template --output refactor-list.json\n"
-            "  %(prog)s summary --input refactor-list.json\n"
-            "  %(prog)s summary --input refactor-list.json --format json\n"
+            "  %(prog)s validate --input .prizmkit/plans/refactor-list.json\n"
+            "  %(prog)s validate --input .prizmkit/plans/refactor-list.json --output validated.json\n"
+            "  %(prog)s template --output .prizmkit/plans/refactor-list.json\n"
+            "  %(prog)s summary --input .prizmkit/plans/refactor-list.json\n"
+            "  %(prog)s summary --input .prizmkit/plans/refactor-list.json --format json\n"
         ),
     )
 
@@ -729,10 +729,10 @@ def main():
     # -- validate --
     p_validate = subparsers.add_parser(
         "validate",
-        help="Validate an existing refactor-list.json",
+        help="Validate an existing .prizmkit/plans/refactor-list.json",
     )
     p_validate.add_argument(
-        "--input", required=True, help="Path to input refactor-list.json"
+        "--input", required=True, help="Path to input .prizmkit/plans/refactor-list.json"
     )
     p_validate.add_argument(
         "--output", help="Path to write validated output (optional)"
@@ -741,7 +741,7 @@ def main():
     # -- template --
     p_template = subparsers.add_parser(
         "template",
-        help="Generate a blank template refactor-list.json",
+        help="Generate a blank template .prizmkit/plans/refactor-list.json",
     )
     p_template.add_argument(
         "--output", required=True, help="Path to write template file"
@@ -750,10 +750,10 @@ def main():
     # -- summary --
     p_summary = subparsers.add_parser(
         "summary",
-        help="Print a summary table of refactors from a refactor-list.json",
+        help="Print a summary table of refactors from a .prizmkit/plans/refactor-list.json",
     )
     p_summary.add_argument(
-        "--input", required=True, help="Path to input refactor-list.json"
+        "--input", required=True, help="Path to input .prizmkit/plans/refactor-list.json"
     )
     p_summary.add_argument(
         "--format",