plan-tests
Installation
SKILL.md
Plan Tests
Quick Reference
| Change type | First spec | Path | Why |
|---|---|---|---|
| API contract, params, status code, JSON shape | Request spec | spec/requests/ |
Proves the real HTTP contract |
| Domain rule on a cohesive record or value object | Model spec | spec/models/ |
Fast feedback on domain behavior |
| Multi-step orchestration across collaborators | Service spec | spec/services/ |
Focuses on the workflow boundary |
| Enqueue/run/retry/discard behavior | Job spec | spec/jobs/ |
Captures async semantics directly |
| Critical Turbo/Stimulus or browser-visible flow | System spec | spec/system/ |
Use only when browser interaction is the real risk |
| Engine routing, generators, host integration | Engine spec | spec/requests/ or engine path |
Normal app specs miss engine wiring — see test-engine |
| Bug fix | Reproduction spec | Where the bug is observed | Proves the fix and prevents regression |
HARD-GATE
CHECKPOINT: Test Design Review