prizmkit 1.1.93 → 1.1.95

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

@@ -11,12 +11,16 @@ Commands:
   grade       Generate grading results from eval runs (for npm run skill:review)
 
 Usage:
-  python3 validate-and-generate.py validate --input .prizmkit/plans/feature-list.json [--output validated.json] [--mode new|incremental]
+  python3 validate-and-generate.py validate --input .prizmkit/plans/feature-list.json [--output validated.json]
   python3 validate-and-generate.py template --output .prizmkit/plans/feature-list.json
-  python3 validate-and-generate.py generate --input draft.json --output .prizmkit/plans/feature-list.json [--mode new|incremental]
+  python3 validate-and-generate.py generate --input draft.json --output .prizmkit/plans/feature-list.json
   python3 validate-and-generate.py summary --input .prizmkit/plans/feature-list.json [--format markdown|json]
   python3 validate-and-generate.py grade --workspace /.codebuddy/skill-evals/feature-planner-workspace --iteration iteration-1
 
+Mode is determined automatically by --output path:
+  - Output file does NOT exist -> new plan (all features must be "pending")
+  - Output file already exists -> incremental append (existing features keep their status)
+
 Python 3.6+ required. No external dependencies.
 """
 
@@ -38,8 +42,6 @@ VALID_STATUSES = {"pending", "in_progress", "completed", "failed", "skipped", "s
 VALID_COMPLEXITIES = {"low", "medium", "high", "critical"}
 VALID_PRIORITIES = {"critical", "high", "medium", "low"}
 VALID_GRANULARITIES = {"feature", "sub_feature", "auto"}
-VALID_PLANNING_MODES = {"new", "incremental"}
-
 FEATURE_ID_RE = re.compile(r"^F-\d{3}(-[A-Z])?$")
 SUB_FEATURE_ID_RE = re.compile(r"^F-\d{3}-[A-Z]$")
 
@@ -156,13 +158,11 @@ def _detect_cycles(features):
 # ---------------------------------------------------------------------------
 
 
-def validate_feature_list(data, planning_mode="new"):
+def validate_feature_list(data, is_new_plan=True):
     """Validate a parsed feature-list data structure.
 
     Returns a dict with keys ``valid``, ``errors``, ``warnings``, ``stats``.
     """
-    if planning_mode not in VALID_PLANNING_MODES:
-        planning_mode = "new"
 
     errors = []
     warnings = []
@@ -299,7 +299,7 @@ def validate_feature_list(data, planning_mode="new"):
                     label, status, ", ".join(sorted(VALID_STATUSES))
                 )
             )
-        if planning_mode == "new" and status and status != "pending":
+        if is_new_plan and status and status != "pending":
             warnings.append(
                 "{}: status is '{}' (expected 'pending' for new plans)".format(label, status)
             )
@@ -680,7 +680,9 @@ def cmd_validate(args):
         print(json.dumps(result, indent=2, ensure_ascii=False))
         return 2
 
-    result = validate_feature_list(data, planning_mode=args.mode)
+    # Validate input file exists -> incremental mode (existing features keep their status)
+    is_new_plan = False
+    result = validate_feature_list(data, is_new_plan=is_new_plan)
 
     # Print results to stdout
     print(json.dumps(result, indent=2, ensure_ascii=False))
@@ -758,9 +760,11 @@ def cmd_generate(args):
     for feature in data.get("features", []):
         feature.setdefault("status", "pending")
 
-    # Validate
-    mode = getattr(args, "mode", "new") or "new"
-    result = validate_feature_list(data, planning_mode=mode)
+    # Validate. Mode is determined by whether --output file already exists:
+    #   - does NOT exist -> new plan (all features must be "pending")
+    #   - already exists -> incremental append (existing features keep their status)
+    is_new_plan = not os.path.exists(args.output)
+    result = validate_feature_list(data, is_new_plan=is_new_plan)
 
     # Output validation result
     print(json.dumps(result, indent=2, ensure_ascii=False))
@@ -856,7 +860,7 @@ def cmd_grade(args):
             continue
         
         # Run validation
-        result = validate_feature_list(data, planning_mode="new")
+        result = validate_feature_list(data, is_new_plan=True)
         
         # Create grading entry
         grade_entry = {
@@ -916,7 +920,6 @@ def main():
         epilog=(
             "Examples:\n"
             "  %(prog)s validate --input .prizmkit/plans/feature-list.json\n"
-            "  %(prog)s validate --input .prizmkit/plans/feature-list.json --mode incremental\n"
             "  %(prog)s validate --input .prizmkit/plans/feature-list.json --output validated.json\n"
             "  %(prog)s template --output .prizmkit/plans/feature-list.json\n"
             "  %(prog)s generate --input draft.json --output .prizmkit/plans/feature-list.json\n"
@@ -938,12 +941,6 @@ def main():
     p_validate.add_argument(
         "--output", help="Path to write validated output (optional)"
     )
-    p_validate.add_argument(
-        "--mode",
-        choices=["new", "incremental"],
-        default="new",
-        help="Validation mode (default: new)",
-    )
 
     # -- template --
     p_template = subparsers.add_parser(
@@ -965,12 +962,6 @@ def main():
     p_generate.add_argument(
         "--output", required=True, help="Path to write final feature-list.json"
     )
-    p_generate.add_argument(
-        "--mode",
-        choices=["new", "incremental"],
-        default="new",
-        help="Validation mode (default: new)",
-    )
 
     # -- summary --
     p_summary = subparsers.add_parser(

package/bundled/skills-windows/feature-planner/SKILL.md

@@ -285,7 +285,7 @@ For simple incremental planning, skip detailed Phase 2-3 analysis:
 4. Draft features (title + description + acceptance_criteria + dependencies)
 5. Write draft to `.prizmkit/plans/feature-list.draft.json`, then call the generate script:
    ```powershell
-   Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py generate --input .prizmkit/plans/feature-list.draft.json --output .prizmkit/plans/feature-list.json --mode incremental
+   Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py generate --input .prizmkit/plans/feature-list.draft.json --output .prizmkit/plans/feature-list.json
    ```
 6. If valid → summarize and recommend next step
 7. If invalid → apply fixes to the draft, re-run generate (max 2 attempts, then escalate to full workflow)
@@ -336,7 +336,7 @@ Key requirements:
 1. Write a draft JSON to a temporary path (e.g., `.prizmkit/plans/feature-list.draft.json`)
 2. Call the generate script to validate and produce the final file:
 ```powershell
-Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py generate --input .prizmkit/plans/feature-list.draft.json --output .prizmkit/plans/feature-list.json --mode <new|incremental>
+Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py generate --input .prizmkit/plans/feature-list.draft.json --output .prizmkit/plans/feature-list.json
 ```
 The script fills in defaults (`$schema`, `created_at`, `created_by`), validates all fields, and writes the final file only if validation passes. If validation fails, fix the draft and retry.
 

package/bundled/skills-windows/feature-planner/references/error-recovery.md

@@ -4,7 +4,7 @@ Structured error handling for validation failures, interrupted sessions, and che
 
 ## Validation Failures
 
-When `Invoke-PrizmPython scripts/validate-and-generate.py validate --input <file> --mode <mode>` returns errors:
+When `Invoke-PrizmPython scripts/validate-and-generate.py validate --input <file>` returns errors:
 
 ### Parse validation output
 Script returns JSON with `"valid": false`, `"errors": [...]`, `"warnings": [...]`

package/bundled/skills-windows/feature-planner/references/incremental-feature-planning.md

@@ -83,7 +83,7 @@ Keep dependency correctness as first constraint.
 ### Step 5: Validate
 Run after defining `Invoke-PrizmPython` from the main `SKILL.md`:
 ```powershell
-Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py validate --input feature-list.json --mode incremental
+Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py validate --input feature-list.json
 ```
 
 Fix and re-run until pass.

package/bundled/skills-windows/feature-planner/references/new-project-planning.md

@@ -55,7 +55,7 @@ Split into `sub_features` when:
 1. Write `feature-list.json`.
 2. Run the command below after defining `Invoke-PrizmPython` from the main `SKILL.md`:
    ```powershell
-   Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py validate --input feature-list.json --mode new
+   Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-and-generate.py validate --input feature-list.json
    ```
 3. Fix all errors, then re-run.
 

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

@@ -11,12 +11,16 @@ Commands:
   grade       Generate grading results from eval runs (for npm run skill:review)
 
 Usage:
-  python3 validate-and-generate.py validate --input .prizmkit/plans/feature-list.json [--output validated.json] [--mode new|incremental]
+  python3 validate-and-generate.py validate --input .prizmkit/plans/feature-list.json [--output validated.json]
   python3 validate-and-generate.py template --output .prizmkit/plans/feature-list.json
-  python3 validate-and-generate.py generate --input draft.json --output .prizmkit/plans/feature-list.json [--mode new|incremental]
+  python3 validate-and-generate.py generate --input draft.json --output .prizmkit/plans/feature-list.json
   python3 validate-and-generate.py summary --input .prizmkit/plans/feature-list.json [--format markdown|json]
   python3 validate-and-generate.py grade --workspace /.codebuddy/skill-evals/feature-planner-workspace --iteration iteration-1
 
+Mode is determined automatically by --output path:
+  - Output file does NOT exist -> new plan (all features must be "pending")
+  - Output file already exists -> incremental append (existing features keep their status)
+
 Python 3.6+ required. No external dependencies.
 """
 
@@ -38,8 +42,6 @@ VALID_STATUSES = {"pending", "in_progress", "completed", "failed", "skipped", "s
 VALID_COMPLEXITIES = {"low", "medium", "high", "critical"}
 VALID_PRIORITIES = {"critical", "high", "medium", "low"}
 VALID_GRANULARITIES = {"feature", "sub_feature", "auto"}
-VALID_PLANNING_MODES = {"new", "incremental"}
-
 FEATURE_ID_RE = re.compile(r"^F-\d{3}(-[A-Z])?$")
 SUB_FEATURE_ID_RE = re.compile(r"^F-\d{3}-[A-Z]$")
 
@@ -156,13 +158,11 @@ def _detect_cycles(features):
 # ---------------------------------------------------------------------------
 
 
-def validate_feature_list(data, planning_mode="new"):
+def validate_feature_list(data, is_new_plan=True):
     """Validate a parsed feature-list data structure.
 
     Returns a dict with keys ``valid``, ``errors``, ``warnings``, ``stats``.
     """
-    if planning_mode not in VALID_PLANNING_MODES:
-        planning_mode = "new"
 
     errors = []
     warnings = []
@@ -299,7 +299,7 @@ def validate_feature_list(data, planning_mode="new"):
                     label, status, ", ".join(sorted(VALID_STATUSES))
                 )
             )
-        if planning_mode == "new" and status and status != "pending":
+        if is_new_plan and status and status != "pending":
             warnings.append(
                 "{}: status is '{}' (expected 'pending' for new plans)".format(label, status)
             )
@@ -680,7 +680,9 @@ def cmd_validate(args):
         print(json.dumps(result, indent=2, ensure_ascii=False))
         return 2
 
-    result = validate_feature_list(data, planning_mode=args.mode)
+    # Validate input file exists -> incremental mode (existing features keep their status)
+    is_new_plan = False
+    result = validate_feature_list(data, is_new_plan=is_new_plan)
 
     # Print results to stdout
     print(json.dumps(result, indent=2, ensure_ascii=False))
@@ -758,9 +760,11 @@ def cmd_generate(args):
     for feature in data.get("features", []):
         feature.setdefault("status", "pending")
 
-    # Validate
-    mode = getattr(args, "mode", "new") or "new"
-    result = validate_feature_list(data, planning_mode=mode)
+    # Validate. Mode is determined by whether --output file already exists:
+    #   - does NOT exist -> new plan (all features must be "pending")
+    #   - already exists -> incremental append (existing features keep their status)
+    is_new_plan = not os.path.exists(args.output)
+    result = validate_feature_list(data, is_new_plan=is_new_plan)
 
     # Output validation result
     print(json.dumps(result, indent=2, ensure_ascii=False))
@@ -856,7 +860,7 @@ def cmd_grade(args):
             continue
         
         # Run validation
-        result = validate_feature_list(data, planning_mode="new")
+        result = validate_feature_list(data, is_new_plan=True)
         
         # Create grading entry
         grade_entry = {
@@ -916,7 +920,6 @@ def main():
         epilog=(
             "Examples:\n"
             "  %(prog)s validate --input .prizmkit/plans/feature-list.json\n"
-            "  %(prog)s validate --input .prizmkit/plans/feature-list.json --mode incremental\n"
             "  %(prog)s validate --input .prizmkit/plans/feature-list.json --output validated.json\n"
             "  %(prog)s template --output .prizmkit/plans/feature-list.json\n"
             "  %(prog)s generate --input draft.json --output .prizmkit/plans/feature-list.json\n"
@@ -938,12 +941,6 @@ def main():
     p_validate.add_argument(
         "--output", help="Path to write validated output (optional)"
     )
-    p_validate.add_argument(
-        "--mode",
-        choices=["new", "incremental"],
-        default="new",
-        help="Validation mode (default: new)",
-    )
 
     # -- template --
     p_template = subparsers.add_parser(
@@ -965,12 +962,6 @@ def main():
     p_generate.add_argument(
         "--output", required=True, help="Path to write final feature-list.json"
     )
-    p_generate.add_argument(
-        "--mode",
-        choices=["new", "incremental"],
-        default="new",
-        help="Validation mode (default: new)",
-    )
 
     # -- summary --
     p_summary = subparsers.add_parser(

package/bundled/team/prizm-dev-team.json

@@ -1,33 +1,33 @@
 {
   "name": "prizm-dev-team",
   "team_name": "prizm-dev-team",
-  "description": "PrizmKit-integrated Multi-Agent software development team. 3 specialized agents (Dev, Reviewer, Critic) following PrizmKit spec-driven workflow with pipeline and checkpoints.",
+  "description": "PrizmKit-integrated Multi-Agent software development team. 3 specialized agents (Dev, Reviewer, Critic) following PrizmKit spec-driven workflow. Critic supports parallel 3-critic voting with distinct focus lenses.",
   "lead": "orchestrator",
   "communication": {
     "protocol": "SendMessage",
     "routing": "mesh",
-    "note": "Teammates communicate directly via SendMessage; key messages must also be sent to Orchestrator (the main agent session)"
+    "note": "Teammates communicate directly via SendMessage; key messages must also be sent to Orchestrator (the main AI session). Critic agents operate independently in parallel — they do NOT read each other's reports."
   },
   "members": [
     {
       "name": "dev",
-      "role": "developer", 
+      "role": "developer",
       "agentDefinition": "prizm-dev-team-dev",
-      "prompt": "You are a Dev Agent of the prizm-dev-team. Follow /prizmkit-implement workflow with TDD. Read plan.md/spec.md, implement task-by-task, mark completed tasks [x]. Check .prizmkit/prizm-docs/ TRAPS before implementing.",
+      "prompt": "You are a Dev Agent of the prizm-dev-team. Your complete behavior rules are in your agent definition. Follow /prizmkit-implement workflow with TDD. Read plan.md/spec.md, implement task-by-task, mark completed tasks [x].",
       "subscriptions": ["*"]
     },
     {
       "name": "reviewer",
       "role": "reviewer",
       "agentDefinition": "prizm-dev-team-reviewer",
-      "prompt": "You are the Reviewer Agent of the prizm-dev-team. Run /prizmkit-code-review for diagnosis + fix strategy formulation, write and execute integration tests. Produce structured Fix Instructions (Root Cause, Impact, Fix Strategy, Code Guidance, Verification) so Dev can follow them precisely. review-report.md is written to the artifact directory by /prizmkit-code-review.",
+      "prompt": "You are the Reviewer Agent of the prizm-dev-team. Your complete behavior rules are in your agent definition. Run /prizmkit-code-review for diagnosis + fix strategy formulation. You do NOT run tests — the Orchestrator handles testing.",
       "subscriptions": ["*"]
     },
     {
       "name": "critic",
       "role": "critic",
       "agentDefinition": "prizm-dev-team-critic",
-      "prompt": "You are the Critic Agent of the prizm-dev-team. Challenge plans and implementations for project fitness, style consistency, robustness, and integration quality. Do NOT verify correctness — that is the Reviewer's job. Write challenge-report.md with adversarial findings.",
+      "prompt": "You are the Critic Agent of the prizm-dev-team. Your complete behavior rules are in your agent definition. Challenge plans and implementations for project fitness, style consistency, robustness, and integration quality. Supports parallel 3-critic voting mode. Do NOT verify correctness — that is the Reviewer's job.",
       "subscriptions": ["*"]
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.93",
+  "version": "1.1.95",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {