[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75V564EHES2DF239AJNCBA5":3,"skill-same:01M75V564EHES2DF239AJNCBA5":82},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75V564EHES2DF239AJNCBA5","media",null,"Maps Puck sound and recording: Puck.Audio mixer and synth, speakers, cues, music director, voice babble, HUD text speech, audio.render, capture.start clips, Puck.Recording (Opus, AV1, Matroska).","ByteTerrace\u002FPuck","ByteTerrace","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F18753984?v=4","01M75V2WCB9PGGC3H7RZC7AXPS","01M75V2WD0NJPRNP5HJ75VZGD0",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: media\ndescription: \"Maps Puck sound and recording: Puck.Audio mixer and synth, speakers, cues, music director, voice babble, HUD text speech, audio.render, capture.start clips, Puck.Recording (Opus, AV1, Matroska).\"\n---\n\n# Media\n\nA map of what Puck plays and what it records. Sound and recording share no\ncode, but both are presentation output that must never feed simulation, and\nboth reach real hardware only through `Puck.Platform` seams (`platform`).\n\n- **Sound.** `Puck.Audio` holds the deterministic mixer and synth\n  (`Puck.Audio.Mixing`) and the music, babble and clock primitives that are\n  simulation state (`Puck.Audio.Simulation`). It parses no document.\n  `Puck.World` drives it: `WorldAudioDirector` derives the emitter table from\n  the delivered world, `WorldAudioRenderService` owns the device, and the\n  document intake lives in `src\u002FPuck.World\u002FAudio\u002F`.\n- **Recording.** `Puck.Recording` is the platform-neutral recording graph: a\n  `RecordingDocument`, a `RecordingSession` that drives it against encoder and\n  audio-capture factories, a deterministic Matroska\u002FWebM muxer and an Opus\n  lane. Encoders and loopback or microphone capture live in\n  `Puck.Platform.Windows`; Linux registers factories that decline.\n\n[Audio](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) and\n[recording](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md) are the human references;\n[the World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md) documents\nthe presentation side. When this file and the code disagree, the code wins and\nthis file is corrected in the same change.\n\n## Find the owner by what you need\n\n| You need | Owner | Read |\n|---|---|---|\n| A sound at a place in the world (a speaker, a machine's audio, a creation's sound) | `speakers` rows (`WorldSpeakerFeed`, `WorldSpeakerAttenuation`) → `WorldAudioDirector` emitters → `AudioSnapshot` → `AudioMixer` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-device-worldaudiorenderservicecs) |\n| A one-shot sound on an event (a stinger, an edit echo) | an `audio.cues` row (`WorldAudioCue`) naming an event token and a `patches` row; `WorldAudioDirector.SubmitCue` | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A synthesized instrument voice | a `puck.synthesizer-patch.v1` document, crossed into `VoicePatch` by `WorldVoicePatchFactory.FromDocument`, played by `VoiceSynth` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#document-intake-worldvoicepatchfactorycs) |\n| Background music that changes with play: segments, layers, embellishments, a beat clock | `music` rows (`WorldMusicRow`) compiled by `MusicDirectorFactory` into `MusicDirector` and `MusicClock`; edges from `WorldEventFeed` become `MusicSenseEdge`s | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A rhythm hit window | a `compareState` range over the `$clock:\u003Cmusic>:phaseError` operand; no dedicated grader | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A tune or a playable instrument | `tunes` rows (`WorldTune`, `puck.tune.v1`): `TuneMachineSource` for a passive tune, `TuneInstrumentEngine` for an engageable screen machine whose tempo folds into the music clock through `WorldServer.InstrumentClockBoundary` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-diegetic-instrument-puckhumblegamingbrickforgetunetuneinstrumentenginetuneinstrumentmachine) |\n| An identity that babbles in syllables | `WorldIdentityDefinition.Voice` → `WorldAudioDirector.TriggerBabble` → `VoiceBabbler.ComputeTriggerTicks` | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A HUD element or sign that reads its text aloud | a HUD `Text` element's `voice` (`patchId` or `sampleSet`), observed by `WorldHudSpeechFeed`, played by `TextSpeechSource` | [text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech), [samples](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#authored-syllable-samples) |\n| A WAV of an utterance without a device | `audio.render \u003CpanelId> \u003CelementId> \u003Coutput.wav>` through `WorldSpeechRenderer` | [text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech) |\n| Speaker gain bound to state | the shared bindable scalar grammar, resolved through the state mirror each publication | [speaker gain](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#speaker-gain) |\n| The output device, its faults and rebinds | `WorldAudioRenderService` over `IAudioRenderDeviceFactory` (Windows: `WasapiAudioRenderDeviceFactory`) | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-device-worldaudiorenderservicecs) |\n| A gameplay clip with game audio and microphone | `capture.start\u002Fstatus\u002Fstop` (`WorldRecordingCommandModule`) or `--recording`, loading a `RecordingDocument` and arming a `RecordingSession` on the host's `FrameCaptureController` | [recording](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#how-a-session-is-assembled) |\n| A still frame to PNG from a host | `CaptureSink` (and `ICaptureFrameObserver`), an `ICaptureSink`; a World's own stills are `world.screenshot` (`puck-world` console) | [frame capture](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#frame-capture-and-overlays) |\n| Text, boxes or a timecode burnt into the recording only | `OverlayCompositor` over the document's overlay rows | [frame capture](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#frame-capture-and-overlays) |\n| A container, codec or track question | `MatroskaMuxer` and `EbmlWriter`; `OpusAudioLane`, `OpusStreamEncoder`, `LinearResampler`; `Av1TemporalDelimiterFilter` | [muxing and codecs](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#muxing-and-codecs) |\n| A deterministic re-run of a session | `replay.*` and the replay tape (`puck-world`), not a recording | [replay](..\u002Fpuck-world\u002Freferences\u002Freplay.md) |\n\n## Contracts that bite\n\n- **Sound decides nothing.** The mixer, synth and emitter table are\n  presentation: no simulation read depends on them. `MusicClock`,\n  `MusicDirector` and `VoiceBabbler` are the exception, simulation state\n  stepped by the server and hashed with it; they never read the wall clock and\n  their seeds fold identity, ordinal and index only.\n- **The document crosses in one place.** `Puck.Audio` references\n  `Puck.Abstractions`, `Puck.Assets`, `Puck.Commands`, `Puck.Hosting` and\n  `Puck.Maths` exactly (the architecture gate's closure). A patch becomes a\n  `VoicePatch` only through `WorldVoicePatchFactory`.\n- **Plays silent, never crashes.** A failed endpoint parks the pump, detaches\n  the mixer and retries; a host with no backend (Linux, headless) reports\n  `device=unsupported` and machines synthesize at rate zero\n  (`MachineAudioRate`).\n- **Speech is a function of text and voice.** `TextSpeechSource` schedules\n  characters at exact audio-frame boundaries with no wall clock, frame delta\n  or history, so two exports of the same text and voice are byte-identical.\n- **Capture is a product capability (owner ruling).** Keep the\n  `capture.*` surface, `--recording`, the document format, the Windows encoder\n  ladder and loopback and microphone capture, and the Linux factories, even\n  with no current world caller ([puck-world](..\u002Fpuck-world\u002FSKILL.md#contracts-that-bite)).\n  Headless Worlds do not compose the capture verbs.\n- **A factory declines with a reason, never throws.** `RecordingSession.TryCreate`\n  opens only what the machine can encode and capture and fails whole when\n  neither a video encoder nor an audio lane resolves.\n- **Capture never blocks rendering.** The render thread copies into a free\n  `FrameSlotQueue` slot; a full queue drops the newest frame and counts it.\n- **Choose the clock deliberately.** `RecordingClock.Wall` (the default) stamps\n  from the wall clock; `RecordingClock.Sim` stamps frames from the tick clock\n  for a deterministic offline re-render and forbids audio rows.\n- **Container bytes are deterministic** for the same tracks and blocks;\n  the live file is crash-safe through a `Void` reservation that a clean\n  `Stop` replaces with a `SeekHead`.\n\n## Where each contract is enforced\n\n| Contract | Enforced by |\n|---|---|\n| `Puck.Audio`'s exact dependency closure | `puck architecture` (`build\u002FArchitecture.props`) |\n| One document boundary for patches | `WorldVoicePatchFactory.FromDocument`, the only converter |\n| A malformed recording document is never half-accepted | `RecordingDocumentValidator`, run by `RecordingDocumentSerialization.TryLoad` |\n| Every Matroska element is written one way | `EbmlWriter`'s typed helpers |\n| A crash leaves a playable prefix | the `Void` reservation in `MatroskaMuxer`; `MatroskaSeekHeadRecoveryLawTests` |\n| Sim-clock sessions carry no audio | `RecordingDocumentValidator`, which refuses audio rows under `RecordingClock.Sim` |\n\n## Open gaps\n\n- **No Linux backends.** No audio render, video encoder or audio capture on\n  Linux; the factories decline by name.\n- **A babbling identity has no world position.** Every syllable, like every\n  embellishment, voices listener-placed.\n- **Music layer and embellishment `gainThousandths` do not reach presentation\n  gain** (`MusicLayerDocument.GainThousandths`).\n- **Nothing proves a region crossing's `music.transition` cue end to end.**\n- **`LinearResampler` is linear**, not polyphase or anti-aliased.\n- **AV1 OBU framing is read twice.** `Av1Bitstream.TryReadObu` in\n  `Puck.Platform.Windows` omits the forbidden-bit check\n  `Av1TemporalDelimiterFilter.Strip` makes\n  ([refactoring packet](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fopen-items.md#refactoring-campaign)).\n- The references' and README's canaries (`voice-babble`,\n  `music-conditional-layer-and-embellishment`, `instrument-clock-source`) are\n  quarantined under `experimental\u002F`.\n\n## Verify\n\n- Unit laws: `tests\u002FPuck.Audio.Tests` (mixer, synth, `MusicClock`,\n  `MusicDirector`, `VoiceBabbler`), `tests\u002FPuck.Recording.Tests`.\n- Headless speech: boot the debug world and run the reference's\n  `audio.render` recipe ([text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech))\n  twice; two exports of unchanged text and voice are byte-identical. The guide\n  and the map sign in `worlds\u002Fdebug\u002Fguide.puck` are the live examples.\n- Live sound needs a windowed World with an audio device, which is a GPU leg\n  (`verification`): read `audio.state` (device, frames, faults, `peak`),\n  `audio.emitters`, `speaker.state` (including `lastCue:\u003Ctoken>`),\n  `voice.state`, `music.state` and `instrument.state` over stdin.\n- A clip: `capture.start`, `capture.status`, `capture.stop` on a windowed\n  World, then inspect the file; a lane that declined reports its reason\n  rather than failing the session.\n\n## Look-alikes\n\n- `replay.*` records inputs for deterministic re-simulation; `capture.*`\n  records pixels and sound. Neither substitutes for the other.\n- `world.screenshot` and `world.captures` (scheduled captures in a test) are\n  `puck-world` console verbs over the same frame-capture controller.\n- A machine's own audio (an emulator's APU) belongs to `gaming-bricks`; the\n  mixer only binds its output to a speaker.\n- Camera and desktop capture feeds that a screen shows are `platform`\n  capture services, not recording.\n\n## Route adjacent work\n\n| Skill | Route there for |\n|---|---|\n| `puck-world` | `speakers`, `audio.cues`, `music`, `tunes`, `patches` and HUD rows, console verbs, booting and driving a World. |\n| `platform` | The WASAPI render device, the Media Foundation encoder ladder, loopback and microphone capture, camera and desktop capture. |\n| `gaming-bricks` | An emulated machine's sound hardware and the tune cartridge's core. |\n| `rom-forge` | Authoring the `puck.tune.v1` jukebox cartridge chain. |\n| `maths-usage` | Fixed-point gains, seeded streams and the music clock's arithmetic. |\n| `verification` | GPU legs for windowed Worlds, the private CLI copy. |\n","# Media\n\nA map of what Puck plays and what it records. Sound and recording share no\ncode, but both are presentation output that must never feed simulation, and\nboth reach real hardware only through `Puck.Platform` seams (`platform`).\n\n- **Sound.** `Puck.Audio` holds the deterministic mixer and synth\n  (`Puck.Audio.Mixing`) and the music, babble and clock primitives that are\n  simulation state (`Puck.Audio.Simulation`). It parses no document.\n  `Puck.World` drives it: `WorldAudioDirector` derives the emitter table from\n  the delivered world, `WorldAudioRenderService` owns the device, and the\n  document intake lives in `src\u002FPuck.World\u002FAudio\u002F`.\n- **Recording.** `Puck.Recording` is the platform-neutral recording graph: a\n  `RecordingDocument`, a `RecordingSession` that drives it against encoder and\n  audio-capture factories, a deterministic Matroska\u002FWebM muxer and an Opus\n  lane. Encoders and loopback or microphone capture live in\n  `Puck.Platform.Windows`; Linux registers factories that decline.\n\n[Audio](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) and\n[recording](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md) are the human references;\n[the World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md) documents\nthe presentation side. When this file and the code disagree, the code wins and\nthis file is corrected in the same change.\n\n## Find the owner by what you need\n\n| You need | Owner | Read |\n|---|---|---|\n| A sound at a place in the world (a speaker, a machine's audio, a creation's sound) | `speakers` rows (`WorldSpeakerFeed`, `WorldSpeakerAttenuation`) → `WorldAudioDirector` emitters → `AudioSnapshot` → `AudioMixer` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-device-worldaudiorenderservicecs) |\n| A one-shot sound on an event (a stinger, an edit echo) | an `audio.cues` row (`WorldAudioCue`) naming an event token and a `patches` row; `WorldAudioDirector.SubmitCue` | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A synthesized instrument voice | a `puck.synthesizer-patch.v1` document, crossed into `VoicePatch` by `WorldVoicePatchFactory.FromDocument`, played by `VoiceSynth` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#document-intake-worldvoicepatchfactorycs) |\n| Background music that changes with play: segments, layers, embellishments, a beat clock | `music` rows (`WorldMusicRow`) compiled by `MusicDirectorFactory` into `MusicDirector` and `MusicClock`; edges from `WorldEventFeed` become `MusicSenseEdge`s | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A rhythm hit window | a `compareState` range over the `$clock:\u003Cmusic>:phaseError` operand; no dedicated grader | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A tune or a playable instrument | `tunes` rows (`WorldTune`, `puck.tune.v1`): `TuneMachineSource` for a passive tune, `TuneInstrumentEngine` for an engageable screen machine whose tempo folds into the music clock through `WorldServer.InstrumentClockBoundary` | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-diegetic-instrument-puckhumblegamingbrickforgetunetuneinstrumentenginetuneinstrumentmachine) |\n| An identity that babbles in syllables | `WorldIdentityDefinition.Voice` → `WorldAudioDirector.TriggerBabble` → `VoiceBabbler.ComputeTriggerTicks` | [audio reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md) |\n| A HUD element or sign that reads its text aloud | a HUD `Text` element's `voice` (`patchId` or `sampleSet`), observed by `WorldHudSpeechFeed`, played by `TextSpeechSource` | [text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech), [samples](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#authored-syllable-samples) |\n| A WAV of an utterance without a device | `audio.render \u003CpanelId> \u003CelementId> \u003Coutput.wav>` through `WorldSpeechRenderer` | [text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech) |\n| Speaker gain bound to state | the shared bindable scalar grammar, resolved through the state mirror each publication | [speaker gain](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#speaker-gain) |\n| The output device, its faults and rebinds | `WorldAudioRenderService` over `IAudioRenderDeviceFactory` (Windows: `WasapiAudioRenderDeviceFactory`) | [World audio README](..\u002F..\u002F..\u002Fsrc\u002FPuck.World\u002FAudio\u002FREADME.md#the-device-worldaudiorenderservicecs) |\n| A gameplay clip with game audio and microphone | `capture.start\u002Fstatus\u002Fstop` (`WorldRecordingCommandModule`) or `--recording`, loading a `RecordingDocument` and arming a `RecordingSession` on the host's `FrameCaptureController` | [recording](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#how-a-session-is-assembled) |\n| A still frame to PNG from a host | `CaptureSink` (and `ICaptureFrameObserver`), an `ICaptureSink`; a World's own stills are `world.screenshot` (`puck-world` console) | [frame capture](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#frame-capture-and-overlays) |\n| Text, boxes or a timecode burnt into the recording only | `OverlayCompositor` over the document's overlay rows | [frame capture](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#frame-capture-and-overlays) |\n| A container, codec or track question | `MatroskaMuxer` and `EbmlWriter`; `OpusAudioLane`, `OpusStreamEncoder`, `LinearResampler`; `Av1TemporalDelimiterFilter` | [muxing and codecs](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Frecording.md#muxing-and-codecs) |\n| A deterministic re-run of a session | `replay.*` and the replay tape (`puck-world`), not a recording | [replay](..\u002Fpuck-world\u002Freferences\u002Freplay.md) |\n\n## Contracts that bite\n\n- **Sound decides nothing.** The mixer, synth and emitter table are\n  presentation: no simulation read depends on them. `MusicClock`,\n  `MusicDirector` and `VoiceBabbler` are the exception, simulation state\n  stepped by the server and hashed with it; they never read the wall clock and\n  their seeds fold identity, ordinal and index only.\n- **The document crosses in one place.** `Puck.Audio` references\n  `Puck.Abstractions`, `Puck.Assets`, `Puck.Commands`, `Puck.Hosting` and\n  `Puck.Maths` exactly (the architecture gate's closure). A patch becomes a\n  `VoicePatch` only through `WorldVoicePatchFactory`.\n- **Plays silent, never crashes.** A failed endpoint parks the pump, detaches\n  the mixer and retries; a host with no backend (Linux, headless) reports\n  `device=unsupported` and machines synthesize at rate zero\n  (`MachineAudioRate`).\n- **Speech is a function of text and voice.** `TextSpeechSource` schedules\n  characters at exact audio-frame boundaries with no wall clock, frame delta\n  or history, so two exports of the same text and voice are byte-identical.\n- **Capture is a product capability (owner ruling).** Keep the\n  `capture.*` surface, `--recording`, the document format, the Windows encoder\n  ladder and loopback and microphone capture, and the Linux factories, even\n  with no current world caller ([puck-world](..\u002Fpuck-world\u002FSKILL.md#contracts-that-bite)).\n  Headless Worlds do not compose the capture verbs.\n- **A factory declines with a reason, never throws.** `RecordingSession.TryCreate`\n  opens only what the machine can encode and capture and fails whole when\n  neither a video encoder nor an audio lane resolves.\n- **Capture never blocks rendering.** The render thread copies into a free\n  `FrameSlotQueue` slot; a full queue drops the newest frame and counts it.\n- **Choose the clock deliberately.** `RecordingClock.Wall` (the default) stamps\n  from the wall clock; `RecordingClock.Sim` stamps frames from the tick clock\n  for a deterministic offline re-render and forbids audio rows.\n- **Container bytes are deterministic** for the same tracks and blocks;\n  the live file is crash-safe through a `Void` reservation that a clean\n  `Stop` replaces with a `SeekHead`.\n\n## Where each contract is enforced\n\n| Contract | Enforced by |\n|---|---|\n| `Puck.Audio`'s exact dependency closure | `puck architecture` (`build\u002FArchitecture.props`) |\n| One document boundary for patches | `WorldVoicePatchFactory.FromDocument`, the only converter |\n| A malformed recording document is never half-accepted | `RecordingDocumentValidator`, run by `RecordingDocumentSerialization.TryLoad` |\n| Every Matroska element is written one way | `EbmlWriter`'s typed helpers |\n| A crash leaves a playable prefix | the `Void` reservation in `MatroskaMuxer`; `MatroskaSeekHeadRecoveryLawTests` |\n| Sim-clock sessions carry no audio | `RecordingDocumentValidator`, which refuses audio rows under `RecordingClock.Sim` |\n\n## Open gaps\n\n- **No Linux backends.** No audio render, video encoder or audio capture on\n  Linux; the factories decline by name.\n- **A babbling identity has no world position.** Every syllable, like every\n  embellishment, voices listener-placed.\n- **Music layer and embellishment `gainThousandths` do not reach presentation\n  gain** (`MusicLayerDocument.GainThousandths`).\n- **Nothing proves a region crossing's `music.transition` cue end to end.**\n- **`LinearResampler` is linear**, not polyphase or anti-aliased.\n- **AV1 OBU framing is read twice.** `Av1Bitstream.TryReadObu` in\n  `Puck.Platform.Windows` omits the forbidden-bit check\n  `Av1TemporalDelimiterFilter.Strip` makes\n  ([refactoring packet](..\u002F..\u002F..\u002Fdocs\u002Fplans\u002Fopen-items.md#refactoring-campaign)).\n- The references' and README's canaries (`voice-babble`,\n  `music-conditional-layer-and-embellishment`, `instrument-clock-source`) are\n  quarantined under `experimental\u002F`.\n\n## Verify\n\n- Unit laws: `tests\u002FPuck.Audio.Tests` (mixer, synth, `MusicClock`,\n  `MusicDirector`, `VoiceBabbler`), `tests\u002FPuck.Recording.Tests`.\n- Headless speech: boot the debug world and run the reference's\n  `audio.render` recipe ([text speech](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Faudio.md#text-speech))\n  twice; two exports of unchanged text and voice are byte-identical. The guide\n  and the map sign in `worlds\u002Fdebug\u002Fguide.puck` are the live examples.\n- Live sound needs a windowed World with an audio device, which is a GPU leg\n  (`verification`): read `audio.state` (device, frames, faults, `peak`),\n  `audio.emitters`, `speaker.state` (including `lastCue:\u003Ctoken>`),\n  `voice.state`, `music.state` and `instrument.state` over stdin.\n- A clip: `capture.start`, `capture.status`, `capture.stop` on a windowed\n  World, then inspect the file; a lane that declined reports its reason\n  rather than failing the session.\n\n## Look-alikes\n\n- `replay.*` records inputs for deterministic re-simulation; `capture.*`\n  records pixels and sound. Neither substitutes for the other.\n- `world.screenshot` and `world.captures` (scheduled captures in a test) are\n  `puck-world` console verbs over the same frame-capture controller.\n- A machine's own audio (an emulator's APU) belongs to `gaming-bricks`; the\n  mixer only binds its output to a speaker.\n- Camera and desktop capture feeds that a screen shows are `platform`\n  capture services, not recording.\n\n## Route adjacent work\n\n| Skill | Route there for |\n|---|---|\n| `puck-world` | `speakers`, `audio.cues`, `music`, `tunes`, `patches` and HUD rows, console verbs, booting and driving a World. |\n| `platform` | The WASAPI render device, the Media Foundation encoder ladder, loopback and microphone capture, camera and desktop capture. |\n| `gaming-bricks` | An emulated machine's sound hardware and the tune cartridge's core. |\n| `rom-forge` | Authoring the `puck.tune.v1` jukebox cartridge chain. |\n| `maths-usage` | Fixed-point gains, seeded streams and the music clock's arithmetic. |\n| `verification` | GPU legs for windowed Worlds, the private CLI copy. |\n",{"name":5,"description":7},"main","2ef814b84c9595144e052c6dcd300badb619ee2f",".claude\u002Fskills\u002Fmedia",0,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck","https:\u002F\u002Fgithub.com\u002FByteTerrace","https:\u002F\u002Fbyteterrace.com","2026-11-12 13:59:16",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add ByteTerrace\u002FPuck --skill media",{"tool":37,"command":38},"bunx","bunx skills add ByteTerrace\u002FPuck --skill media",{"tool":40,"command":41},"pnpm","pnpm dlx skills add ByteTerrace\u002FPuck --skill media","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002FSKILL.md",true,[45,51,55,59,63,67,71,74,78],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"evals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fauthored-voice.md","REFERENCE","参考文档",110,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fauthored-voice.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fno-new-speech-engine.md",856,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fno-new-speech-engine.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"evals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Foffline-export.md",63,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Foffline-export.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"evals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fskill-fired.md",36,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm01-sign-reads-aloud\u002Fgraders\u002Fskill-fired.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"evals\u002Fm01-sign-reads-aloud\u002Fprompt.md",795,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm01-sign-reads-aloud\u002Fprompt.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"evals\u002Fm02-reproducible-clip\u002Fgraders\u002Fsim-clock.md",126,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm02-reproducible-clip\u002Fgraders\u002Fsim-clock.md",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":73},"evals\u002Fm02-reproducible-clip\u002Fgraders\u002Fskill-fired.md","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm02-reproducible-clip\u002Fgraders\u002Fskill-fired.md",{"path":75,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":76,"sourceHtmlUrl":77},"evals\u002Fm02-reproducible-clip\u002Fgraders\u002Fwall-default-and-no-audio.md",822,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm02-reproducible-clip\u002Fgraders\u002Fwall-default-and-no-audio.md",{"path":79,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":80,"sourceHtmlUrl":81},"evals\u002Fm02-reproducible-clip\u002Fprompt.md",763,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmedia\u002Fevals\u002Fm02-reproducible-clip\u002Fprompt.md",[83,90,97,104,111,118],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M75V6X1GBYDMSMJC8VXXPFAP","verification","Verifies Puck changes: landing bar, builds, stale DLLs, flaky tests, GPU\u002Fheavy leases, coverage, source-scan or regex laws versus type\u002Fcompiler enforcement, and writing tests.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverification\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M75V6TM3F9A7ZMA0Q43RVJSF","tooling","Maps shared build\u002FCLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M75V6R4E6AY73X27MC6EE5X5","tooling-files","Maps shared repository tooling for files, paths, Git queries, project ownership and Markdown fences. Load before adding or changing a helper in these areas.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling-files\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":18},"01M75V6N2P9XWWPH7EHRKMBTEC","symbol-analysis","Answers C# structure questions with puck references and declarations: which types derive from, implement or override a symbol, who references it, safe to delete or rename. Text: content-search.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsymbol-analysis\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":18},"01M75V6HRKM57BD8Q7A4N8QN0C","state","Maps Puck's state and rule engine (Puck.State, .Rules, .Search, .Topology, .Vectors, .Generators): arena, journal scopes, undo, hashing, rule compiler, faults, transforms, search, draws.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fstate\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":18},"01M75V6CE3X73KNZYFRT9A5W8F","sdf-authoring","Authors creations: shape rows, primitives, blends, folds, palettes, paints, render lanes, rigs, bake work and bytes, creation stats. Use to sculpt or fix a part. Grammar: puck-dsl; GPU: rendering.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsdf-authoring\u002FSKILL.md",[],[]]