Skip to content

Commit e9fa802

Browse files
mpstatonclaude
andcommitted
update(mcp, docs): playwright MCP at project scope + browser-drive block in CLAUDE.md; reach-edu pointer bump
The browser-drive-verification rollout's augment-it half: Playwright MCP lands in the committed .mcp.json (loads next session), the canonical browser-drive block lands in CLAUDE.md, and clients/reach-edu advances to the Aspen-Socratic inputs commit. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UvYzx7vDWeafnkAi2nEQeb
1 parent 07c2616 commit e9fa802

3 files changed

Lines changed: 34 additions & 2 deletions

File tree

.mcp.json

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22
"mcpServers": {
33
"surrealdb": {
44
"command": "${CLAUDE_PROJECT_DIR:-.}/scripts/mcp-surrealdb.sh"
5+
},
6+
"playwright": {
7+
"type": "stdio",
8+
"command": "npx",
9+
"args": [
10+
"@playwright/mcp@latest"
11+
],
12+
"env": {}
513
}
614
}
7-
}
15+
}

CLAUDE.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,27 @@
22
For additional context about technologies to be used, project structure,
33
shell commands, and other important information, read the current plan
44
<!-- SPECKIT END -->
5+
6+
<!-- lossless:browser-drive:start -->
7+
## Browser-drive verification (Playwright MCP + Claude Chrome)
8+
9+
Agents verify UI work by driving a real browser BEFORE asking a human to walk the surface. Two tiers:
10+
11+
- **Codified (default): Playwright MCP** — navigate/click/type, accessibility-tree snapshots, DOM assertions; headless-capable, runs unwatched. Wire it per repo at **project scope** (config lands in the committed `.mcp.json`):
12+
13+
```bash
14+
claude mcp add -s project playwright -- npx @playwright/mcp@latest
15+
```
16+
17+
- **Interactive: `claude --chrome`** (or `/chrome` → enable by default) — Claude drives the operator's real Chrome while they watch; screenshots/GIFs + console and network logs.
18+
19+
Rules that make it safe and cheap:
20+
21+
1. Newly added MCP servers load in the **next** session, not the current one (same rule as skills symlinks).
22+
2. Prefer **accessibility snapshots over screenshots** — raster is token-expensive; use it only for visual questions (layout, theme).
23+
3. Browser-driven **reads are unrestricted; writes only against the repo's designated safe target** — never mint test entities in shared/canonical data.
24+
4. The drive's click-path is **named in the phase plan before implementation**; a drive that lives only in a session transcript is not codified.
25+
5. A browser drive proves the buttons **work**; the human walk-through still judges whether the surface is **usable**. It augments the human rung, never replaces it.
26+
27+
Full pattern: `context-v/blueprints/Browser-Drive-Verification-For-Agent-Sessions.md` at the anchor monorepo root (kit rollout draft: `ai-labs/context-vigilance-kit/context-v/blueprints/`). Loop integration proven in `ai-labs/augment-it/context-v/loops/`.
28+
<!-- lossless:browser-drive:end -->

clients/reach-edu

0 commit comments

Comments
 (0)