fixture-driven-tdd

What problem does it solve?

Fixture-driven TDD prevents parser and pipeline tests from passing on guessed event shapes by forcing tests to use real Claude CLI JSON captured from the database or recordings.

Core Features & Use Cases

• Uses real CLI output as the source of truth: loads and replays NDJSON/JSONL event lines from apps/summoner/src/__fixtures__/claude/real to validate parser behavior.
• Supports synthetic events when real data can’t trigger: uses apps/summoner/src/__fixtures__/claude/synthetic for edge cases that are hard to reproduce while keeping them clearly marked.
• Builds deterministic fake segments: adds segment builder functions in apps/summoner/src/test/fake-claude.ts so tests generate events consistently and without inline JSON.
• Covers both parser and end-to-end pipeline: validates adapter parsing status and can assert end-to-end event flow via the fake summoner and channel emission.

Quick Start

Ask the skill to show you how to capture a new fixture from the real CLI output, add it to the correct real/ or synthetic/ fixture folder, extend the fake-claude.ts segment builders, and then write a RED-to-GREEN parser and pipeline test using those fixtures.