lidge-jun/codexclaw / plugins/codexclaw/skills/dev-debugging
cxc-dev-debugging
VerifiedUse for debugging and system comprehension. Triggers: debug this, root cause, how does X work, reverse engineer, 왜 안 돼, 디버깅, 원인 분석, 로직 파악, 뜯어봐.
references/tools/playwright.md
View on GitHub# Playwright CLI for Debugging
Use Playwright as a debugging tool (not just a test runner) when the bug is in
a web surface: visual, routing, network, or state-dependent behavior.
Lineage: lazycodex `tools/playwright-cli.md`, adapted for codexclaw.
## When to Use (vs browser:control-in-app-browser)
Playwright is for DETERMINISTIC repro: a spec file that fails red and passes
green. For one-shot exploratory QA, use the native browser tools per
`dev-testing` QA-TOOL-LADDER-01.
## Quick Repro Spec
```bash
npx playwright codegen http://localhost:3000 # record actions -> code
```
One-shot repro from a bug description:
```typescript
import { test, expect } from '@playwright/test';
test('bug: empty cart shows 500', async ({ page }) => {
await page.goto('http://localhost:3000/cart');
await expect(page.locator('.cart-items')).toBeVisible();
// if this fails, the bug is real and reproducible
});
```
## Debug Mode
```bash
PWDEBUG=1 npx playwright test --headed # opens inspector, pauses on test
npx playwright test --debug # same (shorthand)
npx playwright test --ui # interactive UI mode
```
## Trace Viewer (post-mortem)
```bash
npx playwright test --trace on # record trace
npx playwright show-trace test-results/trace.zip # replay
```
Trace contains: screenshots per action, DOM snapshots, network log, console
log. Often sufficient to find the bug without live debugging.
## Useful Listeners for Agent Debugging
```typescript
page.on('console', msg => console.log(`[browser] ${msg.type()}: ${msg.text()}`));
page.on('pageerror', err => console.error(`[browser error]`, err));
page.on('request', req => console.log(`>> ${req.method()} ${req.url()}`));
page.on('response', res => console.log(`<< ${res.status()} ${res.url()}`));
```
## Viewport / Device Gotchas
- Always set viewport explicitly: `page.setViewportSize({ width: 1440, height: 900 })`
- `isMobile: true` changes touch behavior and user-agent — test with and without
- Default headless viewport is 1280x720; headed is the OS window size
## Cleanup
```bash
# Kill Playwright browsers
pkill -f 'chromium.*--headless' || true
pkill -f 'playwright' || true
# Remove trace files if not needed
rm -rf test-results/ playwright-report/
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |