prizmkit 1.1.42 → 1.1.47

package/bundled/dev-pipeline/run-refactor.sh

@@ -33,8 +33,12 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/refactor"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT,
+# CLI/platform detection, logs, deps)
+source "$SCRIPT_DIR/lib/common.sh"
+
+STATE_DIR="${PRIZMKIT_DIR}/state/refactor"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Configuration
@@ -55,7 +59,6 @@ STRICT_BEHAVIOR_CHECK=${STRICT_BEHAVIOR_CHECK:-1}
 ENABLE_DEPLOY=${ENABLE_DEPLOY:-0}
 
 # Source shared common helpers (CLI/platform detection + logs + deps)
-source "$SCRIPT_DIR/lib/common.sh"
 prizm_detect_cli_and_platform
 
 # Source shared heartbeat library
@@ -192,7 +195,7 @@ spawn_and_wait_session() {
     # ── Determine session outcome from observable signals ──────────────
     local session_status
     local project_root
-    project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    project_root="$PROJECT_ROOT"
     local default_branch="$base_branch"
 
     if [[ $exit_code -eq 124 ]]; then
@@ -276,15 +279,13 @@ spawn_and_wait_session() {
 
     # Validate key artifacts exist after successful session
     if [[ "$session_status" == "success" ]]; then
-        local _artifact_root
-        _artifact_root="$(cd "$SCRIPT_DIR/.." && pwd)"
-        local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
+        local plan_file="$PRIZMKIT_DIR/refactor/$refactor_id/plan.md"
         if [[ ! -f "$plan_file" ]]; then
             log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
         fi
 
         # Validate checkpoint completeness
-        local checkpoint_file="$_artifact_root/.prizmkit/refactor/$refactor_id/workflow-checkpoint.json"
+        local checkpoint_file="$PRIZMKIT_DIR/refactor/$refactor_id/workflow-checkpoint.json"
         if [[ -f "$checkpoint_file" ]]; then
             local checkpoint_result
             checkpoint_result=$(python3 -c "
@@ -329,7 +330,7 @@ sys.exit(0)
 
     # Propagate completion notes for dependency context (only on success)
     if [[ "$session_status" == "success" ]]; then
-        local summary_path="$project_root/.prizmkit/refactor/$refactor_id/completion-summary.json"
+        local summary_path="$PRIZMKIT_DIR/refactor/$refactor_id/completion-summary.json"
         if [[ -f "$summary_path" ]]; then
             python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
                 --refactor-list "$refactor_list" \
@@ -406,7 +407,7 @@ for item in data.get('refactors', []):
     fi
 
     # GUARANTEED: always return to original branch (save WIP on dev branch first)
-    branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+    branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
 
     log_info "Refactor pipeline paused. Run './run-refactor.sh run' to resume."
     exit 130
@@ -420,7 +421,7 @@ trap cleanup SIGINT SIGTERM
 check_dependencies() {
     prizm_check_common_dependencies "$CLI_CMD"
     local _project_root
-    _project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _project_root="$PROJECT_ROOT"
     prizm_ensure_git_repo "$_project_root"
 }
 
@@ -493,7 +494,7 @@ run_one() {
     fi
 
     if [[ -z "$refactor_list" ]]; then
-        refactor_list=".prizmkit/plans/refactor-list.json"
+        refactor_list="$PRIZMKIT_DIR/plans/refactor-list.json"
     fi
     if [[ ! "$refactor_list" = /* ]]; then
         refactor_list="$(pwd)/$refactor_list"
@@ -546,9 +547,9 @@ run_one() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/refactor")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/refactor")
         if [[ -f "$_gitignore_path" ]]; then
             if ! grep -qF "$_state_rel" "$_gitignore_path" 2>/dev/null; then
                 printf '\n# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" >> "$_gitignore_path"
@@ -594,9 +595,9 @@ sys.exit(1)
             log_info "Cleaning artifacts for $refactor_id..."
 
             local project_root
-            project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+            project_root="$PROJECT_ROOT"
 
-            local refactor_dir="$project_root/.prizmkit/refactor/$refactor_id"
+            local refactor_dir="$PRIZMKIT_DIR/refactor/$refactor_id"
             if [[ -d "$refactor_dir" ]]; then
                 rm -rf "$refactor_dir"
                 log_info "Removed $refactor_dir"
@@ -776,7 +777,7 @@ else:
         fi
 
         # GUARANTEED: always return to original branch (save WIP on dev branch first)
-        branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+        branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
         exit 130
     }
     trap cleanup_single_refactor SIGINT SIGTERM
@@ -785,7 +786,7 @@ else:
 
     # Branch lifecycle: create and checkout refactor branch
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -853,7 +854,7 @@ else:
 # ============================================================
 
 main() {
-    local refactor_list="${1:-.prizmkit/plans/refactor-list.json}"
+    local refactor_list="${1:-$PRIZMKIT_DIR/plans/refactor-list.json}"
 
     if [[ ! "$refactor_list" = /* ]]; then
         refactor_list="$(pwd)/$refactor_list"
@@ -908,9 +909,9 @@ main() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/refactor")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/refactor")
         if [[ -f "$_gitignore_path" ]]; then
             if ! grep -qF "$_state_rel" "$_gitignore_path" 2>/dev/null; then
                 printf '\n# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" >> "$_gitignore_path"
@@ -951,7 +952,7 @@ main() {
 
     # Branch lifecycle: per-refactor branches (like feature pipeline)
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -1194,9 +1195,7 @@ DEPLOY_PROMPT_EOF
 
         # Validate key artifacts after successful session
         if [[ "$_SPAWN_RESULT" == "success" ]]; then
-            local _artifact_root
-            _artifact_root="$(cd "$SCRIPT_DIR/.." && pwd)"
-            local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
+            local plan_file="$PRIZMKIT_DIR/refactor/$refactor_id/plan.md"
             if [[ ! -f "$plan_file" ]]; then
                 log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
             else
@@ -1314,7 +1313,7 @@ case "${1:-run}" in
         if [[ "${1:-}" =~ ^[Rr]-[0-9]+ ]]; then
             run_one "$@"
         else
-            main "${1:-.prizmkit/plans/refactor-list.json}"
+            main "${1:-$PRIZMKIT_DIR/plans/refactor-list.json}"
         fi
         ;;
     status)
@@ -1324,7 +1323,7 @@ case "${1:-run}" in
             exit 1
         fi
         python3 "$SCRIPTS_DIR/update-refactor-status.py" \
-            --refactor-list "${2:-.prizmkit/plans/refactor-list.json}" \
+            --refactor-list "${2:-$PRIZMKIT_DIR/plans/refactor-list.json}" \
             --state-dir "$STATE_DIR" \
             --action status
         ;;
@@ -1339,7 +1338,7 @@ case "${1:-run}" in
             log_error "No refactor pipeline state found. Run './run-refactor.sh run' first."
             exit 1
         fi
-        _unskip_refactor_list=".prizmkit/plans/refactor-list.json"
+        _unskip_refactor_list="$PRIZMKIT_DIR/plans/refactor-list.json"
         _unskip_refactor_id=""
         shift || true
         # Parse arguments: optional refactor-id and refactor-list path

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

@@ -416,17 +416,17 @@ def _read_project_brief(project_root):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent directory of dev-pipeline/.
+    """Resolve project root from script_dir of the prompt-generator script.
 
-    The script lives at dev-pipeline/scripts/, so project root is two
-    levels up from the script directory.
+    Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → project root = <project>
+      <repo>/dev-pipeline/scripts/               → project root = <repo>
     """
-    # script_dir = .../dev-pipeline/scripts
-    # dev_pipeline_dir = .../dev-pipeline
-    # project_root = .../
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def process_conditional_blocks(content, resume_phase):
@@ -557,7 +557,7 @@ def process_mode_blocks(content, pipeline_mode, init_done, critic_enabled=False,
 
 def detect_init_status(project_root):
     """Check if PrizmKit init has already been done."""
-    prizm_docs = os.path.join(project_root, ".prizm-docs", "root.prizm")
+    prizm_docs = os.path.join(project_root, ".prizmkit/prizm-docs", "root.prizm")
     prizmkit_config = os.path.join(project_root, ".prizmkit", "config.json")
     return os.path.isfile(prizm_docs) and os.path.isfile(prizmkit_config)
 
@@ -587,7 +587,7 @@ def determine_pipeline_mode(complexity):
     Tier assignment rationale:
     - low + medium → lite (single agent): most features don't benefit from
       the orchestrator→dev→reviewer overhead. A single agent reading
-      .prizm-docs + implementing directly is faster and cheaper.
+      .prizmkit/prizm-docs + implementing directly is faster and cheaper.
     - high → standard (orchestrator + dev + reviewer): complex features
       need the spec→plan→analyze→implement→review pipeline.
     - critical → full (full team + framework guardrails): architectural
@@ -612,7 +612,7 @@ def determine_pipeline_mode(complexity):
 # merge_checkpoint_state() never collides.
 SECTION_TO_SKILL = {
     "phase0-init": ("prizmkit-init", "Project Bootstrap",
-                    [".prizm-docs/root.prizm", ".prizmkit/config.json"]),
+                    [".prizmkit/prizm-docs/root.prizm", ".prizmkit/config.json"]),
     "phase0-test-baseline": ("test-baseline", "Test Baseline", []),
     "phase-context-snapshot": ("context-snapshot", "Build Context Snapshot",
                                [".prizmkit/specs/{slug}/context-snapshot.md"]),
@@ -1239,8 +1239,8 @@ def build_replacements(args, feature, features, global_context, script_dir):
                 "Run `npx prizmkit install` to reinstall agent definitions.",
                 agent_path, agent_name,
             )
-    # Validator scripts - check if they exist in .codebuddy/scripts/, otherwise use dev-pipeline/scripts/
-    validator_scripts_dir = os.path.join(project_root, "dev-pipeline", "scripts")
+    # Validator scripts - check if they exist in .codebuddy/scripts/, otherwise use .prizmkit/dev-pipeline/scripts/
+    validator_scripts_dir = os.path.join(project_root, ".prizmkit", "dev-pipeline", "scripts")
     init_script_path = os.path.join(validator_scripts_dir, "init-dev-team.py")
 
     # Session status path (relative to project root)

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

@@ -208,10 +208,15 @@ def get_prev_session_status(state_dir, bug_id):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent of dev-pipeline/."""
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    """Resolve project root. Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → <project>
+      <repo>/dev-pipeline/scripts/               → <repo>
+    """
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def build_replacements(args, bug, global_context, script_dir):

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

@@ -57,7 +57,7 @@ Use whatever information is available:
 - Read bug entry from `.prizmkit/plans/bug-fix-list.json` if bug ID is known
 - Read any existing artifacts in `.prizmkit/bugfix/{bug_id}/`
 - Read relevant source code and test files
-- Read `.prizm-docs/` for affected modules
+- Read `.prizmkit/prizm-docs/` for affected modules
 
 Produce a bug summary with: symptom, reproduction steps, expected behavior,
 affected files, and root cause hypothesis.""",
@@ -66,9 +66,9 @@ affected files, and root cause hypothesis.""",
         "Triage",
         """\
 Locate affected code and identify root cause:
-1. Read `.prizm-docs/root.prizm` then relevant L1/L2 docs for affected modules
+1. Read `.prizmkit/prizm-docs/root.prizm` then relevant L1/L2 docs for affected modules
 2. Read files mentioned in the bug description or error/stack trace
-3. Check `.prizm-docs/` TRAPS for known patterns
+3. Check `.prizmkit/prizm-docs/` TRAPS for known patterns
 4. Classify: root cause (confirmed/suspected), blast radius, fix complexity
 5. Log your diagnosis (no need to ask for user confirmation in autonomous mode)""",
     ),
@@ -115,7 +115,7 @@ for manual user testing:
         """\
 Commit the fix and finalize:
 1. Run `/prizmkit-retrospective` (structural sync only — update file counts,
-   interfaces, dependencies in .prizm-docs/)
+   interfaces, dependencies in .prizmkit/prizm-docs/)
 2. Stage all changed files explicitly (NEVER use `git add -A` or `git add .`)
 3. Run `/prizmkit-committer --headless` with commit prefix `fix(<scope>): <description>`
 4. Verify working tree is clean: `git status --short`
@@ -132,7 +132,7 @@ FEATURE_PHASES = {
         "Brainstorm",
         """\
 Since this is an autonomous recovery session, work with whatever context is
-available. Read existing project files, `.prizm-docs/`, and any user-provided
+available. Read existing project files, `.prizmkit/prizm-docs/`, and any user-provided
 materials to understand the requirements. Skip interactive Q&A.
 Produce a requirements summary if one doesn't already exist.""",
     ),
@@ -153,7 +153,7 @@ Invoke `/feature-pipeline-launcher` skill:
 
 If `/feature-pipeline-launcher` is not available, run the pipeline directly:
 ```bash
-./dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
 ```""",
     ),
     4: (
@@ -161,7 +161,7 @@ If `/feature-pipeline-launcher` is not available, run the pipeline directly:
         """\
 Check pipeline status and report results:
 ```bash
-python3 dev-pipeline/scripts/update-feature-status.py \\
+python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \\
   --feature-list .prizmkit/plans/feature-list.json \\
   --state-dir .prizmkit/state/features \\
   --action status
@@ -175,7 +175,7 @@ REFACTOR_PHASES = {
         "Brainstorm",
         """\
 Since this is an autonomous recovery session, work with whatever context is
-available. Read existing project files, `.prizm-docs/`, and any materials
+available. Read existing project files, `.prizmkit/prizm-docs/`, and any materials
 to understand the refactoring goals. Skip interactive Q&A.
 Produce a refactoring goals summary if one doesn't already exist.""",
     ),
@@ -196,7 +196,7 @@ Invoke `/refactor-pipeline-launcher` skill:
 
 If `/refactor-pipeline-launcher` is not available, run the pipeline directly:
 ```bash
-./dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
+./.prizmkit/dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
 ```""",
     ),
     4: (
@@ -204,7 +204,7 @@ If `/refactor-pipeline-launcher` is not available, run the pipeline directly:
         """\
 Check pipeline status and report results:
 ```bash
-python3 dev-pipeline/scripts/update-refactor-status.py \\
+python3 .prizmkit/dev-pipeline/scripts/update-refactor-status.py \\
   --refactor-list .prizmkit/plans/refactor-list.json \\
   --state-dir .prizmkit/state/refactor \\
   --action status
@@ -688,9 +688,15 @@ def resolve_project_root(given_root):
     """Resolve project root from argument or git."""
     if given_root:
         return os.path.abspath(given_root)
-    # Auto-detect: script is at dev-pipeline/scripts/, project root is 2 levels up
+    # Auto-detect across two layouts:
+    #   <project>/.prizmkit/dev-pipeline/scripts/  → up 3 levels
+    #   <repo>/dev-pipeline/scripts/               → up 2 levels
     script_dir = os.path.dirname(os.path.abspath(__file__))
-    return os.path.dirname(os.path.dirname(script_dir))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def emit_failure(message):

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

@@ -357,10 +357,15 @@ def get_prev_session_status(state_dir, refactor_id):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent of dev-pipeline/."""
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    """Resolve project root. Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → <project>
+      <repo>/dev-pipeline/scripts/               → <repo>
+    """
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def build_replacements(args, refactor, refactors, global_context, script_dir):

package/bundled/dev-pipeline/scripts/parse-stream-progress.py

@@ -50,7 +50,7 @@ PHASE_KEYWORDS = {
     },
     "retrospective": {
         "strong": ["prizmkit-retrospective"],
-        "weak": ["retrospective", "structural sync", "architecture knowledge", ".prizm-docs/ sync"],
+        "weak": ["retrospective", "structural sync", "architecture knowledge", ".prizmkit/prizm-docs/ sync"],
     },
     "commit": {
         "strong": ["prizmkit-committer"],

package/bundled/dev-pipeline/scripts/update-bug-status.py

@@ -341,7 +341,15 @@ def action_update(args, bug_list_path, state_dir):
 
 
 def _default_project_root():
-    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+    env = os.environ.get("PROJECT_ROOT")
+    if env:
+        return os.path.abspath(env)
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def cleanup_bug_artifacts(state_dir, bug_id, project_root=None):

package/bundled/dev-pipeline/scripts/update-feature-status.py

@@ -236,7 +236,19 @@ def update_feature_in_list(feature_list_path, feature_id, new_status):
 
 
 def _default_project_root():
-    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+    # Script lives at <pipeline>/scripts/update-feature-status.py.
+    # Pipeline may be either <project>/.prizmkit/dev-pipeline (user install)
+    # or <repo>/dev-pipeline (framework source). Auto-detect by checking if
+    # the parent of dev-pipeline is named ".prizmkit".
+    env = os.environ.get("PROJECT_ROOT")
+    if env:
+        return os.path.abspath(env)
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def _build_feature_slug(feature_id, title):

package/bundled/dev-pipeline/scripts/update-refactor-status.py

@@ -384,7 +384,15 @@ def action_update(args, refactor_list_path, state_dir):
 
 
 def _default_project_root():
-    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+    env = os.environ.get("PROJECT_ROOT")
+    if env:
+        return os.path.abspath(env)
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def cleanup_refactor_artifacts(state_dir, refactor_id, project_root=None):

package/bundled/dev-pipeline/templates/agent-prompts/critic-plan-challenge.md

@@ -1,7 +1,7 @@
 "Read {{CRITIC_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 **MODE: Plan Challenge**
 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST — Section 3 has project context, Section 4 has file manifest.
-2. Read `.prizm-docs/root.prizm` and relevant L1/L2 docs for affected modules.
+2. Read `.prizmkit/prizm-docs/root.prizm` and relevant L1/L2 docs for affected modules.
 3. Read existing source files in the modules this plan touches.
 4. Challenge plan.md against the project's existing architecture, patterns, and style.
 Write `.prizmkit/specs/{{FEATURE_SLUG}}/challenge-report.md` with findings (or 'No significant challenges')."

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

@@ -24,7 +24,7 @@ Infer what needs to be done from the feature context above and follow the standa
 
 ### Execution Steps
 
-1. **Read context**: Read `.prizm-docs/root.prizm` and relevant L1/L2 docs to understand the codebase.
+1. **Read context**: Read `.prizmkit/prizm-docs/root.prizm` and relevant L1/L2 docs to understand the codebase.
 
 2. **Plan**: Run `/prizmkit-plan` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` to produce `spec.md` and `plan.md`.
 
@@ -34,7 +34,7 @@ Infer what needs to be done from the feature context above and follow the standa
 
 5. **Review**: Run `/prizmkit-code-review` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` to review and auto-fix changes against the spec (internal review-fix loop, max 3 rounds).
 
-6. **Retrospective**: Run `/prizmkit-retrospective` to sync `.prizm-docs/` with code changes.
+6. **Retrospective**: Run `/prizmkit-retrospective` to sync `.prizmkit/prizm-docs/` with code changes.
 
 7. **Commit**: Run `/prizmkit-committer --headless` to commit all changes. Do NOT push.
 

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

@@ -69,7 +69,7 @@ You are running in **headless non-interactive mode** with a FINITE context windo
 ### Phase 0: Project Bootstrap
 - Run `/prizmkit-init` (invoke the prizmkit-init skill)
 - Run `python3 {{INIT_SCRIPT_PATH}} --project-root {{PROJECT_ROOT}} --feature-id {{FEATURE_ID}} --feature-slug {{FEATURE_SLUG}}`
-- **CP-0**: Verify `.prizm-docs/root.prizm`, `.prizmkit/config.json` exist
+- **CP-0**: Verify `.prizmkit/prizm-docs/root.prizm`, `.prizmkit/config.json` exist
 {{END_IF_INIT_NEEDED}}
 {{IF_INIT_DONE}}
 ### Phase 0: SKIP (already initialized)
@@ -82,7 +82,7 @@ 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
+1. Read `.prizmkit/prizm-docs/root.prizm` and relevant L1 prizm docs
 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
@@ -344,22 +344,22 @@ If verification fails, log the failure details but continue to commit. Failures
 
 ### Phase 4: Architecture Sync & Commit (SINGLE COMMIT)
 
-**4a.** 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/`
+**4a.** Run `/prizmkit-retrospective` — maintains `.prizmkit/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 `.prizmkit/prizm-docs/` files
+2. **Architecture knowledge** (feature sessions only): Extract TRAPS/RULES/DECISIONS from completed work into `.prizmkit/prizm-docs/`
 3. **L2 coverage check**: For any module/sub-module with source files created or significantly modified in this session but no L2 `.prizm` doc — evaluate whether L2 is warranted and create if so. The current session has the best context for accurate KEY_FILES, TRAPS, and DECISIONS.
-4. Stage doc changes: `git add .prizm-docs/`
+4. Stage doc changes: `git add .prizmkit/prizm-docs/`
 ⚠️ Do NOT commit here. Only stage.
 
 **4b.** 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/
+git add .prizmkit/prizm-docs/
 ```
 
 **4c.** 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.
+This single commit includes: feature code + tests + .prizmkit/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.
 

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

@@ -80,7 +80,7 @@ If any agent times out:
 ### Phase 0: Project Bootstrap
 - Run `/prizmkit-init` (invoke the prizmkit-init skill)
 - Run `python3 {{INIT_SCRIPT_PATH}} --project-root {{PROJECT_ROOT}} --feature-id {{FEATURE_ID}} --feature-slug {{FEATURE_SLUG}}`
-- **CP-0**: Verify `.prizm-docs/root.prizm`, `.prizmkit/config.json` exist
+- **CP-0**: Verify `.prizmkit/prizm-docs/root.prizm`, `.prizmkit/config.json` exist
 {{END_IF_INIT_NEEDED}}
 {{IF_INIT_DONE}}
 ### Phase 0: SKIP (already initialized)
@@ -104,7 +104,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 6 retrospective
+- Read DISCOVERED_TRAPS — if any are genuine, inject into .prizmkit/prizm-docs/ during Phase 6 retrospective
 - Do NOT delete failure-log.md until this session completes all phases and commits successfully
 
 ```bash
@@ -112,7 +112,7 @@ 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
+1. Read `.prizmkit/prizm-docs/root.prizm` and relevant L1/L2 prizm docs
 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
@@ -137,7 +137,7 @@ If MISSING — build it now:
      |------|-----------|----------------|
      | `<source-dir>/security/permission-guard.js` | Permission check integration | `checkCommandPermission(userId, cmd)` |
 
-     ### Known TRAPS (from .prizm-docs/)
+     ### Known TRAPS (from .prizmkit/prizm-docs/)
      - <trap entries extracted from L1/L2 docs>
 
 ### Phase 2: Plan & Tasks (you, the orchestrator)
@@ -190,7 +190,7 @@ Prompt:
 > "Read {{CRITIC_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 > **MODE: Plan Challenge**
 > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST — Section 3 has project context, Section 4 has file manifest.
-> 2. Read `.prizm-docs/root.prizm` and relevant L1/L2 docs for affected modules.
+> 2. Read `.prizmkit/prizm-docs/root.prizm` and relevant L1/L2 docs for affected modules.
 > 3. Read existing source files in the modules this plan touches.
 > 4. Challenge plan.md against the project's existing architecture, patterns, and style.
 > Write `.prizmkit/specs/{{FEATURE_SLUG}}/challenge-report.md` with findings (or 'No significant challenges')."
@@ -437,22 +437,22 @@ If verification fails, log the failure details but continue to commit. Failures
 
 ### Phase 6: Architecture Sync & Commit (SINGLE COMMIT)
 
-**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/`
+**6a.** Run `/prizmkit-retrospective` — maintains `.prizmkit/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 `.prizmkit/prizm-docs/` files
+2. **Architecture knowledge** (feature sessions only): Extract TRAPS/RULES/DECISIONS from completed work into `.prizmkit/prizm-docs/`
 3. **L2 coverage check**: For any module/sub-module with source files created or significantly modified in this session but no L2 `.prizm` doc — evaluate whether L2 is warranted and create if so. The current session has the best context for accurate KEY_FILES, TRAPS, and DECISIONS.
-4. Stage doc changes: `git add .prizm-docs/`
+4. Stage doc changes: `git add .prizmkit/prizm-docs/`
 ⚠️ Do NOT commit here. Only stage.
 
 **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/
+git add .prizmkit/prizm-docs/
 ```
 
 **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.
+This single commit includes: feature code + tests + .prizmkit/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.