yoloyolo/.planning/phases/02-audio-synthesis-engine/02-VALIDATION.md

phase, slug, status, nyquist_compliant, wave_0_complete, tdd_model, created

phase	slug	status	nyquist_compliant	wave_0_complete	tdd_model	created
2	audio-synthesis-engine	draft	true	true	co-creation	2026-03-26

Phase 2 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.

---

Test Infrastructure

Property	Value
Framework	go test (stdlib)
Config file	none — existing Go test infrastructure
Quick run command	go test ./synth/... ./encode/...
Full suite command	go test ./...
Estimated runtime	~5 seconds

---

TDD Model

This phase uses co-creation TDD: tests are written within the same task as the implementation, following RED-GREEN-REFACTOR within each task. All TDD tasks are marked with tdd="true" in their plan XML. Test files are created as part of the task, not as a separate Wave 0 plan.

This is explicitly chosen over pre-existing stub TDD because:

1. Each task's <behavior> block defines expected test cases before implementation begins
2. The executor writes tests FIRST (RED), then implementation (GREEN) within the same task
3. No test file exists before the task starts — the task creates both test and implementation

Wave 0 requirements are limited to environment/tooling setup (gcc, ffprobe, go-lame dependency), handled by Plan 01 Task 1.

---

Sampling Rate

• After every task commit: Run go test ./synth/... ./encode/...
• After every plan wave: Run go test ./...
• Before /gsd:verify-work: Full suite must be green
• Max feedback latency: 5 seconds

---

Per-Task Verification Map

Task ID	Plan	Wave	Requirement	Test Type	Automated Command	TDD	Status
02-01-01	01	1	SYNTH-01	setup	go version && gcc --version && ffprobe -version && grep "go-lame" go.mod && CGO_ENABLED=1 go build ./...	n/a	⬜ pending
02-01-02	01	1	SYNTH-01, SYNTH-02	unit	cd /home/dev/workspace/yoloyolo && go test ./synth/... -v -count=1	co-creation	⬜ pending
02-02-01	02	2	SYNTH-03	unit	cd /home/dev/workspace/yoloyolo && go test ./synth/... -run "TestPan|TestStereo|TestClamp" -v -count=1	co-creation	⬜ pending
02-02-02	02	2	SYNTH-03	unit	cd /home/dev/workspace/yoloyolo && go test ./synth/... -run "TestNewBank|TestRenderWindow|TestMixerNoClip|TestStereoPan|TestMultipleWindows" -v -count=1	co-creation	⬜ pending
02-03-01	03	3	OUT-02, OUT-03	integration	cd /home/dev/workspace/yoloyolo && CGO_ENABLED=1 go test ./encode/... -v -count=1	co-creation	⬜ pending
02-03-02	03	3	OUT-01	build	cd /home/dev/workspace/yoloyolo && go build -o /dev/null ./cmd/netsynth/ && go run ./cmd/netsynth/ --help 2>&1 | grep -q "\-o.*output" && echo "OK"	n/a	⬜ pending

Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky

---

Wave 0 Requirements

• gcc — C compiler required for go-lame CGo compilation (Plan 01, Task 1)
• ffprobe — MP3 validation in acceptance tests (Plan 01, Task 1)
• go get github.com/sjzar/go-lame@v0.0.9 — MP3 encoding dependency (Plan 01, Task 1)
• go-audio/wav — Skipped. Per CONTEXT.md Claude's Discretion grant; write PCM bytes directly to LameWriter (CLAUDE.md updated).

Test stubs are co-created with implementation in each TDD task (see TDD Model section above).

---

Manual-Only Verifications

Behavior	Requirement	Why Manual	Test Instructions
Perceptually distinct drone tones per traffic class	SYNTH-01	Subjective audio quality	Play output MP3, verify each class sounds distinct
Amplitude rises/falls audibly with traffic volume	SYNTH-02	Subjective perception	Listen for volume changes across windows with varying traffic
Stereo panning creates spatial separation	SYNTH-03	Subjective audio quality	Listen with headphones, verify bass center and highs spread

---

Validation Sign-Off

• All tasks have <automated> verify commands matching plan blocks
• Sampling continuity: no 3 consecutive tasks without automated verify (all tasks have automated verify)
• Wave 0 covers environment/tooling setup (Plan 01, Task 1)
• Co-creation TDD model documented; test expectations defined in <behavior> blocks
• No watch-mode flags
• Feedback latency < 5s
• nyquist_compliant: true set in frontmatter

Approval: ready