diff --git a/plugins/compound-engineering/.claude-plugin/plugin.json b/plugins/compound-engineering/.claude-plugin/plugin.json
index 1cd5183..c64273f 100644
--- a/plugins/compound-engineering/.claude-plugin/plugin.json
+++ b/plugins/compound-engineering/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "compound-engineering",
- "version": "2.24.0",
+ "version": "2.25.0",
"description": "AI-powered development tools. 27 agents, 20 commands, 14 skills, 1 MCP server for code review, research, design, and workflow automation.",
"author": {
"name": "Kieran Klaassen",
diff --git a/plugins/compound-engineering/CHANGELOG.md b/plugins/compound-engineering/CHANGELOG.md
index 4228314..887f9a4 100644
--- a/plugins/compound-engineering/CHANGELOG.md
+++ b/plugins/compound-engineering/CHANGELOG.md
@@ -5,6 +5,40 @@ All notable changes to the compound-engineering plugin will be documented in thi
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [2.25.0] - 2026-01-14
+
+### Added
+
+- **`agent-browser` skill** - Browser automation using Vercel's agent-browser CLI
+ - Navigate, click, fill forms, take screenshots
+ - Uses ref-based element selection (simpler than Playwright)
+ - Works in headed or headless mode
+
+### Changed
+
+- **Replaced Playwright MCP with agent-browser** - Simpler browser automation across all browser-related features:
+ - `/test-browser` command - Now uses agent-browser CLI with headed/headless mode option
+ - `/feature-video` command - Uses agent-browser for screenshots
+ - `design-iterator` agent - Browser automation via agent-browser
+ - `design-implementation-reviewer` agent - Screenshot comparison
+ - `figma-design-sync` agent - Design verification
+ - `bug-reproduction-validator` agent - Bug reproduction
+ - `/review` workflow - Screenshot capabilities
+ - `/work` workflow - Browser testing
+
+- **`/test-browser` command** - Added "Step 0" to ask user if they want headed (visible) or headless browser mode
+
+### Removed
+
+- **Playwright MCP server** - Replaced by agent-browser CLI (simpler, no MCP overhead)
+- **`/playwright-test` command** - Renamed to `/test-browser`
+
+### Summary
+
+- 27 agents, 20 commands, 14 skills, 1 MCP server
+
+---
+
## [2.23.2] - 2026-01-09
### Changed
diff --git a/plugins/compound-engineering/commands/test-browser.md b/plugins/compound-engineering/commands/test-browser.md
index 9ee9658..22e23ac 100644
--- a/plugins/compound-engineering/commands/test-browser.md
+++ b/plugins/compound-engineering/commands/test-browser.md
@@ -43,6 +43,22 @@ See the `agent-browser` skill for detailed usage.
## Main Tasks
+### 0. Ask Browser Mode
+
+
+
+Before starting tests, ask user if they want to watch the browser:
+
+Use AskUserQuestion with:
+- Question: "Do you want to watch the browser tests run?"
+- Options:
+ 1. **Headed (watch)** - Opens visible browser window so you can see tests run
+ 2. **Headless (faster)** - Runs in background, faster but invisible
+
+Store the choice and use `--headed` flag when user selects "Headed".
+
+
+
### 1. Determine Test Scope
$ARGUMENTS