prizmkit 1.1.118 → 1.1.120

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

@@ -811,8 +811,8 @@ def test_prompt_generation_passes_explicit_execution_root_to_generator(monkeypat
                     "output_path": str(session_paths.prompt_path),
                     "checkpoint_path": str(execution_root / ".prizmkit" / "specs" / "001-low" / "workflow-checkpoint.json"),
                     "model": "",
-                    "pipeline_mode": "lite",
-                    "agent_count": 1,
+                    "pipeline_mode": "full",
+                    "agent_count": 3,
                 }
             ),
             stderr="",
@@ -876,8 +876,8 @@ def _install_runner_session_fakes(monkeypatch, runners, *, statuses=("success",)
         return PromptGenerationResult(
             output_path=session_paths.prompt_path,
             model="per-item-model",
-            pipeline_mode="lite",
-            agent_count=1,
+            pipeline_mode="full",
+            agent_count=3,
             checkpoint_path=execution_root / ".prizmkit" / "specs" / "001-low" / "workflow-checkpoint.json",
             artifact_path=execution_root / ".prizmkit" / "specs" / "001-low",
             raw={},
@@ -1090,13 +1090,12 @@ def test_explicit_worktree_materializes_ignored_support_assets_before_prompt_and
     subprocess.run(["git", "add", ".gitignore", "tracked.txt"], cwd=project, check=True)
     subprocess.run(["git", "commit", "-m", "base"], cwd=project, check=True, stdout=subprocess.DEVNULL)
 
-    (project / ".claude" / "agents").mkdir(parents=True)
-    (project / ".claude" / "agents" / "prizm-dev-team-dev.md").write_text("dev agent", encoding="utf-8")
-    (project / ".claude" / "team-info.json").write_text("{}", encoding="utf-8")
+    (project / ".claude" / "commands").mkdir(parents=True)
+    (project / ".claude" / "commands" / "prizmkit.md").write_text("skill", encoding="utf-8")
     (project / ".prizmkit" / "prizm-docs").mkdir(parents=True)
     (project / ".prizmkit" / "prizm-docs" / "root.prizm").write_text("PRIZM_VERSION: 1\n", encoding="utf-8")
     (project / ".prizmkit" / "dev-pipeline" / "scripts").mkdir(parents=True)
-    (project / ".prizmkit" / "dev-pipeline" / "scripts" / "init-dev-team.py").write_text("# init", encoding="utf-8")
+    (project / ".prizmkit" / "dev-pipeline" / "scripts" / "init-change-artifact.py").write_text("# init", encoding="utf-8")
     (project / ".prizmkit" / "config.json").write_text("{}", encoding="utf-8")
     (project / ".prizmkit" / "manifest.json").write_text("{}", encoding="utf-8")
 
@@ -1128,18 +1127,18 @@ def test_explicit_worktree_materializes_ignored_support_assets_before_prompt_and
     def fake_generate_prompt(family, invocation, **kwargs):
         execution_root = kwargs["execution_root"]
         assert execution_root != project
-        assert (execution_root / ".claude" / "agents" / "prizm-dev-team-dev.md").is_file()
+        assert (execution_root / ".claude" / "commands" / "prizmkit.md").is_file()
         assert (execution_root / ".prizmkit" / "prizm-docs" / "root.prizm").is_file()
         assert (execution_root / ".prizmkit" / "config.json").is_file()
         assert (execution_root / ".prizmkit" / "manifest.json").is_file()
-        assert (execution_root / ".prizmkit" / "dev-pipeline" / "scripts" / "init-dev-team.py").is_file()
+        assert (execution_root / ".prizmkit" / "dev-pipeline" / "scripts" / "init-change-artifact.py").is_file()
         assert not (execution_root / ".prizmkit" / "dev-pipeline" / "run-feature.sh").exists()
         session_paths = kwargs["session_paths"]
         return PromptGenerationResult(
             output_path=session_paths.prompt_path,
             model="",
-            pipeline_mode="lite",
-            agent_count=1,
+            pipeline_mode="full",
+            agent_count=3,
             checkpoint_path=execution_root / ".prizmkit" / "specs" / "001-support" / "workflow-checkpoint.json",
             artifact_path=execution_root / ".prizmkit" / "specs" / "001-support",
             raw={},
@@ -1535,8 +1534,8 @@ def test_foreground_runner_emits_structured_feature_progress(monkeypatch, tmp_pa
     assert "Feature: F-001 — Readable output" in captured.err
     assert "Code retry: 1 / 3" in captured.err
     assert "Preflight: no user-visible changes to preserve before feature task F-001" in captured.err
-    assert "Pipeline mode: lite (Tier 1 — Single Agent)" in captured.err
-    assert "Agents: 1" in captured.err
+    assert "Pipeline mode: full (Tier 3 — Orchestrator + Reviewer)" in captured.err
+    assert "Agents: 3" in captured.err
     assert "Spawning AI CLI session: F-001-session-1" in captured.err
     assert "Session result: success" in captured.err
 

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

@@ -41,6 +41,17 @@ def run_cli(*args):
     )
 
 
+def _load_progress_parser_module():
+    import importlib.util
+
+    parser_path = PIPELINE_ROOT / "scripts" / "parse-stream-progress.py"
+    spec = importlib.util.spec_from_file_location("parse_stream_progress", parser_path)
+    module = importlib.util.module_from_spec(spec)
+    assert spec.loader is not None
+    spec.loader.exec_module(module)
+    return module
+
+
 def test_cli_help_exposes_python_runtime_command_groups():
     result = run_cli("--help")
 
@@ -793,7 +804,7 @@ def test_session_preamble_writes_redacted_start_command_for_all_launch_profiles(
 
 def test_headless_subagent_prompt_guidance_keeps_no_worktree_boundary_visible():
     guidance_files = [
-        REPO_ROOT / "dev-pipeline" / "templates" / "bootstrap-tier2.md",
+        REPO_ROOT / "dev-pipeline" / "templates" / "sections" / "phase-review-full.md",
         REPO_ROOT / "dev-pipeline" / "templates" / "bootstrap-tier3.md",
         REPO_ROOT / "core" / "skills" / "prizmkit-skill" / "prizmkit-code-review" / "SKILL.md",
     ]
@@ -840,6 +851,145 @@ def test_progress_parser_adds_required_metadata(tmp_path):
     assert data["permission_denial_count"] == 1
 
 
+
+def test_progress_parser_normalizes_claude_subagents_without_double_counting(tmp_path):
+    module = _load_progress_parser_module()
+    tracker = module.ProgressTracker()
+
+    tracker.process_event({"type": "system", "subtype": "init", "session_id": "claude-session", "cwd": str(tmp_path)})
+    tracker.process_event({
+        "type": "assistant",
+        "message": {"content": [{
+            "type": "tool_use",
+            "id": "tool-1",
+            "name": "Agent",
+            "input": {"description": "review code", "prompt": "check", "subagent_type": "reviewer"},
+        }]},
+    })
+    tracker.process_event({
+        "type": "system",
+        "subtype": "task_started",
+        "task_id": "task-1",
+        "tool_use_id": "tool-1",
+        "task_type": "in_process_teammate",
+        "subagent_type": "reviewer",
+        "description": "review code",
+    })
+    tracker.process_event({"type": "assistant", "parent_tool_use_id": "tool-1", "message": {"content": [{"type": "text", "text": "child activity"}]}})
+    tracker.process_event({"type": "system", "subtype": "task_started", "task_id": "bash-1", "task_type": "local_bash", "description": "ls"})
+    tracker.process_event({"type": "system", "subtype": "task_notification", "task_id": "task-1", "tool_use_id": "tool-1", "status": "completed", "summary": "done"})
+
+    data = tracker.to_dict()
+
+    assert data["subagent_stats_source"] == "session_log"
+    assert data["subagent_spawn_count"] == 1
+    assert data["active_subagent_count"] == 0
+    assert data["subagent_states"] == [{"status": "completed", "count": 1}]
+    assert "task-1" in data["subagent_observed_ids"]
+    assert "tool-1" in data["subagent_statistics"]["parent_activity_ids"]
+    assert all("bash" not in record["id"] for record in data["subagent_statistics"]["records"])
+
+
+def test_progress_parser_normalizes_codebuddy_agent_tools_with_deduplication():
+    module = _load_progress_parser_module()
+    tracker = module.ProgressTracker()
+    args = {"prompt": "inspect", "description": "inspect", "subagent_type": "Explore"}
+
+    tracker.process_event({
+        "type": "message",
+        "sessionId": "cb-session",
+        "cwd": "/tmp/project",
+        "role": "assistant",
+        "content": [{"type": "tool_use", "id": "call-1", "name": "Agent", "input": args}],
+    })
+    tracker.process_event({
+        "type": "function_call",
+        "sessionId": "cb-session",
+        "cwd": "/tmp/project",
+        "id": "call-1",
+        "name": "Agent",
+        "arguments": json.dumps(args),
+    })
+    tracker.process_event({
+        "type": "function_call",
+        "sessionId": "cb-session",
+        "cwd": "/tmp/project",
+        "id": "task-call",
+        "name": "TaskCreate",
+        "arguments": json.dumps({"description": "background", "subject": "status"}),
+    })
+
+    data = tracker.to_dict()
+
+    assert data["cb_session_id"] == "cb-session"
+    assert data["subagent_provider"] == "codebuddy"
+    assert data["subagent_spawn_count"] == 2
+    assert data["active_subagent_count"] == 2
+    assert {item["status"] for item in data["subagent_states"]} == {"running"}
+    assert len(data["subagent_statistics"]["records"]) == 2
+
+
+def test_progress_parser_normalizes_codex_collab_metadata_with_missing_fields():
+    module = _load_progress_parser_module()
+    tracker = module.ProgressTracker()
+
+    tracker.process_event({"type": "thread.started", "thread_id": "parent"})
+    tracker.process_event({
+        "type": "item.started",
+        "item": {
+            "type": "collab_tool_call",
+            "tool": "delegate",
+            "receiver_thread_ids": ["thread-a", "thread-b"],
+            "agents_states": {
+                "thread-a": {"status": "running", "message": "working"},
+                "thread-b": {"status": "completed", "message": "done"},
+            },
+        },
+    })
+    tracker.process_event({"type": "item.completed", "item": {"type": "collab_tool_call", "tool": "delegate"}})
+
+    data = tracker.to_dict()
+
+    assert data["event_format"] == "codex-json"
+    assert data["child_thread_ids"] == ["thread-a", "thread-b"]
+    assert data["subagent_spawn_count"] == 2
+    assert data["active_subagent_count"] == 1
+    assert {state["status"]: state["count"] for state in data["subagent_states"]} == {"running": 1, "completed": 1}
+    assert data["subagent_source_metadata"]["child_activity_source"] == "filesystem_liveness_only"
+
+
+def test_progress_parser_keeps_child_files_liveness_only(tmp_path, monkeypatch):
+    module = _load_progress_parser_module()
+    claude_home = tmp_path / "claude"
+    project_key = str(tmp_path).replace("\\", "-").replace("/", "-").replace(":", "")
+    subagents_dir = claude_home / "projects" / project_key / "parent-session" / "subagents"
+    subagents_dir.mkdir(parents=True)
+    child_log = subagents_dir / "agent-child.jsonl"
+    child_log.write_text("child activity", encoding="utf-8")
+    monkeypatch.setenv("CLAUDE_HOME", str(claude_home))
+
+    tracker = module.ProgressTracker()
+    tracker.process_event({"type": "system", "subtype": "init", "session_id": "parent-session", "cwd": str(tmp_path)})
+    tracker.process_event({
+        "type": "system",
+        "subtype": "task_started",
+        "task_id": "task-1",
+        "tool_use_id": "tool-1",
+        "task_type": "in_process_teammate",
+        "description": "agent",
+    })
+    first = tracker.to_dict()
+    child_log.write_text("child activity grew", encoding="utf-8")
+    tracker.refresh_child_session_activity(force=True)
+    second = tracker.to_dict()
+
+    assert first["subagent_spawn_count"] == 1
+    assert second["subagent_spawn_count"] == 1
+    assert second["child_total_bytes"] > first["child_total_bytes"]
+    assert second["child_session_files"]
+    assert second["child_activity_source"] == "filesystem_liveness_only"
+    assert second["subagent_statistics"]["source"] == "session_log"
+
 def test_session_dual_writes_progress_and_recovers_backup(tmp_path):
     from prizmkit_runtime.sessions import AISessionConfig, AISessionLauncher, recover_session_log
 
@@ -935,6 +1085,10 @@ def test_custom_session_launch_writes_existing_logs_and_progress(tmp_path):
     progress_data = json.loads(progress.read_text(encoding="utf-8"))
     assert progress_data["event_type_counts"]["result"] == 1
     assert progress_data["has_usage"] is True
+    assert progress_data["subagent_stats_source"] == "session_log"
+    assert progress_data["subagent_spawn_count"] == 0
+    assert progress_data["subagent_statistics"]["providers"] == []
+    assert progress_data["child_activity_source"] == "filesystem_liveness_only"
 
 
 @pytest.mark.parametrize("platform", ["claude", "codex", "codebuddy"])
@@ -1031,7 +1185,10 @@ def test_compact_progress_line_hides_stale_until_no_progress(tmp_path):
         json.dumps(
             {
                 "child_total_bytes": 2 * 1024 * 1024,
+                "child_session_files": [{"path": "a"}, {"path": "b"}],
                 "subagent_spawn_count": 5,
+                "active_subagent_count": 2,
+                "subagent_states": [{"status": "running", "count": 2}, {"status": "completed", "count": 3}],
                 "current_phase": "stream-derived-phase",
                 "current_tool": "Read",
                 "message_count": 465,
@@ -1059,7 +1216,9 @@ def test_compact_progress_line_hides_stale_until_no_progress(tmp_path):
 
     assert "▶ [HEARTBEAT]" in running_line
     assert "log: 4MB" in running_line
-    assert "child: 2MB/5" in running_line
+    assert "subagents: spawned=5 active=2 states:running=2,completed=3" in running_line
+    assert "child logs: 2MB/2 files" in running_line
+    assert "child: 2MB/5" not in running_line
     assert "phase: Retrospective" in running_line
     assert "stream-derived-phase" not in running_line
     assert "tool: Read" in running_line
@@ -1417,6 +1576,46 @@ def test_recovery_sessions_receive_live_heartbeat_configuration(tmp_path, monkey
     assert config.suppress_stream_output is True
 
 
+
+def test_session_summary_reports_normalized_subagents_and_child_liveness(tmp_path, capsys):
+    import prizmkit_runtime.runners as runners
+    from prizmkit_runtime.runner_models import SessionPaths
+
+    logs = tmp_path / "sessions" / "s1" / "logs"
+    logs.mkdir(parents=True)
+    session_log = logs / "session.log"
+    progress = logs / "progress.json"
+    session_log.write_text("one\ntwo\n", encoding="utf-8")
+    progress.write_text(
+        json.dumps({
+            "subagent_spawn_count": 2,
+            "active_subagent_count": 1,
+            "subagent_states": [{"status": "running", "count": 1}, {"status": "completed", "count": 1}],
+            "subagent_statistics": {"spawned": 2, "active": 1, "providers": ["claude"], "source": "session_log"},
+            "child_total_bytes": 2048,
+            "child_session_files": [{"path": "child-a"}],
+        }),
+        encoding="utf-8",
+    )
+    paths = SessionPaths(
+        session_dir=logs.parent,
+        prompt_path=logs.parent / "bootstrap-prompt.md",
+        logs_dir=logs,
+        session_log=session_log,
+        progress_json=progress,
+        heartbeat_json=logs / "heartbeat.json",
+        session_status_json=logs / "session-status.json",
+    )
+    result = type("Result", (), {"exit_code": 0})()
+    classification = type("Classification", (), {"session_status": "success"})()
+
+    runners._emit_session_summary(result, paths, classification)
+
+    captured = capsys.readouterr()
+    assert "Subagents: spawned=2, active=1, states: running=1, completed=1 (claude; source=session.log)" in captured.err
+    assert "Child log activity: 2KB across 1 files (heartbeat liveness only)" in captured.err
+    assert "Subagent calls detected" not in captured.err
+
 def test_session_live_output_does_not_forward_cli_output_without_verbose(tmp_path, capsys):
     from prizmkit_runtime.sessions import AISessionConfig, AISessionLauncher
 
@@ -1771,7 +1970,8 @@ def test_git_status_safe_ignores_worktree_support_assets(monkeypatch, tmp_path):
     joined = " ".join(status_args)
     assert ":(top,exclude).prizmkit-worktree" in status_args
     assert ":(top,exclude).claude" in status_args
-    assert ":(top,exclude).prizmkit/dev-pipeline/scripts" in status_args
+    assert ":(top,exclude).prizmkit/dev-pipeline" in status_args
+    assert ":(top,exclude,glob).prizmkit/dev-pipeline/**" in status_args
     assert all(exclude in status_args for exclude in HIDDEN_TOOL_WORKTREE_EXCLUDES)
     assert ".prizmkit-worktree" in joined
 
@@ -1958,6 +2158,26 @@ def test_preflight_ready_commit_preserves_dirty_changes_without_repo_git_identit
     assert _short_status(repo) == ""
 
 
+def test_preflight_ready_commit_force_stages_visible_file_when_prizmkit_dir_is_ignored(tmp_path):
+    from prizmkit_runtime.runner_bookkeeping import commit_preflight_ready_changes
+
+    repo = tmp_path / "repo"
+    _init_temp_repo(repo)
+    (repo / ".gitignore").write_text(".prizmkit/*\n", encoding="utf-8")
+    subprocess.run(["git", "add", ".gitignore"], cwd=repo, check=True)
+    subprocess.run(["git", "commit", "-m", "ignore prizmkit"], cwd=repo, check=True, stdout=subprocess.DEVNULL)
+    (repo / ".prizmkit" / "dev-pipeline" / "templates").mkdir(parents=True)
+    (repo / ".prizmkit" / "dev-pipeline" / "templates" / "bootstrap-prompt.md").write_text("ignored runtime\n", encoding="utf-8")
+    (repo / "visible.txt").write_text("dirty\n", encoding="utf-8")
+
+    result = commit_preflight_ready_changes(repo, "F-008")
+
+    assert result.committed
+    assert _head_commit_message(repo) == "chore: ready for F-008"
+    assert _head_files(repo) == {"visible.txt"}
+    assert _short_status(repo) == ""
+
+
 def test_materialize_worktree_support_assets_copies_ignored_assets_without_retired_shell_sources(tmp_path):
     from prizmkit_runtime.gitops import (
         BranchContext,
@@ -1974,8 +2194,8 @@ def test_materialize_worktree_support_assets_copies_ignored_assets_without_retir
     subprocess.run(["git", "add", ".gitignore"], cwd=repo, check=True)
     subprocess.run(["git", "commit", "-m", "ignore support"], cwd=repo, check=True, stdout=subprocess.DEVNULL)
 
-    (repo / ".claude" / "agents").mkdir(parents=True)
-    (repo / ".claude" / "agents" / "prizm-dev-team-dev.md").write_text("dev", encoding="utf-8")
+    (repo / ".claude" / "commands").mkdir(parents=True)
+    (repo / ".claude" / "commands" / "prizmkit.md").write_text("skill", encoding="utf-8")
     (repo / ".prizmkit" / "prizm-docs").mkdir(parents=True)
     (repo / ".prizmkit" / "prizm-docs" / "root.prizm").write_text("PRIZM_VERSION: 1\n", encoding="utf-8")
     (repo / ".prizmkit" / "config.json").write_text("{}", encoding="utf-8")
@@ -1993,12 +2213,12 @@ def test_materialize_worktree_support_assets_copies_ignored_assets_without_retir
     )
     setup = ensure_linked_worktree(runtime)
     assert setup.ok
-    assert not (runtime.worktree_path / ".claude" / "agents" / "prizm-dev-team-dev.md").exists()
+    assert not (runtime.worktree_path / ".claude" / "commands" / "prizmkit.md").exists()
 
     result = materialize_worktree_support_assets(runtime)
 
     assert result.ok
-    assert (runtime.worktree_path / ".claude" / "agents" / "prizm-dev-team-dev.md").is_file()
+    assert (runtime.worktree_path / ".claude" / "commands" / "prizmkit.md").is_file()
     assert (runtime.worktree_path / ".prizmkit" / "prizm-docs" / "root.prizm").is_file()
     assert (runtime.worktree_path / ".prizmkit" / "config.json").is_file()
     assert (runtime.worktree_path / ".prizmkit" / "manifest.json").is_file()

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.118",
+  "version": "1.1.120",
   "skills": {
     "prizmkit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

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

@@ -47,7 +47,7 @@ If you believe the task is better suited for a different workflow, you MUST:
 - Claude Code → `CLAUDE.md`
 - CodeBuddy → `CODEBUDDY.md`
 - `all` → all three files.
-- Only when the manifest is missing, fall back to installed PrizmKit-owned platform files such as `.codex/agents/*.toml`, `.claude/commands/prizmkit.md`, or `.codebuddy/skills/prizmkit/SKILL.md`. Do not treat a generic `.agents/` directory as Codex.
+- Only when the manifest is missing, fall back to installed PrizmKit-owned platform files such as `.claude/commands/prizmkit.md`, `.agents/skills/prizmkit/SKILL.md`, or `.codebuddy/skills/prizmkit/SKILL.md`. Do not treat a generic `.agents/` directory as Codex.
 
 **After planning is complete**, you MUST:
 1. Present the summary of captured project-level context (vision, conventions, architecture decisions, project brief)
@@ -126,7 +126,7 @@ Before questions, check optional context files (never block if absent):
 Note:
 - This skill **reads** `.prizmkit/config.json` if present.
 - This skill does **not** create `.prizmkit/config.json` directly.
-- Creation/update is handled by bootstrap/init flows (e.g., `prizmkit-init`, `.prizmkit/dev-pipeline/scripts/init-dev-team.py`).
+- Creation/update is handled by bootstrap/init flows (e.g., `prizmkit-init`, `.prizmkit/dev-pipeline/scripts/init-change-artifact.py`).
 
 ## Interaction Style (Hard Rule)
 

package/bundled/skills/app-planner/references/architecture-decisions.md

@@ -29,9 +29,7 @@ After Phase 2 (Confirm constraints and tech assumptions), before Phase 3 (Captur
    - `codex` → append to `AGENTS.md`
    - `claude` → append to `CLAUDE.md`
    - `codebuddy` → append to `CODEBUDDY.md`
-   - `all` → append to all three files. Legacy manifests may contain `both`; treat it as read-only compatibility and append to `CLAUDE.md` and `CODEBUDDY.md` only when encountered.
-   - Only when the manifest is missing, fall back to PrizmKit-owned install artifacts: `.codex/agents/*.toml`, `.claude/commands/prizmkit.md`, `.codebuddy/skills/prizmkit/SKILL.md`.
-   - Do not treat a generic `.agents/` directory as Codex; it may contain unrelated third-party skills.
+   - `all` → append to all three files. 
    - If no platform can be determined, skip (no project instruction file).
 
 2. **Check for existing section** — read the target file and look for `### Architecture Decisions` heading:

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

@@ -46,13 +46,15 @@ Before any action, validate:
 
 1. **bugfix pipeline exists**: Confirm `.prizmkit/dev-pipeline/cli.py` is present
 2. **For start**: `.prizmkit/plans/bug-fix-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
-3. **Dependencies**: `python3`, `git`, and AI CLI (`cbc` or `claude`) must be in PATH
+3. **Dependencies**: `python3`, `git`, and the configured AI CLI must be in PATH. Resolve and report the AI CLI from `AI_CLI` env, then `.prizmkit/config.json` `ai_cli`, then fallback to `claude` only when neither is configured. Read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check before running the AI CLI check.
 4. **Python version**: Requires Python 3.10+ for the unified dev-pipeline runtime
 5. **Browser tools** (optional): If any bug has `browser_interaction` field, check the corresponding tool is available. Bugs may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
 
 Quick check:
 ```bash
-command -v python3 && command -v git && (command -v cbc || command -v claude) && echo "All dependencies OK"
+command -v python3 >/dev/null && command -v git >/dev/null && echo "Core dependencies OK"
+# AI CLI check: read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check.
+# It must print `Configured AI CLI: <name>` and verify that exact executable.
 # Optional: browser interaction support (check both tools — bugs may use either)
 command -v playwright-cli && echo "playwright-cli OK" || echo "playwright-cli not found (playwright browser verification will be skipped)"
 command -v opencli && echo "opencli OK" || echo "opencli not found (opencli browser verification will be skipped)"

package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md

@@ -2,6 +2,45 @@
 
 Environment variable mappings for the bugfix launcher.
 
+## Configured AI CLI Prerequisite Check
+
+Read this section during launcher prerequisite validation before reporting AI CLI availability.
+
+Runtime AI CLI selection is config-driven. Resolve the executable name in this order:
+1. `AI_CLI` environment variable when set.
+2. `.prizmkit/config.json` `ai_cli` when present.
+3. `claude` fallback only when neither is configured.
+
+Run this quick check from the project root:
+```bash
+command -v python3 >/dev/null && command -v git >/dev/null || { echo "python3 or git missing"; exit 1; }
+AI_CLI="$(
+  python3 - <<'PY'
+import json, os, shlex
+from pathlib import Path
+cli = os.environ.get("AI_CLI", "").strip()
+if not cli:
+    config_path = Path(".prizmkit/config.json")
+    if config_path.is_file():
+        try:
+            data = json.loads(config_path.read_text(encoding="utf-8"))
+            cli = str(data.get("ai_cli") or "").strip()
+        except (OSError, json.JSONDecodeError):
+            cli = ""
+cli = cli or "claude"
+try:
+    print(shlex.split(cli)[0])
+except ValueError:
+    print(cli.split()[0] if cli.split() else "claude")
+PY
+)"
+printf 'Configured AI CLI: %s\n' "$AI_CLI"
+command -v "$AI_CLI" >/dev/null && printf 'AI CLI OK: %s\n' "$(command -v "$AI_CLI")" || { printf 'AI CLI not found: %s\n' "$AI_CLI"; exit 1; }
+echo "All dependencies OK"
+```
+
+Report the configured executable, for example `Configured AI CLI: claude`. Do not report the first arbitrary PATH match such as `cbc` when project config selects a different AI CLI.
+
 ## Environment Variable Mapping
 
 Translating user responses to env vars:
@@ -73,7 +112,7 @@ Note: Bug filter defaults to all bugs. Runtime selects eligible bugs in stable l
 | `.prizmkit/plans/bug-fix-list.json` not found | Tell user to run `bug-planner` skill first |
 | `python3` not installed | Install Python 3.10+ and rerun the Python runtime command |
 | `git` not installed | Install git; the Python runtime uses git for branch/worktree/status operations |
-| `cbc`/`claude` not in PATH | Check AI CLI installation |
+| Configured AI CLI not in PATH | Install the executable selected by `AI_CLI` or `.prizmkit/config.json` `ai_cli`, or update the config to a CLI available in PATH. |
 | Bugfix pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `python3 ./.prizmkit/dev-pipeline/cli.py daemon bugfix start .prizmkit/plans/bug-fix-list.json` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `python3 ./.prizmkit/dev-pipeline/cli.py daemon bugfix logs --lines 20` |

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

@@ -40,13 +40,15 @@ Before any action, validate:
 
 1. **dev-pipeline exists**: Confirm `.prizmkit/dev-pipeline/cli.py` is present
 2. **For start**: `.prizmkit/plans/feature-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
-3. **Dependencies**: `python3`, `git`, and AI CLI (`cbc` or `claude`) must be in PATH
+3. **Dependencies**: `python3`, `git`, and the configured AI CLI must be in PATH. Resolve and report the AI CLI from `AI_CLI` env, then `.prizmkit/config.json` `ai_cli`, then fallback to `claude` only when neither is configured. Read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check before running the AI CLI check.
 4. **Python version**: Requires Python 3.10+ for the unified dev-pipeline runtime
 5. **Browser tools** (optional): If any feature has `browser_interaction` field, check the corresponding tool is available. Features may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
 
 Quick check:
 ```bash
-command -v python3 && command -v git && (command -v cbc || command -v claude) && echo "All dependencies OK"
+command -v python3 >/dev/null && command -v git >/dev/null && echo "Core dependencies OK"
+# AI CLI check: read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check.
+# It must print `Configured AI CLI: <name>` and verify that exact executable.
 # Optional: browser interaction support (check both tools — features may use either)
 command -v playwright-cli && echo "playwright-cli OK" || echo "playwright-cli not found (playwright browser verification will be skipped)"
 command -v opencli && echo "opencli OK" || echo "opencli not found (opencli browser verification will be skipped)"

package/bundled/skills/feature-pipeline-launcher/references/configuration.md

@@ -22,6 +22,45 @@ Asked only when the user chose "Yes" to Advanced config in step 6.
 - xhigh — Extensive reasoning (`PRIZMKIT_EFFORT=xhigh`)
 - max — Maximum reasoning, Claude Code only (`PRIZMKIT_EFFORT=max`)
 
+## Configured AI CLI Prerequisite Check
+
+Read this section during launcher prerequisite validation before reporting AI CLI availability.
+
+Runtime AI CLI selection is config-driven. Resolve the executable name in this order:
+1. `AI_CLI` environment variable when set.
+2. `.prizmkit/config.json` `ai_cli` when present.
+3. `claude` fallback only when neither is configured.
+
+Run this quick check from the project root:
+```bash
+command -v python3 >/dev/null && command -v git >/dev/null || { echo "python3 or git missing"; exit 1; }
+AI_CLI="$(
+  python3 - <<'PY'
+import json, os, shlex
+from pathlib import Path
+cli = os.environ.get("AI_CLI", "").strip()
+if not cli:
+    config_path = Path(".prizmkit/config.json")
+    if config_path.is_file():
+        try:
+            data = json.loads(config_path.read_text(encoding="utf-8"))
+            cli = str(data.get("ai_cli") or "").strip()
+        except (OSError, json.JSONDecodeError):
+            cli = ""
+cli = cli or "claude"
+try:
+    print(shlex.split(cli)[0])
+except ValueError:
+    print(cli.split()[0] if cli.split() else "claude")
+PY
+)"
+printf 'Configured AI CLI: %s\n' "$AI_CLI"
+command -v "$AI_CLI" >/dev/null && printf 'AI CLI OK: %s\n' "$(command -v "$AI_CLI")" || { printf 'AI CLI not found: %s\n' "$AI_CLI"; exit 1; }
+echo "All dependencies OK"
+```
+
+Report the configured executable, for example `Configured AI CLI: claude`. Do not report the first arbitrary PATH match such as `cbc` when project config selects a different AI CLI.
+
 ## Environment Variable Mapping
 
 Translating user responses to env vars:
@@ -55,7 +94,7 @@ Not exposed in interactive menu, pass via `--env`:
 | `.prizmkit/plans/feature-list.json` not found | Tell user to run `feature-planner` skill first |
 | `python3` not installed | Install Python 3.10+ and rerun the Python runtime command |
 | `git` not installed | Install git; the Python runtime uses git for branch/worktree/status operations |
-| `cbc`/`claude` not in PATH | Check AI CLI installation |
+| Configured AI CLI not in PATH | Install the executable selected by `AI_CLI` or `.prizmkit/config.json` `ai_cli`, or update the config to a CLI available in PATH. |
 | Pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `python3 ./.prizmkit/dev-pipeline/cli.py daemon feature start .prizmkit/plans/feature-list.json` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `python3 ./.prizmkit/dev-pipeline/cli.py daemon feature logs --lines 20` |