Skip to content

chore: plan and render the release video locally - #1056

Merged
blafourcade merged 16 commits into
nextfrom
feat/release-video
Oct 22, 2026
Merged

blafourcade merged 16 commits into
nextfrom
feat/release-video

Conversation

@blafourcade

@blafourcade blafourcade commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

What

A release video that is planned, checked and rendered locally, with no CI job. It is a maintainer tool, not product: nothing here ships in a plugin.

  • scripts/check-release-video.js: lists the skills and CLI commands touched by feat: commits since the last release tag, and fails with Scènes manquantes : … when one has neither a scene nor a written reason to be skipped. A release with no feat: commit needs no video.
  • scripts/render-release-video.cjs: node scripts/render-release-video.cjs --version <x.y> turns aidd_docs/release-video/scenes.json into an MP4 with a pinned Hyperframes. Fonts and logo are in aidd_docs/release-video/assets/; contributor avatars are fetched at render time, with the logo as fallback for an account that no longer exists.
  • .claude/skills/release-video: the skill that writes the plan then renders. .agents/skills/release-video is a symlink to it, because Codex reads repository skills from .agents/skills.

Out of scope

  • Wiring the check into promote.yml.
  • Uploading the MP4 to YouTube, Skool and Discord.
  • aidd_docs/release-video/scenes.json for the next release: the check fails until it is written.

Verification

  • Tests written first and seen failing for the reason they name; each guard has a mutation that turns its own test red.
  • A regression test covers a hook that sets GIT_DIR.
  • Rendered a plan describing the previous release (63.5 s) and checked frames of every scene.
  • pnpm exec lefthook run pre-commit green.
  • Not run: the skill's own ## Test tables on a real project; Codex loading the symlinked skill.

🤖 Generated with Claude Code

@blafourcade
blafourcade requested a review from a team as a code owner October 19, 2026 03:42
Comment thread .claude/skills/release-video/assets/render-release-video.cjs Fixed
Comment thread .claude/skills/release-video/assets/render-release-video.cjs Fixed
@blafourcade
blafourcade marked this pull request as draft October 19, 2026 04:04
@blafourcade blafourcade changed the title feat(aidd-pm): plan and render the release video locally chore: plan and render the release video locally Oct 19, 2026
@blafourcade
blafourcade marked this pull request as ready for review October 19, 2026 04:42
blafourcade and others added 10 commits October 21, 2026 05:22
Add a coverage check that fails when a feature shipped since the last release has no scene
in the release video and no written reason to skip it, a local renderer that turns the scene
plan into an MP4 with a pinned Hyperframes, and the 11-release-video skill that writes the plan.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The release video is a maintainer tool, not product: move its skill out of aidd-pm into
.claude/skills, link it for Codex from .agents/skills, and add a render action next to the plan.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…e next release

A surface added then renamed or removed in the same cycle is no longer asked for. The plan
covers the rule generation change and skips the telemetry report format change, with its reason.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…note after its rows

The version was on screen from the first frame and typed again later; the note of a scene
appeared before its rows. The intro now starts empty and the note follows the last row.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The plan action now groups the user-visible fix commits into one scene and ends with the
contributors, listed from the compare between the last release tag and next.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The promote workflow runs the release video check on next's tip before it pushes the snapshot,
so a refusal leaves no branch or pull request behind. The skip_video input lets an urgent
promotion through. The weekly steps and the pipeline table say so.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…e, with optional music

The intro now carries a tagline and a few highlights, each scene a plain-language lead, and a
music track placed in the release video assets plays under the whole video with a fade in and out.
The plan action asks for both, taken from the release announcement.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… picture

The track is looped or cut to the length of the video, and its fade now peaks at the music
level: the fade lane is absolute, so a peak at full volume played the track at full volume.
A --music option renders with a track kept outside the repository.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… hook intro

The track's loud hook now plays under the intro, its calm bed under the scenes and its loud
finale under the outro, found from the track's own energy. The plan action asks for an intro
that makes a newcomer want to know more, and the next release's plan is rewritten that way.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…nce and plan the next release

The check names an intro tagline over six words, more than three highlights, a highlight over
three words and a lead over fourteen. The plan now covers Codex measurement, the rule assessment,
the telemetry reliability fixes and the contributors.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
blafourcade and others added 2 commits October 21, 2026 05:34
…jargon

The check now names internal words (tokens, telemetry, envelope, axis, transcript, payload, hook)
in the intro, titles and leads. The plan action asks for outcomes in everyday words, and the next
release's plan is rewritten that way.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…and clear intro tags

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@blafourcade blafourcade added this to the This week milestone Oct 22, 2026 — with Claude
release-please now drafts the umbrella release; CI attaches the bundle,
distributions, archives and video, publishes it, then posts a recap.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019tw8HkVy69fuukqR971Roz
Comment thread scripts/__tests__/release-recap.test.js Fixed
@blafourcade
blafourcade merged commit 196cd62 into next Oct 22, 2026
32 checks passed
@blafourcade
blafourcade deleted the feat/release-video branch October 22, 2026 20:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants