What problem does it solve?
This Skill automates the creation of comprehensive vertical traces and RED contract tests from feature specs, eliminating manual, error-prone mapping between API requests and persisted state so teams can detect transformation bugs early.
Core Features & Use Cases
- Extracts scenario lists from spec.md and explores the codebase to locate relevant handlers, services, and repositories.
- Produces 7-section vertical traces that document API entry, input validation, per-layer parameter transformation arrows, side effects, error paths, output, and observability.
- Derives RED contract tests (happy/sad/side-effect/contract) that purposely fail until implementation matches the trace, and maintains a Delta Protocol changelog for trace evolution.
- Use case: convert a feature spec into docs/feature/trace.md plus failing tests to drive development and ensure end-to-end parameter mapping from Request fields to DB columns.
Quick Start
Use the trace skill to read docs/my-feature/spec.md, generate docs/my-feature/trace.md, and scaffold RED contract tests for each scenario.