Skip to content

claude.md: nested guides, build/run, gotchas, services + models docs

jedmund requested to merge jedmund/munich-v2 into main

Created by: jedmund

Summary

  • Main CLAUDE.md grows three small sections: Nested guides (router to the five nested CLAUDE.md files), Build and run (Xcode scheme/target/sim), and Gotchas (Xcode target membership, orphaned JSON, snake_case decoder, Unicode accidentals, newer exercises skipping ToolBridge). Two pre-existing em dashes also cleaned up to match the style rule.
  • Two new nested files: synthesize/synthesize/Services/CLAUDE.md (audio engine conventions, environment keys, setSafely rationale, DSP wiring) and synthesize/synthesize/Models/CLAUDE.md (the *Config pattern, JSON to Swift field conventions, ancillary model inventory).
  • Cross-links added to content/CLAUDE.md, Views/Tools/CLAUDE.md, and Views/Exercises/CLAUDE.md so any nested file points back to root and siblings.

All claims verified against source (deployment target, decoder strategy, setSafely behavior, env key locations, Models/Services directory contents).

Test plan

  • Read the root CLAUDE.md top-to-bottom, confirm sections read cleanly and under 120 lines.
  • Click through each nested-guide pointer to confirm the file exists.
  • Spot-check one gotcha against a real past incident to confirm it matches behavior.
  • Open Services/CLAUDE.md and Models/CLAUDE.md, verify relative cross-links resolve.

Merge request reports