day-in-my-life

A day in my life as <name>'s agent

The agent reads its own history with the user and makes a short film about it:

• Look: two-tone brush ink, hand-lettered title, one character (the blot).
• Story: one average session in time order, built from what this user actually does (a coder gets a coding

day), from the first message to the lesson it keeps.

• Sound: a string score locked to every beat.

Every line on screen is a receipt. The user approves each one before anything renders.

When to use / when not

• Use when a Claude Code user wants a personal film of their work with the agent, and has at least 10 local

sessions over 5 days in ~/.claude/projects.

• Do not use for someone else's history, a team's shared logs, product marketing, or content the user won't

review. If there are no local transcripts (e.g. claude.ai only), stop: this skill never invents receipts.

Requirements and side effects (complete list)

• Tools: Node 22+, Python 3.9+, ffmpeg on PATH. The HyperFrames CLI pinned to npx hyperframes@0.8.70

(downloaded from the npm registry on first use).

• Setup (once, manually): sh scripts/setup.sh runs npm ci from the committed lockfile: p5 2.3.2 (LGPL-2.1),

p5.brush 2.2.1 (MIT), puppeteer 25.9.0 (Apache-2.0, which fetches its pinned Chrome for Testing). For score.py: python3 -m pip install -r scripts/requirements.txt (numpy, scipy).

• Reads (local only): ~/.claude/projects/*/*.jsonl (the user's transcripts), ~/.claude/projects/*/memory/*.md,

and the CLAUDE.md of projects those transcripts point at. Nothing is uploaded.

• Network at preview/render: the page loads the Gochi Hand font (SIL OFL) from Google Fonts. Nothing else.
• Writes: only inside the film folder you create: receipts.json, story.json, story.js, music/, renders/.

These hold the user's words; never commit or share them.

• No credentials, no paid calls.

Workflow

1. Setup: sh scripts/setup.sh (once), plus the pip line above.
2. Harvest: python3 scripts/harvest.py --out <film>/receipts.json. Stop if enough is false.
3. Story: build the timeline from routine (the user's average session, in order), map each step to a chapter

type, and fill it from the receipts, per references/story.md. 8 to 13 chapters. Ask the user which name goes in the title.

1. Privacy gate: show the user one table of every on-screen line with its source (session, timestamp), take their

edits, and get an explicit yes. Then set "approved": true.

1. Scaffold: node scripts/new-film.mjs <film>. It builds the film around the story.json already in the

folder. After any later edit to story.json, run node scripts/new-film.mjs <film> --sync. It validates order, fields and captions, blocks secrets, emails and paths, and flags URLs.

1. Design pass: node scripts/shoot.mjs <film> chapters <film>/renders/sheet.jpg --sheet 4 (one frame per

chapter, at its payload moment). Check every chapter reads (blot visible, quotes legible, nothing clipped or covering a bubble) and show the sheet to the user.

1. Score: python3 scripts/score.py <film>, per references/score.md.
2. Render: npx --yes hyperframes@0.8.70 check <film>, then from <film>:

npx --yes hyperframes@0.8.70 render --fps 24 --crf 12 --browser-gpu -o renders/film.mp4. Render locally; the page paints with WebGL.

1. QC: python3 scripts/qc.py <film> <film>/renders/film.mp4 must pass. Then watch it through once, with

sound, before delivering.

Rules

• The user's day, not a template. The routine sets which chapters appear and their order. Never add a step the

history doesn't show.

• Receipts only. Quotes are verbatim; stats are counted; names are the user's call. Drop any chapter you can't

back with a real line.

• Approval before render. story.approved is set only by the user's yes. The validator refuses credentials,

emails and file paths outright.

• The clock is the score. Timings live in archetypes.json; scenes.js and score.py both read it. Never

retime one without the other.

• Nothing idles. Every chapter keeps a camera move, a staged reveal or an action in flight. The boil is texture.
• Look defaults: SKETCH = 1.8, two tones, captions lowercase with no trailing period, seams through ink.

See references/look.md.

Verify success

• new-film.mjs --sync prints no errors.
• The design-pass sheet shows every chapter.
• qc.py passes all checks:
• stepping: about 8 drawings/s, every change on the 3-frame grid, no hold longer than 3 frames
• seams: a fully inked frame on every wipe and swallow cut
• lamp: picture black and score silent within one frame of each other, until the tag
• loudness: -19 to -15 LUFS, true peak ≤ -1 dBTP

Smoke test without anyone's data (the fictional example story):

node scripts/new-film.mjs /tmp/dimil && python3 scripts/score.py /tmp/dimil \
  && (cd /tmp/dimil && npx --yes hyperframes@0.8.70 render --fps 24 --crf 12 --browser-gpu -o renders/film.mp4) \
  && python3 scripts/qc.py /tmp/dimil /tmp/dimil/renders/film.mp4

Files

• scripts/:
• harvest.py: local receipts.
• new-film.mjs: scaffold and validate.
• shoot.mjs: stills and sheets.
• score.py: compose, synthesize and master.
• qc.py: render checks.
• setup.sh, package.json, package-lock.json, requirements.txt: pinned dependencies.
• assets/kit/: the ink engine (brush-ink.js, props.js, film.js, hf-bridge.js).
• assets/template/: index.html, scenes.js, archetypes.json, hyperframes.json, story.example.json (fictional).
• references/: story.md (routine → timeline → lines → privacy gate), look.md (the kit), score.md (the

arrangement).