Menu
Investigate bugs using a systematic approach: reproduce, identify the layer, write a failing test, fix root cause.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | debug |
| description | Investigate bugs using a systematic approach: reproduce, identify the layer, write a failing test, fix root cause. |
pnpm test && pnpm lint# Check API responses
curl -s http://localhost:3000/health | jq
# Check database content
pnpm --filter @acme/database db:studio
# Run specific test file
pnpm --filter @acme/domain test -- --run src/use-cases/__tests__/MyUseCase.test.ts
# Run E2E with visible browser
pnpm test:e2e --headed --project=chromium
# Check TypeScript errors
pnpm lint
| Layer | Common Issues |
|---|---|
| Domain | Missing validation, wrong error type |
| Database | Schema mismatch, missing seed data, FK constraints |
| API | Missing @Public() decorator, wrong DI token, DTO validation |
| Frontend | Wrong query key, missing invalidation, stale cache |
Implement a backlog story following the layer order (Domain, Database, API, Frontend, E2E) with TDD.
Review the backlog to determine what to work on next by checking epic and story statuses in docs/backlog/.
Automates pre-commit workflow: lint, test, review changes, then commit with conventional commit format.
Verify a story is complete by checking acceptance criteria, running all tests, and updating status.
Add end-to-end Playwright tests for a feature using data-testid selectors, with API and UI test patterns.
Add unit tests for domain logic, database adapters, API endpoints, or frontend components using Vitest patterns.