prizmkit 1.1.118 → 1.1.120

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

@@ -3,14 +3,16 @@
 
 Supports two modes:
 1. **Section assembly** (preferred): Loads modular section files from
-   templates/sections/ and assembles them based on tier, conditions, and
-   feature configuration. Conditional logic is handled in Python code,
+   templates/sections/ and assembles the unified full/tier3-equivalent
+   feature guidance by default. Conditional logic is handled in Python code,
    not regex-based template blocks.
-2. **Legacy template** (fallback): Reads a monolithic bootstrap-tier{1,2,3}.md
-   template and resolves {{PLACEHOLDER}} variables and {{IF_xxx}} blocks.
+2. **Legacy template** (fallback): Reads the monolithic bootstrap-tier3.md
+   template, falling back to bootstrap-prompt.md when tier3 is unavailable,
+   and resolves {{PLACEHOLDER}} variables and {{IF_xxx}} blocks.
 
-The section assembly mode is used when templates/sections/ directory exists.
-Otherwise, falls back to legacy templates for backward compatibility.
+The section assembly mode is used when templates/sections/ directory exists
+and no explicit --template path is supplied. Otherwise, falls back to legacy
+templates for backward compatibility.
 
 Usage:
     python3 generate-bootstrap-prompt.py \
@@ -93,8 +95,9 @@ def parse_args():
         "--template",
         default=None,
         help=(
-            "Custom template path. Defaults to "
-            "{script_dir}/../templates/bootstrap-prompt.md"
+            "Custom template path. Defaults to section-based full feature "
+            "prompt assembly, or {script_dir}/../templates/bootstrap-tier3.md "
+            "when sections are unavailable."
         ),
     )
     parser.add_argument(
@@ -620,18 +623,21 @@ def detect_existing_artifacts(project_root, feature_slug):
 
 
 def determine_pipeline_mode(complexity):
-    """Map estimated_complexity to pipeline mode.
-
-    Returns: 'lite', 'standard', or 'full'
-
-    Tier assignment rationale:
-    - low + medium → lite (single agent): most features don't benefit from
-      the orchestrator→dev→reviewer overhead. A single agent reading
-      .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
-      changes that touch many files and need extra safety checks.
+    """Return the unified feature prompt mode for any complexity.
+
+    ``estimated_complexity`` remains input metadata for planning summaries,
+    dependency ordering, and rendered Session Context, but prompt guidance is
+    intentionally no longer tiered by complexity. Every feature task receives
+    the full/tier3-equivalent guidance by default.
+    """
+    return "full"
+
+
+def determine_legacy_template_mode(complexity):
+    """Map complexity for explicit custom template conditional compatibility.
+
+    This is used only when a caller supplies ``--template`` and omits
+    ``--mode``. The normal feature prompt path never uses this mapping.
     """
     mapping = {
         "low": "lite",
@@ -1214,16 +1220,18 @@ def _tier_header(pipeline_mode):
     """Return the tier-specific header and mission description."""
     headers = {
         "lite": (
-            "# Dev-Pipeline Session Bootstrap — Tier 1 (Single Agent)\n",
-            "**Tier 1 — Single Agent**: You handle everything directly. "
-            "No normal work subagents. No TeamCreate.\n",
+            "# Dev-Pipeline Session Bootstrap — Unified Full Guidance "
+            "(compatibility mode: lite)\n",
+            "**Unified Full Guidance**: Feature prompts use the "
+            "full/tier3-equivalent sections for every estimated complexity. "
+            "The lite label remains metadata only for compatibility.\n",
         ),
         "standard": (
-            "# Dev-Pipeline Session Bootstrap — Tier 2 "
-            "(Orchestrator + Reviewer)\n",
-            "**Tier 2 — Orchestrator + Reviewer**: You handle "
-            "context + planning + implementation directly. Reviewer reviews. "
-            "No Dev subagent — orchestrator implements directly (P0-6).\n",
+            "# Dev-Pipeline Session Bootstrap — Unified Full Guidance "
+            "(compatibility mode: standard)\n",
+            "**Unified Full Guidance**: Feature prompts use the "
+            "full/tier3-equivalent sections for every estimated complexity. "
+            "The standard label remains metadata only for compatibility.\n",
         ),
         "full": (
             "# Dev-Pipeline Session Bootstrap — Tier 3 "
@@ -1256,13 +1264,13 @@ def _tier_reminders(pipeline_mode):
 
     if pipeline_mode == "lite":
         specific = [
-            "- Tier 1: you handle everything directly — no normal work "
-            "subagents needed",
+            "- Tier 1: compatibility label only; feature prompts now render "
+            "the unified full/tier3-equivalent guidance by default",
         ]
     elif pipeline_mode == "standard":
         specific = [
-            "- Tier 2: orchestrator builds context+plan, implements directly "
-            "(no Dev subagent), and Reviewer reviews — see P0-6",
+            "- Tier 2: compatibility label only; feature prompts now render "
+            "the unified full/tier3-equivalent guidance by default",
             "- context-snapshot.md is append-only: orchestrator writes "
             "Sections 1-4 + Implementation Log, Reviewer appends Review Notes",
             "- Gate checks enforce Implementation Log (with Gate Evidence) "
@@ -1283,6 +1291,14 @@ def _tier_reminders(pipeline_mode):
             "written before proceeding",
             "- Do NOT use `run_in_background=true` when spawning normal work "
             "agents",
+            "- If an Agent tool call fails with team/config/lock errors, retry "
+            "at most once; after a second failure, use the documented "
+            "inline/recovery fallback or write `failure-log.md` rather than "
+            "spawning variants or polling indefinitely",
+            "- NEVER delete, modify, or touch any file under `.prizmkit/state/` "
+            "— those are pipeline runtime files managed by the runner",
+            "- NEVER run `rm -rf`, `git clean`, or destructive filesystem "
+            "cleanup during the feature session",
             "- On timeout: check snapshot → model:lite → remaining steps "
             "only → max 2 retries → orchestrator fallback",
         ]
@@ -1575,56 +1591,8 @@ def build_replacements(args, feature, features, global_context, script_dir):
     """Build the full dict of placeholder -> replacement value."""
     project_root = _args_project_root(args, script_dir)
 
-    # Resolve paths - platform-aware agent/team resolution.
-    # Mixed `--platform all` installs must render commands for the actual AI
-    # environment, not whichever platform directory happens to be checked first.
-    platform = resolve_prompt_platform(project_root)
-    home_dir = os.path.expanduser("~")
-
-    if platform == "claude":
-        # Claude Code: agents in .claude/agents/, no native team config
-        agents_dir = os.path.join(project_root, ".claude", "agents")
-        team_config_path = os.path.join(
-            project_root, ".claude", "team-info.json",
-        )
-    elif platform == "codex":
-        # Codex: agents and team metadata are project-local references.
-        agents_dir = os.path.join(project_root, ".codex", "agents")
-        team_config_path = os.path.join(
-            project_root, ".codex", "team-info.json",
-        )
-    else:
-        # CodeBuddy: agents in .codebuddy/agents/, team in ~/.codebuddy/teams/
-        agents_dir = os.path.join(project_root, ".codebuddy", "agents")
-        team_config_path = os.path.join(
-            home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json",
-        )
-
-    # Agent definitions are native .toml for Codex and .md for Claude/CodeBuddy.
-    agent_ext = ".toml" if platform == "codex" else ".md"
-    dev_subagent = os.path.join(
-        agents_dir, f"prizm-dev-team-dev{agent_ext}",
-    )
-    reviewer_subagent = os.path.join(
-        agents_dir, f"prizm-dev-team-reviewer{agent_ext}",
-    )
-
-    # Verify agent files actually exist — missing files cause confusing
-    # errors when the AI session tries to read them later.
-    for agent_path, agent_name in [
-        (dev_subagent, "dev agent"),
-        (reviewer_subagent, "reviewer agent"),
-    ]:
-        if not os.path.isfile(agent_path):
-            LOGGER.warning(
-                "Agent file not found: %s (%s). "
-                "Subagent spawning may fail. "
-                "Run `npx prizmkit install` to reinstall agent definitions.",
-                agent_path, agent_name,
-            )
-    # 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")
+    # Resolve platform for platform-specific project convention references only.
+    resolve_prompt_platform(project_root)
 
     # Session status is controlled by the main runner state dir, even when
     # rendered project paths are AI-visible worktree paths.
@@ -1650,10 +1618,15 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "estimated_complexity",
         feature.get("complexity", "medium"),
     )
-    if args.mode:
-        pipeline_mode = args.mode
+    if args.template:
+        pipeline_mode = args.mode or determine_legacy_template_mode(complexity)
     else:
         pipeline_mode = determine_pipeline_mode(complexity)
+    if args.mode and args.mode != pipeline_mode and not args.template:
+        LOGGER.info(
+            "Ignoring feature prompt --mode=%s; unified full guidance is used",
+            args.mode,
+        )
 
     # Auto-detect resume: if all planning artifacts exist and resume_phase
     # is "null" (fresh start), skip to Phase 6
@@ -1710,10 +1683,6 @@ def build_replacements(args, feature, features, global_context, script_dir):
         ),
         "{{GLOBAL_CONTEXT}}": format_global_context(global_context, project_root),
         "{{PROJECT_BRIEF}}": _read_project_brief(project_root),
-        "{{TEAM_CONFIG_PATH}}": team_config_path,
-        "{{DEV_SUBAGENT_PATH}}": dev_subagent,
-        "{{REVIEWER_SUBAGENT_PATH}}": reviewer_subagent,
-        "{{INIT_SCRIPT_PATH}}": init_script_path,
         "{{SESSION_STATUS_PATH}}": session_status_abs,
         "{{PROJECT_ROOT}}": project_root,
         "{{FEATURE_SLUG}}": feature_slug,
@@ -1859,20 +1828,9 @@ def main():
         if args.template:
             template_path = args.template
         else:
-            complexity = feature.get(
-                "estimated_complexity",
-                feature.get("complexity", "medium"),
-            )
-            _mode = args.mode or determine_pipeline_mode(complexity)
-            _tier_file_map = {
-                "lite": "bootstrap-tier1.md",
-                "standard": "bootstrap-tier2.md",
-                "full": "bootstrap-tier3.md",
-            }
-            _tier_file = _tier_file_map.get(_mode, "bootstrap-tier2.md")
-            _tier_path = os.path.join(templates_dir, _tier_file)
-            if os.path.isfile(_tier_path):
-                template_path = _tier_path
+            tier3_path = os.path.join(templates_dir, "bootstrap-tier3.md")
+            if os.path.isfile(tier3_path):
+                template_path = tier3_path
             else:
                 template_path = os.path.join(
                     templates_dir, "bootstrap-prompt.md"

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

@@ -246,22 +246,7 @@ def is_recovery_like(args):
 def build_replacements(args, bug, global_context, script_dir):
     """Build the full dict of placeholder -> replacement value."""
     project_root = _args_project_root(args, script_dir)
-    platform = resolve_prompt_platform(project_root)
-    home_dir = os.path.expanduser("~")
-
-    if platform == "claude":
-        agents_dir = os.path.join(project_root, ".claude", "agents")
-        team_config_path = os.path.join(project_root, ".claude", "team-info.json")
-    elif platform == "codex":
-        agents_dir = os.path.join(project_root, ".codex", "agents")
-        team_config_path = os.path.join(project_root, ".codex", "team-info.json")
-    else:
-        agents_dir = os.path.join(project_root, ".codebuddy", "agents")
-        team_config_path = os.path.join(home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json")
-
-    agent_ext = ".toml" if platform == "codex" else ".md"
-    dev_subagent = os.path.join(agents_dir, "prizm-dev-team-dev{}".format(agent_ext))
-    reviewer_subagent = os.path.join(agents_dir, "prizm-dev-team-reviewer{}".format(agent_ext))
+    resolve_prompt_platform(project_root)
 
     state_dir = (
         os.path.abspath(args.state_dir)
@@ -311,9 +296,6 @@ def build_replacements(args, bug, global_context, script_dir):
         "{{AC_CHECKLIST}}": format_ac_checklist(bug.get("acceptance_criteria", [])),
         "{{ENVIRONMENT}}": format_environment(bug.get("environment")),
         "{{GLOBAL_CONTEXT}}": format_global_context(global_context, project_root),
-        "{{TEAM_CONFIG_PATH}}": team_config_path,
-        "{{DEV_SUBAGENT_PATH}}": dev_subagent,
-        "{{REVIEWER_SUBAGENT_PATH}}": reviewer_subagent,
         "{{SESSION_STATUS_PATH}}": session_status_path,
         "{{PROJECT_ROOT}}": project_root,
         "{{ARTIFACT_DIR}}": ".prizmkit/bugfix/{}".format(args.bug_id),

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

@@ -272,22 +272,7 @@ def determine_refactor_mode(args, refactor):
 
 def build_replacements(args, refactor, refactors, global_context, script_dir):
     project_root = _args_project_root(args, script_dir)
-    platform = resolve_prompt_platform(project_root)
-    home_dir = os.path.expanduser("~")
-
-    if platform == "claude":
-        agents_dir = os.path.join(project_root, ".claude", "agents")
-        team_config_path = os.path.join(project_root, ".claude", "team-info.json")
-    elif platform == "codex":
-        agents_dir = os.path.join(project_root, ".codex", "agents")
-        team_config_path = os.path.join(project_root, ".codex", "team-info.json")
-    else:
-        agents_dir = os.path.join(project_root, ".codebuddy", "agents")
-        team_config_path = os.path.join(home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json")
-
-    agent_ext = ".toml" if platform == "codex" else ".md"
-    dev_subagent = os.path.join(agents_dir, "prizm-dev-team-dev{}".format(agent_ext))
-    reviewer_subagent = os.path.join(agents_dir, "prizm-dev-team-reviewer{}".format(agent_ext))
+    resolve_prompt_platform(project_root)
 
     state_dir = (
         os.path.abspath(args.state_dir)
@@ -337,9 +322,6 @@ def build_replacements(args, refactor, refactors, global_context, script_dir):
         "{{AC_CHECKLIST}}": format_ac_checklist(refactor.get("acceptance_criteria", [])),
         "{{DEPENDENCIES}}": format_dependencies(refactor.get("dependencies", []), refactors),
         "{{GLOBAL_CONTEXT}}": format_global_context(global_context, project_root),
-        "{{TEAM_CONFIG_PATH}}": team_config_path,
-        "{{DEV_SUBAGENT_PATH}}": dev_subagent,
-        "{{REVIEWER_SUBAGENT_PATH}}": reviewer_subagent,
         "{{SESSION_STATUS_PATH}}": session_status_path,
         "{{PROJECT_ROOT}}": project_root,
         "{{ARTIFACT_DIR}}": ".prizmkit/refactor/{}".format(args.refactor_id),

package/bundled/dev-pipeline/scripts/{init-dev-team.py → init-change-artifact.py}

@@ -1,11 +1,11 @@
 #!/usr/bin/env python3
-"""Initialize prizmkit directory structures for a feature.
+"""Initialize PrizmKit change-artifact directories for a feature.
 
-Creates the standard directory layout expected by prizm-dev-team agents:
+Creates the standard directory layout expected by generated pipeline prompts:
 - .prizmkit/specs/<feature-slug>/    ← per-feature subdirectory
 
 Usage:
-    python3 init-dev-team.py --project-root <path> --feature-slug <slug>
+    python3 init-change-artifact.py --project-root <path> --feature-slug <slug>
 """
 
 import argparse
@@ -17,7 +17,7 @@ from datetime import datetime, timezone
 
 def parse_args():
     parser = argparse.ArgumentParser(
-        description="Initialize dev-team and prizmkit directories"
+        description="Initialize PrizmKit change-artifact directories"
     )
     parser.add_argument(
         "--project-root",
@@ -38,16 +38,14 @@ def parse_args():
 
 
 def create_directories(project_root, feature_slug=None):
-    """Create the prizmkit directory structures."""
+    """Create the PrizmKit change-artifact directory structures."""
     dirs_to_create = []
 
-    # PrizmKit per-feature directories
     if feature_slug:
         dirs_to_create.extend([
             ".prizmkit/specs/{}".format(feature_slug),
         ])
     else:
-        # Fallback: create flat directories (not recommended)
         dirs_to_create.extend([
             ".prizmkit/specs",
         ])
@@ -67,14 +65,11 @@ def init_prizmkit_config(project_root, feature_id):
     config_path = os.path.join(project_root, ".prizmkit", "config.json")
 
     if os.path.exists(config_path):
-        # Update existing config
         with open(config_path, "r", encoding="utf-8") as f:
             config = json.load(f)
         config["current_feature"] = feature_id
         config["updated_at"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
     else:
-        # Create new config
-        # Try to get project name from package.json or directory name
         project_name = os.path.basename(project_root)
         pkg_json_path = os.path.join(project_root, "package.json")
         if os.path.exists(pkg_json_path):
@@ -112,22 +107,17 @@ def main():
         print(json.dumps(result, indent=2))
         sys.exit(1)
 
-    # Create directories
     created_dirs = create_directories(project_root, args.feature_slug)
-
-    # Initialize config
     config_path = init_prizmkit_config(project_root, args.feature_id)
 
     result = {
         "success": True,
         "project_root": project_root,
         "feature_slug": args.feature_slug,
-        "directories_created": created_dirs,
+        "created_dirs": created_dirs,
         "config_path": config_path,
     }
-
     print(json.dumps(result, indent=2))
-    sys.exit(0)
 
 
 if __name__ == "__main__":