Measuring true peak on the final MP4 instead of the WAV is the detail most pipelines get wrong. AAC adds inter-sample peaks the limiter never sees, so a mix that reads -1 dB before muxing can land over the ceiling in the file people download. Looping the ceiling down until the encoded file passes is a tidy fix. The safe zone overlay and the per-scene contact sheet are worth stealing for any short video, not just ads; catching captions across a face in one still beats scrubbing the whole cut. I also like the LOG.md rule that a mistake becomes a SKILL.md rule only after it happens twice. That keeps the skill from filling up with one-off superstitions.
That makes sense. The number in the file people download is the only one that holds up once the AAC encoder has had its say. On the twice rule, how do you tell that a second failure is the same mistake and not just a similar one? I'd guess the LOG.md entries need a consistent shape for that match to be reliable.
The test is the same cause, not the same symptom, since two runs can fail in similar ways for different reasons. You're right that a fixed shape per entry, with the symptom, the cause and the fix, makes that match much easier to check.
Same cause over same symptom is a good test. It also means an entry only gets written once someone actually knows the cause, so a run that failed for unclear reasons stays a note instead of turning into a rule too early. When a fix lands in the skill itself, do you delete the entry, or keep it around as history?
DemoVexa
Measuring true peak on the final MP4 instead of the WAV is the detail most pipelines get wrong. AAC adds inter-sample peaks the limiter never sees, so a mix that reads -1 dB before muxing can land over the ceiling in the file people download. Looping the ceiling down until the encoded file passes is a tidy fix. The safe zone overlay and the per-scene contact sheet are worth stealing for any short video, not just ads; catching captions across a face in one still beats scrubbing the whole cut. I also like the LOG.md rule that a mistake becomes a SKILL.md rule only after it happens twice. That keeps the skill from filling up with one-off superstitions.