docs: sync AGENTS.md and CLAUDE.md with undocumented test files - #149
Conversation
Ten test files existed in apps/backend/tests/ with no entry in either
CLAUDE.md or apps/backend/AGENTS.md:
test_audio_fixture{,_smoke}.py – WAV fixture helpers (no model load)
test_bootstrap_scripts.py – bin/asa install/bootstrap contracts
test_cleanup.py – utils/cleanup.py artifact helpers
test_genre_check.py – scripts/genre_check.py
test_phase1_evaluation_transcription.py – Layer 2 eval harness path
test_phase2_grammar_fix.py – Phase 2 gerund-fix post-process
test_phase2_prompt_catalog.py – prompt examples vs Live 12 catalogue
test_root_dev_script.py – scripts/dev.sh env-loading
test_root_e2e_script.py – test-e2e{,-integration}.sh contracts
test_separation_ab.py – separation_ab.py SI-SDR math
Also two file-map gaps in apps/ui/AGENTS.md:
src/services/midi/ was missing types.ts
src/services/sessionMusician/ was missing index.ts
https://claude.ai/code/session_01YQ4niA1KyaRrHMPXwFzJYm
slittycode
left a comment
There was a problem hiding this comment.
Verdict: APPROVE
Summary
Pure documentation sync — adds 10 previously undocumented backend test files to apps/backend/AGENTS.md, backfills inline test references in CLAUDE.md, and plugs two file-map gaps in apps/ui/AGENTS.md (midi/types.ts, sessionMusician/index.ts). Every single referenced file was verified to exist in the repo. No code touched, no contracts changed.
Findings
None.
Test results
CI still running at review time, but immaterial — no source files changed. Docs-only diffs cannot break tests.
Phase boundary check
Clean. No phase code touched.
Generated by Claude Code
slittycode
left a comment
There was a problem hiding this comment.
Verdict: APPROVE
Summary
Docs-only sync: adds 10 previously undocumented backend test files to apps/backend/AGENTS.md and CLAUDE.md, fixes two file-map gaps in apps/ui/AGENTS.md (midi/types.ts, sessionMusician/index.ts). All 4 CI checks pass. All referenced files confirmed to exist on disk.
Findings
None.
Test results
Frontend ✓ / Backend ✓ / Chromatic ✓ / Loudness WASM ✓ — 4/4 green.
Phase boundary check
Clean — no code changed.
Generated by Claude Code
Summary
Audit of documentation vs. actual codebase found 10 test files in
apps/backend/tests/with no entry in eitherCLAUDE.mdorapps/backend/AGENTS.md, plus 2 file-map gaps inapps/ui/AGENTS.md. All documented files and modules were confirmed to exist — no stale references to removed code were found.apps/backend/AGENTS.md— added to File Map:test_audio_fixture.py/test_audio_fixture_smoke.py— WAV fixture helpers (no model load)test_bootstrap_scripts.py—bin/asainstall/bootstrap script contractstest_cleanup.py—utils/cleanup.pyartifact-cleanup helperstest_genre_check.py—scripts/genre_check.pytest_phase1_evaluation_transcription.py— Layer 2 transcription evaluation harness pathtest_phase2_grammar_fix.py— Phase 2 gerund-fix post-process inserver_phase2.pytest_phase2_prompt_catalog.py— prompt examples vs. Live 12 cataloguetest_root_dev_script.py— rootscripts/dev.shenv-loading behaviortest_root_e2e_script.py— roottest-e2e{,-integration}.shscript contractstest_separation_ab.py—separation_ab.pySI-SDR aggregation mathtests/test_cleanup.py" to theutils/cleanup.pyentrytests/test_separation_ab.py" to theseparation_ab.pyentryapps/ui/AGENTS.md— file-map gaps:src/services/midi/was missingtypes.tssrc/services/sessionMusician/was missingindex.tsCLAUDE.md— added inline test references at the relevant callout sites:utils/cleanup.py):tests/test_cleanup.pytests/test_phase1_evaluation_transcription.pytests/test_phase2_grammar_fix.py,tests/test_phase2_prompt_catalog.pytest_root_dev_script.py,test_root_e2e_script.py,test_bootstrap_scripts.py,test_genre_check.py,test_separation_ab.pyTest plan
apps/backend/tests/apps/ui/src/services/https://claude.ai/code/session_01YQ4niA1KyaRrHMPXwFzJYm
Generated by Claude Code