prizmkit 1.1.35 → 1.1.37

package/bin/create-prizmkit.js

@@ -37,6 +37,10 @@ program
   .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)')
+  .option('--no-playwright-cli', 'Disable playwright-cli installation')
+  .option('--open-cli', 'Install opencli browser tool (default: true)')
+  .option('--no-open-cli', 'Disable opencli installation')
   .option('--rules <preset>', 'Rules preset: recommended, minimal, or none', 'recommended')
   .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, claude-internal)')
   .option('--external-skills <names>', 'Comma-separated external skill names to install (e.g. find-skills,impeccable)')

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.35",
-  "bundledAt": "2026-04-16T01:23:04.438Z",
-  "bundledFrom": "253edf2"
+  "frameworkVersion": "1.1.37",
+  "bundledAt": "2026-04-19T13:06:01.957Z",
+  "bundledFrom": "b5a91ed"
 }

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

@@ -460,12 +460,14 @@ def process_conditional_blocks(content, resume_phase):
 
 
 def process_mode_blocks(content, pipeline_mode, init_done, critic_enabled=False,
-                        browser_interaction=False):
+                        browser_interaction=False, browser_tool="auto"):
     """Process pipeline mode, init, critic, and browser conditional blocks.
 
     Keeps the block matching the current mode, removes the others.
     Handles {{IF_CRITIC_ENABLED}} / {{END_IF_CRITIC_ENABLED}} blocks.
     Handles {{IF_BROWSER_INTERACTION}} / {{END_IF_BROWSER_INTERACTION}} blocks.
+    Handles {{IF_BROWSER_TOOL_PLAYWRIGHT}} / {{IF_BROWSER_TOOL_OPENCLI}} /
+    {{IF_BROWSER_TOOL_AUTO}} blocks (nested inside browser interaction block).
     """
     # Handle lite/standard/full blocks
     modes = ["lite", "standard", "full"]
@@ -527,6 +529,29 @@ def process_mode_blocks(content, pipeline_mode, init_done, critic_enabled=False,
         pattern = re.escape(browser_open) + r".*?" + re.escape(browser_close) + r"\n?"
         content = re.sub(pattern, "", content, flags=re.DOTALL)
 
+    # Browser tool selection blocks (nested inside browser interaction)
+    tool_variants = ["PLAYWRIGHT", "OPENCLI", "AUTO"]
+    # Map browser_tool value to the variant tag name
+    active_variant = {
+        "playwright-cli": "PLAYWRIGHT",
+        "opencli": "OPENCLI",
+        "auto": "AUTO",
+    }.get(browser_tool, "AUTO")
+
+    for variant in tool_variants:
+        tool_open = "{{{{IF_BROWSER_TOOL_{}}}}}".format(variant)
+        tool_close = "{{{{END_IF_BROWSER_TOOL_{}}}}}".format(variant)
+        if variant == active_variant and browser_interaction:
+            # Keep content, remove tags
+            content = content.replace(tool_open + "\n", "")
+            content = content.replace(tool_open, "")
+            content = content.replace(tool_close + "\n", "")
+            content = content.replace(tool_close, "")
+        else:
+            # Remove entire block
+            pat = re.escape(tool_open) + r".*?" + re.escape(tool_close) + r"\n?"
+            content = re.sub(pat, "", content, flags=re.DOTALL)
+
     return content
 
 
@@ -869,7 +894,8 @@ def _tier_reminders(pipeline_mode, critic_enabled=False):
 
 
 def assemble_sections(pipeline_mode, sections_dir, init_done, is_resume,
-                      critic_enabled, browser_enabled, retry_count=0):
+                      critic_enabled, browser_enabled, retry_count=0,
+                      browser_tool="auto"):
     """Assemble prompt sections based on tier and conditions.
 
     Uses Python code for conditional logic instead of regex-based
@@ -1040,11 +1066,18 @@ def assemble_sections(pipeline_mode, sections_dir, init_done, is_resume,
                           load_section(sections_dir,
                                        "phase-review-agent.md")))
 
-    # --- Browser Verification (conditional) ---
+    # --- Browser Verification (conditional, tool-aware) ---
     if browser_enabled:
+        if browser_tool == "opencli":
+            browser_section_file = "phase-browser-verification-opencli.md"
+        elif browser_tool == "playwright-cli":
+            browser_section_file = "phase-browser-verification.md"
+        else:
+            # "auto" or unknown → let AI choose at runtime
+            browser_section_file = "phase-browser-verification-auto.md"
         sections.append(("phase-browser",
                           load_section(sections_dir,
-                                       "phase-browser-verification.md")))
+                                       browser_section_file)))
 
     # --- Deploy Verification ---
     sections.append(("phase-deploy",
@@ -1289,26 +1322,37 @@ def build_replacements(args, feature, features, global_context, script_dir):
         )
         critic_enabled = False
 
-    # Browser interaction - extract from feature if present and playwright-cli available
+    # Browser interaction - extract from feature if present
     browser_interaction = feature.get("browser_interaction")
     browser_enabled = False
     browser_verify_steps = ""
+    browser_tool = "auto"  # default: AI chooses at runtime
 
     browser_verify_env = os.environ.get("BROWSER_VERIFY", "").lower()
     if browser_verify_env == "false":
         browser_interaction = None
 
-    if browser_interaction and isinstance(browser_interaction, dict):
+    if browser_interaction and isinstance(browser_interaction, bool):
+        # Simple boolean: browser verification enabled, no specific goals
+        browser_enabled = True
+        browser_tool = "auto"
+        browser_verify_steps = (
+            "   # (no specific verify goals — explore the app and "
+            "verify the feature works as expected)")
+    elif browser_interaction and isinstance(browser_interaction, dict):
+        # Extract tool preference (playwright-cli / opencli / auto)
+        browser_tool = browser_interaction.get("tool", "auto")
+        if browser_tool not in ("playwright-cli", "opencli", "auto"):
+            LOGGER.warning(
+                "Unknown browser_interaction.tool '%s', defaulting to 'auto'",
+                browser_tool,
+            )
+            browser_tool = "auto"
+
         # browser_interaction only needs verify_steps — AI auto-detects
         # dev server command, URL, and port from project config
         steps = browser_interaction.get("verify_steps", [])
-        if isinstance(browser_interaction, bool) and browser_interaction:
-            # Simple boolean: browser verification enabled, no specific goals
-            browser_enabled = True
-            browser_verify_steps = (
-                "   # (no specific verify goals — explore the app and "
-                "verify the feature works as expected)")
-        elif steps:
+        if steps:
             browser_enabled = True
             browser_verify_steps = "\n".join(
                 "   # Goal {}: {}".format(i + 1, step)
@@ -1404,6 +1448,7 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "{{HAS_SPEC}}": "true" if artifacts["has_spec"] else "false",
         "{{HAS_PLAN}}": "true" if artifacts["has_plan"] else "false",
         "{{BROWSER_VERIFY_STEPS}}": browser_verify_steps,
+        "{{BROWSER_TOOL}}": browser_tool,
         "{{AC_CHECKLIST}}": format_ac_checklist(
             feature.get("acceptance_criteria", [])
         ),
@@ -1414,10 +1459,11 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "{{DEV_URL}}": dev_url,
     }
 
-    return replacements, effective_resume, browser_enabled
+    return replacements, effective_resume, browser_enabled, browser_tool
 
 
-def render_template(template_content, replacements, resume_phase, browser_enabled=False):
+def render_template(template_content, replacements, resume_phase,
+                    browser_enabled=False, browser_tool="auto"):
     """Render the template by processing conditionals and replacing placeholders."""
     # Step 1: Process fresh_start/resume conditional blocks
     content = process_conditional_blocks(template_content, resume_phase)
@@ -1427,7 +1473,7 @@ def render_template(template_content, replacements, resume_phase, browser_enable
     init_done = replacements.get("{{INIT_DONE}}", "false") == "true"
     critic_enabled = replacements.get("{{CRITIC_ENABLED}}", "false") == "true"
     content = process_mode_blocks(content, pipeline_mode, init_done, critic_enabled,
-                                  browser_enabled)
+                                  browser_enabled, browser_tool)
 
     # Step 3: Replace all {{PLACEHOLDER}} variables (two passes for nested
     # agent prompt templates that may contain their own placeholders)
@@ -1489,7 +1535,7 @@ def main():
         global_context = {}
 
     # Build replacements (shared by both code paths)
-    replacements, effective_resume, browser_enabled = build_replacements(
+    replacements, effective_resume, browser_enabled, browser_tool = build_replacements(
         args, feature, features, global_context, script_dir
     )
 
@@ -1514,6 +1560,7 @@ def main():
                 pipeline_mode, sections_dir, init_done, is_resume,
                 critic_enabled, browser_enabled,
                 retry_count=int(args.retry_count),
+                browser_tool=browser_tool,
             )
             rendered = render_from_sections(sections, replacements)
         except FileNotFoundError as exc:
@@ -1552,7 +1599,8 @@ def main():
             emit_failure("Template error: {}".format(err))
 
         rendered = render_template(
-            template_content, replacements, effective_resume, browser_enabled
+            template_content, replacements, effective_resume, browser_enabled,
+            browser_tool
         )
 
     # ── Validate rendered output ───────────────────────────────────────

package/bundled/dev-pipeline/templates/agent-prompts/reviewer-review.md

@@ -1,8 +1,7 @@
 "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/spec.md` (if it exists) for goals and acceptance criteria; if spec.md does not exist, read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` Section 1 instead
 2. Read `.prizmkit/specs/{{FEATURE_SLUG}}/plan.md` for architecture decisions and completed tasks
-3. Read `.prizm-docs/root.prizm` and relevant L1/L2 docs for RULES, PATTERNS, TRAPS
-4. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/: Phase 1 diagnostic review across all applicable dimensions, then Phase 2 fix strategy for any findings. Read ONLY files referenced in completed plan.md tasks for diagnosis; MAY read additional files for impact analysis.
-5. Run the full test suite using `{{TEST_CMD}}`. When running tests: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep `/tmp/review-test-out.txt` for details — do NOT re-run the suite multiple times. Write and execute integration tests covering all goals from spec.md.
-6. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
-Report: number of findings found, or 'no findings' if clean."
+3. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/. The skill will run its internal review-fix loop (Reviewer → filter → Dev fix, max 3 rounds) and write review-report.md.
+4. Run the full test suite using `{{TEST_CMD}}`. When running tests: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep `/tmp/review-test-out.txt` for details — do NOT re-run the suite multiple times.
+5. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
+Report: verdict (PASS/NEEDS_FIXES), number of rounds, findings fixed/rejected."

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

@@ -32,7 +32,7 @@ Infer what needs to be done from the feature context above and follow the standa
 
 4. **Test**: Run the project test suite to verify all tests pass with no regressions.
 
-5. **Review**: Run `/prizmkit-code-review` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` to review changes against the spec. If findings exist, fix them and re-review (max 2 rounds).
+5. **Review**: Run `/prizmkit-code-review` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` to review and auto-fix changes against the spec (internal review-fix loop, max 3 rounds).
 
 6. **Retrospective**: Run `/prizmkit-retrospective` to sync `.prizm-docs/` with code changes.
 

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

@@ -164,9 +164,14 @@ When tests fail, use convergence recovery — keep fixing while progress is bein
 
 
 {{IF_BROWSER_INTERACTION}}
-### Phase 3.5: Browser Verification (playwright-cli) — MANDATORY
+### Phase 3.5: Browser Verification — MANDATORY
 
-You MUST execute this phase. Do NOT skip it. Do NOT mark it as completed without actually running playwright-cli.
+You MUST execute this phase. Do NOT skip it.
+
+**Browser Tool**: {{BROWSER_TOOL}}
+
+{{IF_BROWSER_TOOL_PLAYWRIGHT}}
+**Using: playwright-cli**
 
 **CRITICAL CONSTRAINT — playwright-cli ONLY, NO Playwright MCP**:
 - You MUST use `playwright-cli` (the CLI tool) for ALL browser interactions in this phase
@@ -253,16 +258,81 @@ Construct your verification workflow based on: (1) the playwright-cli skill docu
 1. Close the playwright-cli browser: `playwright-cli close`
 2. Kill the dev server process: `kill $DEV_SERVER_PID 2>/dev/null || true`
 3. Verify port is released: `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_PLAYWRIGHT}}
+{{IF_BROWSER_TOOL_OPENCLI}}
+**Using: opencli** (reuses Chrome logged-in sessions)
+
+**CRITICAL CONSTRAINT — opencli browser ONLY**:
+- You MUST use `opencli browser` for ALL browser interactions in this phase
+- All browser actions go through `opencli browser <command>` in the Bash tool
+
+**Step 0 — OpenCLI Readiness Check (BLOCKING)**:
+
+0a. Check if `opencli` is installed:
+```bash
+which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If `NOT_INSTALLED`: `npm install -g @jackwener/opencli@latest`. If installation fails, log `## Browser Verification: SKIPPED — opencli installation failed` and proceed.
+
+0b. Verify Browser Bridge: `opencli doctor`. If fails, log skip and proceed.
+
+0c. Learn usage: `opencli browser --help 2>/dev/null || opencli --help`
+
+**Step 1 — Start Dev Server**: (same port detection as playwright path)
+```bash
+DEV_PORT={{DEV_PORT}}
+if [ "$DEV_PORT" = "{{DEV_PORT}}" ]; then
+  DEV_PORT=$(node -e "const s=require('./package.json').scripts.dev; const m=s.match(/-p\s+(\d+)/); console.log(m?m[1]:'')" 2>/dev/null)
+  DEV_PORT=${DEV_PORT:-3000}
+fi
+```
+Start server, wait for ready, then: `opencli browser open http://localhost:$DEV_PORT && opencli browser state`
+
+**Step 2 — Verification**:
+
+Use `opencli browser state` to discover elements with `[N]` indices, then verify:
+   {{BROWSER_VERIFY_STEPS}}
+
+Chain commands: `opencli browser click <N> && opencli browser wait time 1 && opencli browser state`
+
+**Step 3 — Cleanup**:
+1. `opencli browser close`
+2. `kill $DEV_SERVER_PID 2>/dev/null || true`
+3. `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_OPENCLI}}
+{{IF_BROWSER_TOOL_AUTO}}
+**Tool Selection**: Choose the best browser tool at runtime.
+
+**Step 0 — Detect available tools**:
+```bash
+echo "=== playwright-cli ===" && which playwright-cli 2>/dev/null && playwright-cli --version 2>/dev/null || echo "NOT_INSTALLED"
+echo "=== opencli ===" && which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If opencli installed: `opencli doctor 2>/dev/null || echo "OPENCLI_BRIDGE_FAILED"`
+
+**Decision table**:
+| Condition | Tool |
+|-----------|------|
+| Only playwright-cli available | playwright-cli |
+| Only opencli available (doctor passes) | opencli |
+| Both — local dev server, forms, components | playwright-cli |
+| Both — needs real login state (OAuth/SSO) | opencli |
+| Both — third-party integration verification | opencli |
+| Neither available | Install playwright-cli as default |
+
+Then follow the corresponding tool's workflow above (Steps 1-3).
+{{END_IF_BROWSER_TOOL_AUTO}}
 
 **Step 4 — Reporting**:
 
 Append results to `context-snapshot.md`:
    ```
    ## Browser Verification
+   Tool: <playwright-cli or opencli>
    URL: http://localhost:$DEV_PORT
    Dev Server Command: <actual command used>
-   playwright-cli version: <version>
-   Steps executed: [list of playwright-cli commands used]
+   Tool version: <version>
+   Steps executed: [list of commands used]
    Screenshot: [path]
    Result: PASS / FAIL (reason)
    Server cleanup: confirmed

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

@@ -263,31 +263,35 @@ Prompt:
 > "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/spec.md` for goals and acceptance criteria
 > 2. Read `.prizmkit/specs/{{FEATURE_SLUG}}/plan.md` for architecture decisions and completed tasks
-> 3. Read `.prizm-docs/root.prizm` and relevant L1/L2 docs for RULES, PATTERNS, TRAPS
-> 4. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/: Phase 1 diagnostic review across all applicable dimensions, then Phase 2 fix strategy formulation for any findings. Read ONLY files referenced in completed plan.md tasks for diagnosis; MAY read additional files for impact analysis.
-> 5. Run the full test suite using `{{TEST_CMD}}`. When running: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep the file for details — do NOT re-run the suite multiple times. Write and execute integration tests covering all goals.
-> 6. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
-> Report: number of findings found, or 'no findings' if clean."
+> 3. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/. The skill runs an internal review-fix loop (Reviewer → filter → Dev fix, max 3 rounds) and writes review-report.md.
+> 4. Run the full test suite using `{{TEST_CMD}}`. When running: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep the file for details — do NOT re-run the suite multiple times.
+> 5. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
+> Report: verdict (PASS/NEEDS_FIXES), number of rounds, findings fixed/rejected."
 
 Wait for Reviewer to return.
 
 **Gate Check — Review Report**:
 After Reviewer agent returns, verify the review report was written:
 ```bash
-grep -q "## Findings" .prizmkit/specs/{{FEATURE_SLUG}}/review-report.md && echo "GATE:PASS" || echo "GATE:MISSING"
+grep -q "## Verdict" .prizmkit/specs/{{FEATURE_SLUG}}/review-report.md && echo "GATE:PASS" || echo "GATE:MISSING"
 ```
-If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write review-report.md to .prizmkit/specs/{{FEATURE_SLUG}}/ with findings."
+If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write review-report.md to .prizmkit/specs/{{FEATURE_SLUG}}/."
 
-**Verdict decision** (L4 responsibility): Read review-report.md findings count. If findings exist → NEEDS_FIXES. If no findings → PASS.
+Read `review-report.md` and check the Verdict:
+- `PASS` → proceed to next phase
+- `NEEDS_FIXES` → the skill exhausted its max rounds; log the remaining findings and proceed
 
-- If NEEDS_FIXES: spawn Dev to fix (Dev reads Fix Instructions in review-report.md), re-run Review (max 3 rounds)
-
-**CP-3**: Tests pass, no unresolved findings.
+**CP-3**: Tests pass, review complete.
 
 {{IF_BROWSER_INTERACTION}}
-### Phase 5.5: Browser Verification (playwright-cli) — MANDATORY
+### Phase 5.5: Browser Verification — MANDATORY
+
+You MUST execute this phase. Do NOT skip it.
 
-You MUST execute this phase. Do NOT skip it. Do NOT mark it as completed without actually running playwright-cli.
+**Browser Tool**: {{BROWSER_TOOL}}
+
+{{IF_BROWSER_TOOL_PLAYWRIGHT}}
+**Using: playwright-cli**
 
 **CRITICAL CONSTRAINT — playwright-cli ONLY, NO Playwright MCP**:
 - You MUST use `playwright-cli` (the CLI tool) for ALL browser interactions in this phase
@@ -374,16 +378,81 @@ Construct your verification workflow based on: (1) the playwright-cli skill docu
 1. Close the playwright-cli browser: `playwright-cli close`
 2. Kill the dev server process: `kill $DEV_SERVER_PID 2>/dev/null || true`
 3. Verify port is released: `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_PLAYWRIGHT}}
+{{IF_BROWSER_TOOL_OPENCLI}}
+**Using: opencli** (reuses Chrome logged-in sessions)
+
+**CRITICAL CONSTRAINT — opencli browser ONLY**:
+- You MUST use `opencli browser` for ALL browser interactions in this phase
+- All browser actions go through `opencli browser <command>` in the Bash tool
+
+**Step 0 — OpenCLI Readiness Check (BLOCKING)**:
+
+0a. Check if `opencli` is installed:
+```bash
+which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If `NOT_INSTALLED`: `npm install -g @jackwener/opencli@latest`. If installation fails, log `## Browser Verification: SKIPPED — opencli installation failed` and proceed.
+
+0b. Verify Browser Bridge: `opencli doctor`. If fails, log skip and proceed.
+
+0c. Learn usage: `opencli browser --help 2>/dev/null || opencli --help`
+
+**Step 1 — Start Dev Server**: (same port detection as playwright path)
+```bash
+DEV_PORT={{DEV_PORT}}
+if [ "$DEV_PORT" = "{{DEV_PORT}}" ]; then
+  DEV_PORT=$(node -e "const s=require('./package.json').scripts.dev; const m=s.match(/-p\s+(\d+)/); console.log(m?m[1]:'')" 2>/dev/null)
+  DEV_PORT=${DEV_PORT:-3000}
+fi
+```
+Start server, wait for ready, then: `opencli browser open http://localhost:$DEV_PORT && opencli browser state`
+
+**Step 2 — Verification**:
+
+Use `opencli browser state` to discover elements with `[N]` indices, then verify:
+   {{BROWSER_VERIFY_STEPS}}
+
+Chain commands: `opencli browser click <N> && opencli browser wait time 1 && opencli browser state`
+
+**Step 3 — Cleanup**:
+1. `opencli browser close`
+2. `kill $DEV_SERVER_PID 2>/dev/null || true`
+3. `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_OPENCLI}}
+{{IF_BROWSER_TOOL_AUTO}}
+**Tool Selection**: Choose the best browser tool at runtime.
+
+**Step 0 — Detect available tools**:
+```bash
+echo "=== playwright-cli ===" && which playwright-cli 2>/dev/null && playwright-cli --version 2>/dev/null || echo "NOT_INSTALLED"
+echo "=== opencli ===" && which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If opencli installed: `opencli doctor 2>/dev/null || echo "OPENCLI_BRIDGE_FAILED"`
+
+**Decision table**:
+| Condition | Tool |
+|-----------|------|
+| Only playwright-cli available | playwright-cli |
+| Only opencli available (doctor passes) | opencli |
+| Both — local dev server, forms, components | playwright-cli |
+| Both — needs real login state (OAuth/SSO) | opencli |
+| Both — third-party integration verification | opencli |
+| Neither available | Install playwright-cli as default |
+
+Then follow the corresponding tool's workflow above (Steps 1-3).
+{{END_IF_BROWSER_TOOL_AUTO}}
 
 **Step 4 — Reporting**:
 
 Append results to `context-snapshot.md`:
    ```
    ## Browser Verification
+   Tool: <playwright-cli or opencli>
    URL: http://localhost:$DEV_PORT
    Dev Server Command: <actual command used>
-   playwright-cli version: <version>
-   Steps executed: [list of playwright-cli commands used]
+   Tool version: <version>
+   Steps executed: [list of commands used]
    Screenshot: [path]
    Result: PASS / FAIL (reason)
    Server cleanup: confirmed

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

@@ -328,38 +328,35 @@ Prompt:
 > "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/spec.md` for goals and acceptance criteria
 > 2. Read `.prizmkit/specs/{{FEATURE_SLUG}}/plan.md` for architecture decisions and completed tasks
-> 3. Read `.prizm-docs/root.prizm` and relevant L1/L2 docs for RULES, PATTERNS, TRAPS
-> 4. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/: Phase 1 diagnostic review across all applicable dimensions, then Phase 2 fix strategy formulation for any findings. Read ONLY files referenced in completed plan.md tasks for diagnosis; MAY read additional files for impact analysis.
-> 5. Run the full test suite using `{{TEST_CMD}}`. When running tests: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep `/tmp/review-test-out.txt` for details — do NOT re-run the suite multiple times. Write and execute integration tests covering all goals from spec.md.
-> 6. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
-> Report: number of findings found, or 'no findings' if clean."
+> 3. Run /prizmkit-code-review with artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/. The skill runs an internal review-fix loop (Reviewer → filter → Dev fix, max 3 rounds) and writes review-report.md.
+> 4. Run the full test suite using `{{TEST_CMD}}`. When running tests: `({{TEST_CMD}}) 2>&1 | tee /tmp/review-test-out.txt | tail -20`, then grep `/tmp/review-test-out.txt` for details — do NOT re-run the suite multiple times.
+> 5. review-report.md will be written to .prizmkit/specs/{{FEATURE_SLUG}}/ by prizmkit-code-review.
+> Report: verdict (PASS/NEEDS_FIXES), number of rounds, findings fixed/rejected."
 
 Wait for Reviewer to return.
 
 **Gate Check — Review Report**:
 After Reviewer agent returns, verify the review report was written:
 ```bash
-grep -q "## Findings" .prizmkit/specs/{{FEATURE_SLUG}}/review-report.md && echo "GATE:PASS" || echo "GATE:MISSING"
+grep -q "## Verdict" .prizmkit/specs/{{FEATURE_SLUG}}/review-report.md && echo "GATE:PASS" || echo "GATE:MISSING"
 ```
-If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write review-report.md to .prizmkit/specs/{{FEATURE_SLUG}}/ with findings."
+If GATE:MISSING — send message to Reviewer (re-spawn if needed): "Write review-report.md to .prizmkit/specs/{{FEATURE_SLUG}}/."
 
-**Verdict decision** (L4 responsibility): Read review-report.md findings count. If findings exist → NEEDS_FIXES. If no findings → PASS.
+Read `review-report.md` and check the Verdict:
+- `PASS` → proceed to next phase
+- `NEEDS_FIXES` → the skill exhausted its max rounds; log the remaining findings and proceed
 
-- If NEEDS_FIXES: spawn Dev to fix with this prompt:
-  > "Read {{DEV_SUBAGENT_PATH}}. Fix issues for feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}).
-  > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/review-report.md` — contains structured Fix Instructions with exact steps.
-  > 2. Follow Fix Instructions in order (respect Depends On / Blocks dependencies). Each finding has: Root Cause, Fix Strategy, Code Guidance, and Verification criteria.
-  > 3. After each fix, run the Verification command listed in that finding to confirm it works.
-  > 4. Run `{{TEST_CMD}}` to verify no regressions.
-  > 5. Do NOT execute any git commands."
-  Then re-run Review (max 3 rounds).
-
-**CP-3**: Integration tests pass, no unresolved findings.
+**CP-3**: Integration tests pass, review complete.
 
 {{IF_BROWSER_INTERACTION}}
-### Phase 5.5: Browser Verification (playwright-cli) — MANDATORY
+### Phase 5.5: Browser Verification — MANDATORY
+
+You MUST execute this phase. Do NOT skip it.
 
-You MUST execute this phase. Do NOT skip it. Do NOT mark it as completed without actually running playwright-cli.
+**Browser Tool**: {{BROWSER_TOOL}}
+
+{{IF_BROWSER_TOOL_PLAYWRIGHT}}
+**Using: playwright-cli**
 
 **CRITICAL CONSTRAINT — playwright-cli ONLY, NO Playwright MCP**:
 - You MUST use `playwright-cli` (the CLI tool) for ALL browser interactions in this phase
@@ -446,16 +443,81 @@ Construct your verification workflow based on: (1) the playwright-cli skill docu
 1. Close the playwright-cli browser: `playwright-cli close`
 2. Kill the dev server process: `kill $DEV_SERVER_PID 2>/dev/null || true`
 3. Verify port is released: `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_PLAYWRIGHT}}
+{{IF_BROWSER_TOOL_OPENCLI}}
+**Using: opencli** (reuses Chrome logged-in sessions)
+
+**CRITICAL CONSTRAINT — opencli browser ONLY**:
+- You MUST use `opencli browser` for ALL browser interactions in this phase
+- All browser actions go through `opencli browser <command>` in the Bash tool
+
+**Step 0 — OpenCLI Readiness Check (BLOCKING)**:
+
+0a. Check if `opencli` is installed:
+```bash
+which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If `NOT_INSTALLED`: `npm install -g @jackwener/opencli@latest`. If installation fails, log `## Browser Verification: SKIPPED — opencli installation failed` and proceed.
+
+0b. Verify Browser Bridge: `opencli doctor`. If fails, log skip and proceed.
+
+0c. Learn usage: `opencli browser --help 2>/dev/null || opencli --help`
+
+**Step 1 — Start Dev Server**: (same port detection as playwright path)
+```bash
+DEV_PORT={{DEV_PORT}}
+if [ "$DEV_PORT" = "{{DEV_PORT}}" ]; then
+  DEV_PORT=$(node -e "const s=require('./package.json').scripts.dev; const m=s.match(/-p\s+(\d+)/); console.log(m?m[1]:'')" 2>/dev/null)
+  DEV_PORT=${DEV_PORT:-3000}
+fi
+```
+Start server, wait for ready, then: `opencli browser open http://localhost:$DEV_PORT && opencli browser state`
+
+**Step 2 — Verification**:
+
+Use `opencli browser state` to discover elements with `[N]` indices, then verify:
+   {{BROWSER_VERIFY_STEPS}}
+
+Chain commands: `opencli browser click <N> && opencli browser wait time 1 && opencli browser state`
+
+**Step 3 — Cleanup**:
+1. `opencli browser close`
+2. `kill $DEV_SERVER_PID 2>/dev/null || true`
+3. `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
+{{END_IF_BROWSER_TOOL_OPENCLI}}
+{{IF_BROWSER_TOOL_AUTO}}
+**Tool Selection**: Choose the best browser tool at runtime.
+
+**Step 0 — Detect available tools**:
+```bash
+echo "=== playwright-cli ===" && which playwright-cli 2>/dev/null && playwright-cli --version 2>/dev/null || echo "NOT_INSTALLED"
+echo "=== opencli ===" && which opencli 2>/dev/null && opencli --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+If opencli installed: `opencli doctor 2>/dev/null || echo "OPENCLI_BRIDGE_FAILED"`
+
+**Decision table**:
+| Condition | Tool |
+|-----------|------|
+| Only playwright-cli available | playwright-cli |
+| Only opencli available (doctor passes) | opencli |
+| Both — local dev server, forms, components | playwright-cli |
+| Both — needs real login state (OAuth/SSO) | opencli |
+| Both — third-party integration verification | opencli |
+| Neither available | Install playwright-cli as default |
+
+Then follow the corresponding tool's workflow above (Steps 1-3).
+{{END_IF_BROWSER_TOOL_AUTO}}
 
 **Step 4 — Reporting**:
 
 Append results to `context-snapshot.md`:
    ```
    ## Browser Verification
+   Tool: <playwright-cli or opencli>
    URL: http://localhost:$DEV_PORT
    Dev Server Command: <actual command used>
-   playwright-cli version: <version>
-   Steps executed: [list of playwright-cli commands used]
+   Tool version: <version>
+   Steps executed: [list of commands used]
    Screenshot: [path]
    Result: PASS / FAIL (reason)
    Server cleanup: confirmed

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

@@ -154,11 +154,11 @@ After implement completes, verify:
 If `FAST_PATH=true` (≤ 2 tasks, obvious root cause), skip this phase entirely.
 
 Run `/prizmkit-code-review` with `artifact_dir=.prizmkit/bugfix/{{BUG_ID}}/`:
-- Reviews changes against spec.md
-- If NEEDS_FIXES: fix the issues and re-run review (max 3 review rounds)
-- If PASS or PASS_WITH_WARNINGS: proceed
+- The skill runs an internal review-fix loop (Reviewer → filter → Dev fix, max 3 rounds) and writes review-report.md
+- If PASS: proceed
+- If NEEDS_FIXES: the skill exhausted its max rounds; log remaining findings and proceed
 
-**CP-3**: Code review passes, all tests green.
+**CP-3**: Code review complete, all tests green.
 
 **Checkpoint update**: Set step `prizmkit-code-review` to `"completed"`.
 

package/bundled/dev-pipeline/templates/feature-list-schema.json

@@ -172,11 +172,17 @@
           },
           "browser_interaction": {
             "type": "object",
-            "description": "Browser verification config for features with UI. Requires playwright-cli. AI auto-detects dev server command, URL, and port from project config at runtime.",
+            "description": "Browser verification config for features with UI. Supports playwright-cli and opencli. AI auto-detects dev server command, URL, and port from project config at runtime.",
             "properties": {
+              "tool": {
+                "type": "string",
+                "enum": ["playwright-cli", "opencli", "auto"],
+                "default": "auto",
+                "description": "Browser tool to use. 'auto' (default) = AI chooses at runtime. 'playwright-cli' = local dev server verification in isolated browser. 'opencli' = reuses Chrome logged-in session, ideal for verifying third-party integrations or OAuth flows."
+              },
               "verify_steps": {
                 "type": "array",
-                "description": "Verification goals describing WHAT to verify (not HOW). AI decides concrete playwright-cli actions at runtime based on actual code and snapshot. If omitted, AI explores the app and verifies the feature works.",
+                "description": "Verification goals describing WHAT to verify (not HOW). AI decides concrete browser tool actions at runtime based on actual code and snapshot. If omitted, AI explores the app and verifies the feature works.",
                 "items": {
                   "type": "string"
                 }