prizmkit 1.1.119 → 1.1.120

package/bin/create-prizmkit.js

@@ -34,8 +34,6 @@ program
   .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, or all')
   .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
   .option('--skills <suite>', 'Skill suite: core, minimal, or recommended:<type> (frontend/backend/fullstack/library)', 'core')
-  .option('--team', 'Enable multi-agent team mode (default: true)')
-  .option('--no-team', 'Disable multi-agent team mode')
   .option('--pipeline', 'Install dev-pipeline (default: true)')
   .option('--no-pipeline', 'Disable dev-pipeline')
   .option('--playwright-cli', 'Install playwright-cli browser tool (default: true)')
@@ -64,7 +62,7 @@ program
   .command('uninstall [directory]')
   .description('Remove PrizmKit files from an existing project')
   .option('--dry-run', 'Show what would be removed without deleting')
-  .option('--global-team', 'Also remove ~/.codebuddy/teams/prizm-dev-team')
+  .option('--global-team', 'Also remove legacy global CodeBuddy team config')
   .action(async (directory = '.', options) => {
     try {
       await runClean(directory, options);
@@ -99,8 +97,6 @@ program
   .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex)')
   .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
   .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
-  .option('--team', 'Enable multi-agent team mode')
-  .option('--no-team', 'Disable multi-agent team mode')
   .option('--pipeline', 'Enable dev-pipeline')
   .option('--no-pipeline', 'Disable dev-pipeline')
   .option('--non-interactive', 'Skip interactive prompts')

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.119",
-  "bundledAt": "2026-07-09T15:35:51.674Z",
-  "bundledFrom": "8a729da"
+  "frameworkVersion": "1.1.120",
+  "bundledAt": "2026-07-10T01:27:14.094Z",
+  "bundledFrom": "3d5e4ff"
 }

package/bundled/dev-pipeline/README.md

@@ -1,6 +1,6 @@
 # dev-pipeline
 
-Autonomous development pipeline that drives the `prizm-dev-team` multi-agent team through iterative AI CLI sessions, implementing a complete app feature-by-feature from a `.prizmkit/plans/feature-list.json` specification. Includes a parallel bug-fix pipeline for `.prizmkit/plans/bug-fix-list.json`.
+Autonomous development pipeline that drives iterative AI CLI sessions through PrizmKit skills, implementing feature, bugfix, and refactor work from `.prizmkit/plans/*.json` specifications.
 
 ## Prerequisites
 
@@ -258,12 +258,12 @@ python3 scripts/init-bugfix-pipeline.py \
 
 ---
 
-### `scripts/init-dev-team.py` — Initialize PrizmKit Directories
+### `scripts/init-change-artifact.py` — Initialize PrizmKit Directories
 
-Creates per-feature directory structure for PrizmKit agent artifacts.
+Creates per-feature directory structure for PrizmKit change artifacts.
 
 ```bash
-python3 scripts/init-dev-team.py \
+python3 scripts/init-change-artifact.py \
   --project-root <path> \
   [--feature-id <id>] \
   [--feature-slug <slug>]
@@ -275,7 +275,7 @@ python3 scripts/init-dev-team.py \
 
 ### `scripts/generate-bootstrap-prompt.py` — Generate Feature Session Prompt
 
-Renders a session-specific bootstrap prompt from a tier template and .prizmkit/plans/feature-list.json.
+Renders a session-specific bootstrap prompt from modular `templates/sections/` content and `.prizmkit/plans/feature-list.json`.
 
 ```bash
 python3 scripts/generate-bootstrap-prompt.py \
@@ -291,13 +291,15 @@ python3 scripts/generate-bootstrap-prompt.py \
   [--mode lite|standard|full]
 ```
 
-**Template auto-selection by complexity:**
+**Prompt assembly:**
 
-| `estimated_complexity` | Pipeline Mode | Template |
-|------------------------|--------------|----------|
-| `low` | lite | `bootstrap-tier1.md` (single agent) |
-| `medium` | standard | `bootstrap-tier2.md` (dual agent) |
-| `high` / `critical` | full | `bootstrap-tier3.md` (full team) |
+| Condition | Prompt Source | Behavior |
+|-----------|---------------|----------|
+| `templates/sections/` exists and no `--template` | Modular sections | Uses the full/tier3-equivalent guidance for every `estimated_complexity` value |
+| Custom `--template <path>` supplied | Caller template | Renders the explicit template with legacy placeholder/conditional support |
+| Sections unavailable and no custom template | `bootstrap-tier3.md`, then `bootstrap-prompt.md` | Monolithic compatibility fallback; never defaults to retired reduced-tier templates |
+
+`estimated_complexity` remains in feature metadata and rendered Session Context for planning summaries and compatibility, but it no longer chooses a reduced prompt template.
 
 **Output (JSON to stdout):**
 
@@ -307,10 +309,10 @@ python3 scripts/generate-bootstrap-prompt.py \
 
 The `model` field is extracted from the feature's `"model"` field in .prizmkit/plans/feature-list.json (empty string if not specified). Used by `cli.py feature` to set `--model` on the AI CLI.
 
-**Conditional blocks resolved:**
+**Conditional blocks resolved for explicit legacy templates:**
 - `{{IF_RESUME}}` / `{{IF_FRESH_START}}` — Resume vs fresh start
 - `{{IF_INIT_NEEDED}}` / `{{IF_INIT_DONE}}` — PrizmKit init status
-- `{{IF_MODE_LITE}}` / `{{IF_MODE_STANDARD}}` / `{{IF_MODE_FULL}}` — Pipeline mode blocks
+- `{{IF_MODE_LITE}}` / `{{IF_MODE_STANDARD}}` / `{{IF_MODE_FULL}}` — Compatibility mode blocks
 
 ---
 
@@ -686,17 +688,19 @@ cli.py feature run command
   +- loop -> next feature
 ```
 
-### Tiered Execution (per feature session)
+### Unified Feature Prompt Execution
+
+Feature bootstrap prompts use the same full/tier3-equivalent modular section composition for every feature task. Complexity metadata is still retained for planning, summaries, dependency/status compatibility, and rendered Session Context, but it no longer reduces prompt guidance.
 
-The bootstrap prompt adapts based on feature complexity:
+| Feature metadata | Normal prompt source | Execution guidance |
+|------------------|----------------------|--------------------|
+| `estimated_complexity: low` | `templates/sections/` full composition | Main orchestrator builds context, plans, implements directly, runs review/test/browser/commit gates |
+| `estimated_complexity: medium` | `templates/sections/` full composition | Same full guidance |
+| `estimated_complexity: high` / `critical` | `templates/sections/` full composition | Same full guidance |
 
-| Tier | Template | Agents | Use Case |
-|------|----------|--------|----------|
-| Tier 1 (lite) | `bootstrap-tier1.md` | Single agent handles everything | Low complexity features |
-| Tier 2 (standard) | `bootstrap-tier2.md` | Orchestrator implements directly + Reviewer gate | Medium/high complexity |
-| Tier 3 (full) | `bootstrap-tier3.md` | Orchestrator implements directly + strongest planning, testing, and Reviewer gates | High/critical complexity |
+Monolithic compatibility fallback uses `bootstrap-tier3.md` before `bootstrap-prompt.md` only when sections are unavailable and no custom `--template` was supplied.
 
-**Self-evolve mode:** Uses Tier 3 template with additional framework guardrails for developing the PrizmKit framework itself.
+**Self-evolve mode:** Uses the same full feature prompt guidance with additional framework guardrails supplied by the feature context.
 
 ### Feature Dependency Resolution
 
@@ -718,7 +722,7 @@ Features are executed in dependency order via DAG:
 ### Heartbeat Output
 
 ```
-  > [HEARTBEAT] 1m30s elapsed | log: 245KB (+12480B) | Creating team prizm-dev-team-F-001...
+  > [HEARTBEAT] 1m30s elapsed | log: 245KB (+12480B) | Creating feature change artifacts...
   > [HEARTBEAT] 2m0s elapsed | log: 389KB (+147456B) | Generating spec.md for feature...
   @ [HEARTBEAT] 2m30s elapsed | log: 389KB (+0B) | (waiting for AI response)
 ```
@@ -863,7 +867,7 @@ cli.py bugfix run command
 |   +-- utils.py                     # Shared Python utilities (JSON I/O, logging)
 |   +-- init-pipeline.py             # Validate .prizmkit/plans/feature-list.json + create .prizmkit/state/features/
 |   +-- init-bugfix-pipeline.py      # Validate .prizmkit/plans/bug-fix-list.json + create .prizmkit/state/bugfix/
-|   +-- init-dev-team.py             # Create .prizmkit/specs/{slug}/ directories
+|   +-- init-change-artifact.py      # Create .prizmkit/specs/{slug}/ directories
 |   +-- generate-bootstrap-prompt.py # Render feature session prompt from template
 |   +-- generate-bugfix-prompt.py    # Render bugfix session prompt from template
 |   +-- check-session-status.py      # Parse session-status.json outcome
@@ -873,18 +877,17 @@ cli.py bugfix run command
 |   +-- parse-stream-progress.py     # Real-time stream-json progress parser
 |
 +-- templates/
-|   +-- bootstrap-tier1.md           # Tier 1 prompt template (single agent, lite)
-|   +-- bootstrap-tier2.md           # Tier 2 prompt template (dual agent, standard)
-|   +-- bootstrap-tier3.md           # Tier 3 prompt template (full team, full)
-|   +-- bootstrap-prompt.md          # Legacy monolithic template (fallback)
-|   +-- bugfix-bootstrap-prompt.md   # Bug-fix session prompt template
-|   +-- feature-list-schema.json     # JSON schema for .prizmkit/plans/feature-list.json
-|   +-- bug-fix-list-schema.json     # JSON schema for .prizmkit/plans/bug-fix-list.json
-|   +-- session-status-schema.json   # JSON schema for session-status.json
+|   +-- sections/                      # Modular feature prompt sections (normal full guidance path)
+|   +-- bootstrap-tier3.md              # Legacy monolithic full prompt fallback
+|   +-- bootstrap-prompt.md             # Last-resort monolithic fallback
+|   +-- bugfix-bootstrap-prompt.md      # Bug-fix session prompt template
+|   +-- feature-list-schema.json        # JSON schema for .prizmkit/plans/feature-list.json
+|   +-- bug-fix-list-schema.json        # JSON schema for .prizmkit/plans/bug-fix-list.json
+|   +-- session-status-schema.json      # JSON schema for session-status.json
 |
 +-- assets/
 |   +-- feature-list-example.json    # Example feature list
-|   +-- prizm-dev-team-integration.md # Pipeline + prizm-dev-team integration docs
+|   +-- skill-subagent-integration.md # Pipeline + skill-owned subagent integration docs
 |
 +-- tests/
 |   +-- conftest.py                  # Pytest configuration
@@ -909,14 +912,14 @@ cli.py bugfix run command
 
 ---
 
-## Agent and Team Configuration
+## Skill-Owned Subagent References
 
-| Platform | Agent Definitions | Team Config |
-|----------|------------------|-------------|
-| Claude Code | `.claude/agents/prizm-dev-team-*.md` | `.claude/team-info.json` |
-| CodeBuddy | `.codebuddy/agents/prizm-dev-team-*.md` | `~/.codebuddy/teams/prizm-dev-team/config.json` |
+| Skill | Reference | Purpose |
+|-------|-----------|---------|
+| `/prizmkit-implement` | skill-local implementation-subagent procedure | Optional narrow implementation delegation in the active checkout |
+| `/prizmkit-code-review` | skill-local reviewer prompt | Required independent reviewer loop in the active checkout |
 
-Agent files include Dev and Reviewer definitions used by prompt flows. `prizm-dev-team-dev.md` remains available for targeted specialized handoffs, but top-level feature implementation is performed directly by the main orchestrator with `/prizmkit-implement`. Paths are auto-resolved by prompt generators.
+Platform-installed named agents and team topology are not part of the current runtime model. Prompt flows call skills, and the skills own any inline subagent prompts plus active-checkout/no-worktree constraints.
 
 ---
 

package/bundled/dev-pipeline/assets/skill-subagent-integration.md

@@ -0,0 +1,76 @@
+# Skill Subagent Integration Guide
+
+## Overview
+
+`dev-pipeline` drives feature, bugfix, and refactor sessions through the unified Python outer loop. Each iteration spawns a new AI CLI session with a bootstrap prompt that makes the main session orchestrator responsible for planning, implementation, review coordination, testing, retrospective, and commit.
+
+Implementation and review behavior is owned by skills:
+- `/prizmkit-implement` executes plan tasks directly and may use its local implementation-subagent reference for narrow active-checkout delegation.
+- `/prizmkit-code-review` owns its internal inline reviewer subagent review loop through its local reviewer prompt reference.
+
+## Architecture
+
+```text
+dev-pipeline (outer loop)
+    |
+    +-- cli.py feature/bugfix/refactor       Python runtime CLI — picks next item, spawns CLI
+    +-- scripts/                             Python state and prompt management scripts
+    +-- templates/                           Session prompt templates and sections
+    |
+    +-- [per session] AI CLI
+            |
+            +-- Context snapshot + specify + plan (orchestrator)
+            +-- Local plan/spec review loop inside prizmkit-plan
+            +-- Implement through /prizmkit-implement
+            +-- Code review through /prizmkit-code-review inline reviewer loop
+            +-- Scoped test gate and browser attempt
+            +-- Retrospective & commit (orchestrator)
+```
+
+## Skill-Owned References
+
+| Skill | Reference | Purpose |
+|-------|-----------|---------|
+| `/prizmkit-implement` | skill-local `references/implementation-subagent-procedure.md` | Optional narrow implementation delegation contract |
+| `/prizmkit-code-review` | skill-local `references/reviewer-agent-prompt.md` | Required independent reviewer-loop prompt |
+
+The orchestrator role is handled by the main agent directly — no separate platform agent definition or team topology is installed.
+
+## Active Checkout Contract
+
+Any skill-level implementation or review subagent must run in the expected active git top-level. The prompt contract forbids git worktrees, tool-created worktree isolation, copied repository checkouts, remote isolated checkouts, branch switching, and operating outside the expected active checkout.
+
+Pipeline runner-owned linked worktrees are an outer runtime option. They do not authorize skill-level subagents to create or enter their own worktrees.
+
+## Pipeline Scripts
+
+Located at `.prizmkit/dev-pipeline/scripts/`:
+
+| Script | Purpose |
+|--------|---------|
+| `init-pipeline.py` | Initialize feature pipeline state |
+| `init-bugfix-pipeline.py` | Initialize bugfix pipeline state |
+| `init-refactor-pipeline.py` | Initialize refactor pipeline state |
+| `init-change-artifact.py` | Initialize feature change-artifact directories |
+| `generate-bootstrap-prompt.py` | Render feature bootstrap prompt with feature context |
+| `generate-bugfix-prompt.py` | Render bugfix bootstrap prompt with bug context |
+| `generate-refactor-prompt.py` | Render refactor bootstrap prompt with refactor context |
+| `update-feature-status.py` | Update feature status after session |
+| `update-bug-status.py` | Update bug status after session |
+| `update-refactor-status.py` | Update refactor status after session |
+| `check-session-status.py` | Read and validate session-status output |
+| `detect-stuck.py` | Detect stuck or stale pipeline sessions |
+| `parse-stream-progress.py` | Parse AI CLI output stream for progress tracking |
+| `utils.py` | Shared utility functions for pipeline scripts |
+
+## Session Lifecycle
+
+1. Runtime selects the next eligible item from the plan list.
+2. Prompt generator renders a session prompt and checkpoint file.
+3. AI CLI session executes the generated prompt in the active project checkout or runner-owned worktree.
+4. Session writes status and completion artifacts.
+5. Runtime updates plan-list status and propagates completion notes.
+
+## Failure Recovery
+
+The generated checkpoint file is the recovery truth. Continuation prompts resume from the first pending or in-progress checkpoint step and prefer synthesized artifacts over full log rereads.

package/bundled/dev-pipeline/prizmkit_runtime/config.py

@@ -269,10 +269,7 @@ def _installed_platform_cli(
     paths: RuntimePaths,
     env: Mapping[str, str],
 ) -> tuple[str | None, str | None]:
-    if (
-        (paths.project_root / ".codex" / "agents" / "prizm-dev-team-dev.toml").is_file()
-        or (paths.project_root / ".agents" / "skills" / "prizmkit" / "SKILL.md").is_file()
-    ):
+    if (paths.project_root / ".agents" / "skills" / "prizmkit" / "SKILL.md").is_file():
         resolved = _resolve_cli_name("codex", env)
         if resolved:
             return resolved, "installed-platform:codex"
@@ -280,10 +277,7 @@ def _installed_platform_cli(
         resolved = _resolve_cli_name("claude", env)
         if resolved:
             return resolved, "installed-platform:claude"
-    if (
-        (paths.project_root / ".codebuddy" / "agents" / "prizm-dev-team-dev.md").is_file()
-        or (paths.project_root / ".codebuddy" / "skills" / "prizmkit" / "SKILL.md").is_file()
-    ):
+    if (paths.project_root / ".codebuddy" / "skills" / "prizmkit" / "SKILL.md").is_file():
         resolved = _resolve_cli_name("cbc", env)
         if resolved:
             return resolved, "installed-platform:codebuddy"

package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py

@@ -19,7 +19,7 @@ UTILITY_ENTRYPOINTS = {
     "generate-recovery-prompt": "scripts/generate-recovery-prompt.py",
     "generate-refactor-prompt": "scripts/generate-refactor-prompt.py",
     "init-bugfix-pipeline": "scripts/init-bugfix-pipeline.py",
-    "init-dev-team": "scripts/init-dev-team.py",
+    "init-change-artifact": "scripts/init-change-artifact.py",
     "init-pipeline": "scripts/init-pipeline.py",
     "init-refactor-pipeline": "scripts/init-refactor-pipeline.py",
     "parse-stream-progress": "scripts/parse-stream-progress.py",

package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py

@@ -41,9 +41,9 @@ class SkillResolution:
 
 
 _PLATFORM_MARKERS = {
-    "claude": (".claude/agents", ".claude/commands", ".claude/skills"),
-    "codex": (".codex/agents", ".agents/skills"),
-    "codebuddy": (".codebuddy/agents", ".codebuddy/skills"),
+    "claude": (".claude/commands", ".claude/skills"),
+    "codex": (".agents/skills",),
+    "codebuddy": (".codebuddy/skills",),
 }
 
 

package/bundled/dev-pipeline/prizmkit_runtime/runners.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import json
 import sys
 import time
+from collections.abc import Mapping
 from pathlib import Path
 
 from .commands import CommandResult  # type: ignore  # imported only at runtime by commands.py
@@ -336,6 +337,32 @@ def _progress_data(path: Path) -> dict[str, object]:
     return data if isinstance(data, dict) else {}
 
 
+def _subagent_state_summary(progress: Mapping[str, object]) -> str:
+    states = progress.get("subagent_states")
+    if not isinstance(states, list):
+        return ""
+    parts = []
+    for item in states:
+        if not isinstance(item, Mapping):
+            continue
+        status = str(item.get("status") or "unknown")
+        count = int(item.get("count") or 0)
+        if count:
+            parts.append(f"{status}={count}")
+    return ", ".join(parts)
+
+
+def _child_log_activity_summary(progress: Mapping[str, object]) -> str:
+    child_bytes = int(progress.get("child_total_bytes") or 0)
+    child_files = progress.get("child_session_files")
+    child_file_count = len(child_files) if isinstance(child_files, list) else 0
+    if not child_bytes and not child_file_count:
+        return ""
+    if child_file_count:
+        return f"{_bytes_text(child_bytes)} across {child_file_count} files"
+    return _bytes_text(child_bytes)
+
+
 def _emit_prompt_summary(prompt: PromptGenerationResult, session_id: str) -> None:
     if prompt.pipeline_mode:
         _emit_info(f"Pipeline mode: {_pipeline_mode_label(prompt.pipeline_mode)}")
@@ -359,9 +386,24 @@ def _emit_session_summary(session_result, session_paths: SessionPaths, classific
     _emit_info(f"exit_code={getattr(session_result, 'exit_code', None)}")
     _emit_info(f"Session result: {classification.session_status}")
     progress = _progress_data(session_paths.progress_json)
-    subagent_calls = int(progress.get("subagent_spawn_count") or 0)
-    if subagent_calls:
-        _emit_info(f"Subagent calls detected in session: {subagent_calls}")
+    subagent_stats = progress.get("subagent_statistics")
+    if isinstance(subagent_stats, Mapping):
+        spawned = int(subagent_stats.get("spawned") or 0)
+        active = int(subagent_stats.get("active") or 0)
+        providers = subagent_stats.get("providers")
+        provider_text = ",".join(str(provider) for provider in providers) if isinstance(providers, list) else ""
+    else:
+        spawned = int(progress.get("subagent_spawn_count") or 0)
+        active = int(progress.get("active_subagent_count") or 0)
+        provider_text = str(progress.get("subagent_provider") or "")
+    state_summary = _subagent_state_summary(progress)
+    if spawned or active or state_summary:
+        suffix = f" ({provider_text}; source=session.log)" if provider_text else " (source=session.log)"
+        state_text = f", states: {state_summary}" if state_summary else ""
+        _emit_info(f"Subagents: spawned={spawned}, active={active}{state_text}{suffix}")
+    child_summary = _child_log_activity_summary(progress)
+    if child_summary:
+        _emit_info(f"Child log activity: {child_summary} (heartbeat liveness only)")
     if classification.session_status == "success":
         _emit_info("CHECKPOINT: All workflow steps completed")
 

package/bundled/dev-pipeline/prizmkit_runtime/sessions.py

@@ -402,6 +402,10 @@ def _progress_refresh_key(data: Mapping[str, object]) -> tuple[object, ...]:
         int(data.get("total_tool_calls") or 0),
         int(data.get("active_subagent_count") or 0),
         int(data.get("subagent_spawn_count") or 0),
+        str(data.get("subagent_stats_source") or ""),
+        str(data.get("subagent_provider") or ""),
+        json.dumps(data.get("subagent_states") or [], sort_keys=True, default=str),
+        json.dumps(data.get("subagent_observed_ids") or [], sort_keys=True, default=str),
         str(data.get("child_activity_signature") or ""),
         int(data.get("child_total_bytes") or 0),
         str(data.get("fatal_error_code") or ""),
@@ -549,12 +553,30 @@ def _compact_progress_line(
         f"log: {_format_bytes(log_size)}",
     ]
     child_bytes = int(data.get("child_total_bytes") or 0)
-    subagents = int(data.get("subagent_spawn_count") or 0)
-    if child_bytes or subagents:
-        child = _format_bytes(child_bytes)
-        if subagents:
-            child = f"{child}/{subagents}"
-        parts.append(f"child: {child}")
+    child_files = data.get("child_session_files")
+    child_file_count = len(child_files) if isinstance(child_files, list) else 0
+    spawned = int(data.get("subagent_spawn_count") or 0)
+    active = int(data.get("active_subagent_count") or 0)
+    subagent_states = data.get("subagent_states")
+    if spawned or active or subagent_states:
+        state_bits = []
+        if isinstance(subagent_states, list):
+            for item in subagent_states:
+                if not isinstance(item, Mapping):
+                    continue
+                status = str(item.get("status") or "unknown")
+                count = int(item.get("count") or 0)
+                if count:
+                    state_bits.append(f"{status}={count}")
+        subagent_text = f"spawned={spawned} active={active}"
+        if state_bits:
+            subagent_text = f"{subagent_text} states:{','.join(state_bits)}"
+        parts.append(f"subagents: {subagent_text}")
+    if child_bytes or child_file_count:
+        child_text = _format_bytes(child_bytes)
+        if child_file_count:
+            child_text = f"{child_text}/{child_file_count} files"
+        parts.append(f"child logs: {child_text}")
     phase = _checkpoint_phase_label(checkpoint_path)
     if phase:
         parts.append(f"phase: {phase}")