From 649cfb2e48c84f5d24273efcbe0d5a5f35a69068 Mon Sep 17 00:00:00 2001 From: Damjan Dabo Date: Fri, 23 Oct 2026 20:24:09 +0200 Subject: [PATCH 1/2] docs: add the explainer video to the readme --- README.md | 4 ++++ docs/README.md | 2 +- docs/images/explainer-video.webp | Bin 0 -> 22170 bytes 3 files changed, 5 insertions(+), 1 deletion(-) create mode 100644 docs/images/explainer-video.webp diff --git a/README.md b/README.md index 9627aca..1c48569 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,10 @@ Keep the plan when you run `/compact`, and never end a session with work that exists only in chat. Four slash commands, two hooks and five one-handed keyboard shortcuts. This is the setup I run every day. +[![The explainer video: Claude Code's /compact is broken. A Claude Code session card with a four-step plan and a context bar.](docs/images/explainer-video.webp)](https://youtu.be/7tXR1H3viRg) + +[Watch the explainer on YouTube](https://youtu.be/7tXR1H3viRg): what /compact loses, and what each of the five shortcuts does. + ![Compacting a session. Before: four steps by hand, /compact-check, copy block, /compact, paste block. Now: two keys, Right Option plus comma for /compact-check and Right Option plus period for /compact.](docs/images/before-after.webp) ## Install with one prompt diff --git a/docs/README.md b/docs/README.md index 2e59591..2fa6b71 100644 --- a/docs/README.md +++ b/docs/README.md @@ -5,4 +5,4 @@ Design notes for the kit. User-facing material is in the repo root: [README.md]( - [architecture.md](architecture.md): the components, the compact-resume data flow, the state directory, the installer's algorithm, and which behaviours are documented by Claude Code versus only observed. - [decisions/](decisions/README.md): architecture decision records. - [001-shortcuts-live-in-karabiner.md](decisions/001-shortcuts-live-in-karabiner.md): why the keyboard shortcuts are a Karabiner rule and not a Claude Code keybinding, and what each shortcut types. -- [images/](images/): the three figures the README embeds and the social preview image for the GitHub page. +- [images/](images/): the three figures the README embeds, the explainer video thumbnail and the social preview image for the GitHub page. diff --git a/docs/images/explainer-video.webp b/docs/images/explainer-video.webp new file mode 100644 index 0000000000000000000000000000000000000000..995c0a47793088cd7d56513013cb8005000efd57 GIT binary patch literal 22170 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 eE1s2n3x>&g00000053QI00000000000002owfb5B literal 0 HcmV?d00001 From 1d4aa431effbe04e001fde17474117e535755dbb Mon Sep 17 00:00:00 2001 From: Damjan Dabo Date: Fri, 23 Oct 2026 20:27:37 +0200 Subject: [PATCH 2/2] docs: list the video thumbnail in the repo layout --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index a8029cb..7716544 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -11,7 +11,7 @@ A public kit that installs a session workflow into someone's Claude Code: four s - `karabiner/` `build.py` generates both rule files; never edit the JSON by hand - `install/` `install.sh` (check / plan / apply / verify / uninstall) plus the three Python helpers it calls: `merge-settings.py` (hook registrations), `update-claude-md.py` (the marked block), `manifest.py` (the install record uninstall replays) - `tests/run.sh` the whole suite, in a throwaway HOME -- `docs/images/` the three figures the README embeds and the 1280x640 social preview; `.github/workflows/tests.yml` runs `tests/run.sh` on a macOS runner for every pull request and every push to `main` +- `docs/images/` the three figures the README embeds, the explainer video thumbnail and the 1280x640 social preview; `.github/workflows/tests.yml` runs `tests/run.sh` on a macOS runner for every pull request and every push to `main` ## Rules for changes