Add a real VHS-recorded demo of writ to the README - #34
Merged
Conversation
Records the actual propose -> approve -> implement -> attest -> status loop against a freshly seeded throwaway repo: an in-scope edit that gets attested and leaves status clean/auto-mergeable, then an out-of-scope edit that status flags as drift while staying quiet about the in-scope work - the signal-vs-noise contrast that is writ's whole pitch. scripts/record-demo/record.sh builds the real binary, seeds the repo, and drives scripts/record-demo/demo.tape end to end, so the recording is reproducible via `make demo`. Claude-Session: https://claude.ai/code/session_01UjNjr48C8W9go9PmcNjdh6
Points future agents at make demo / scripts/record-demo for
regenerating docs/assets/demo.{gif,mp4} instead of hand-editing them.
Claude-Session: https://claude.ai/code/session_01UjNjr48C8W9go9PmcNjdh6
- Drop Set Height from 800 to 480 so the recorded terminal fits its
content instead of leaving most of every frame empty.
- Shorten the attest --note text so the criterion claim line
("retries-on-5xx ... claimed by agent ...") no longer wraps
mid-phrase at the right edge.
- Also relocate the throwaway demo repo from
scripts/record-demo/.demo-repo to .demo-repo at the repo root:
the shorter absolute path keeps writ's "writ approved: <path>"
output line under the terminal's column width too, since it was
wrapping in the same way for the same reason (line too long for
the terminal width) even though it wasn't flagged directly.
Re-recorded with the same tape end to end; re-verified dimensions
(1280x480 mp4, 960x360 gif), frame counts (1089 / 523), and file
sizes (473K / 868K, gif well under the 10 MB budget), and visually
confirmed no line wraps anywhere in the loop.
Claude-Session: https://claude.ai/code/session_01UjNjr48C8W9go9PmcNjdh6
Owner
Author
|
Fixed the two cosmetic issues:
While verifying, I found the Re-recorded end to end with |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
--yes→ an in-scope edit that gets attested and leavesstatusclean/auto-mergeable → an out-of-scope edit thatstatusflags as drift, while staying quiet about the in-scope work. That signal-vs-noise contrast is the whole pitch, and both runs are captured back to back.docs/assets/demo.mp4(1280px H.264/yuv420p, full quality) anddocs/assets/demo.gif(960px, ~12fps palette-quantized, 832 KB — well under the 10 MB budget) for the README.## Demosection to the README right after the intro/badges, embedding the GIF and linking the MP4 for full quality.scripts/record-demo/record.sh+scripts/record-demo/demo.tape(the actual recording script, reviewable in the diff) +scripts/record-demo/README.md, and aMakefilewith ademotarget so the recording is one command (make demo) and reproducible.AGENTS.mdso future agents regenerate the assets viamake demoinstead of hand-editing them.Note: the task brief mentioned a possibly-unverified demo GIF already embedded in the README under
docs/assets/. There wasn't one — README had no## Demosection anddocs/assets/only heldwrit-banner.svg— so there was nothing to delete/replace beyond adding the new assets.Test plan
go build ./...,go vet ./...,gofmt -l .(clean),go test ./...all passmake demoruns end to end: builds the real binary, seeds a throwaway repo, records with VHS, converts with ffmpegdocs/assets/demo.mp4is H.264/yuv420p, 1280x800, 1148 frames (~46s)docs/assets/demo.gifis 960x600, 551 frames, 832 KB🤖 Generated with Claude Code
https://claude.ai/code/session_01UjNjr48C8W9go9PmcNjdh6