v1.22.0: step 30a — a show-and-tell page is part of the ritual, not an extra - #18
Merged
Merged
Conversation
…n extra Standing instruction from the owner, 2026-08-07: "please make sure for all sessions running in this repo, using show and tell to explain a session's work is always part of the session-handoff ritual." Phase 6 already produced a user-facing recap, but only in CHAT. That has two problems the owner has now hit from both sides: the recap scrolls away and cannot be re-read next week, and the artifact that DOES persist — the handoff doc — is deliberately written for a future Claude, in exactly the dense register he has a standing rule against being handed. So Phase 6 gains a step BEFORE the chat recap: build the `show-and-tell` page, commit it to docs/deliverables/, register it as a tracker artifact, and run its fact-verifier. The chat recap still happens and now points at the page. Three things written into the step because each is a way the page gets worse: - load the SKILL rather than hand-rolling a "summary page", which is how the honesty box and the fact-verifier get dropped; - if the session also ends in owner decisions, the promptback widgets go INSIDE this page under each question's context, not into a second document (step 17b already says this from the other direction); - run the fact-verifier, because a plain-English translation is precisely where a number drifts — re-wording is the whole point, and re-wording is when "9.58 km" becomes "under 10 km" becomes "about 8". Skip only when the session produced nothing a non-specialist would care about, and then say so in one line. The summary table gains a NOT-BLANKABLE row (now six), because a step at the very end of Phase 6 is the classic tail-drop position — the same reason the usage record and the reverse-lint needed one.
…open This PR set only plugin.json to 1.22.0 and left package.json and marketplace.json at 1.21.0, which is what the manifest-consistency test was failing on and what made the PR DIRTY against main. Both 1.22.0 and 1.23.0 have since been taken, and 1.24.0 landed today. All four places this repo records a version now read 1.25.0 — package.json, .claude-plugin/marketplace.json, plugins/session-handoff/.claude-plugin/plugin.json and the SKILL.md frontmatter — plus the README Version History entry, which the suite asserts must name the current version and lead the list. SKILL.md itself rebased with zero conflicts; the step 30a content is untouched. 79 tests, 0 fail. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
wan-huiyan
force-pushed
the
skill/show-and-tell-is-part-of-the-ritual
branch
from
August 10, 2026 19:32
0482b49 to
6ef82f0
Compare
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
1 participant
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.
Owner's standing instruction, 2026-08-07: "please make sure for all sessions running in this repo, using show and tell to explain a session's work is always part of the session-handoff ritual."
Phase 6 already produced a user-facing recap — but only in chat. Two problems, and the owner has now hit both:
So Phase 6 gains step 30a, before the chat recap: build the
show-and-tellpage, commit it todocs/deliverables/, register it as a tracker artifact, run its fact-verifier. The chat recap still happens and now points at the page.Three things written into the step, each a way the page gets worse in practice:
promptbackwidgets go INSIDE this page, under each question's own context — not a second document. Step 17b already says this from the other direction.9.58 kmbecomes "under 10 km" becomes "about 8".Skip only when the session produced nothing a non-specialist would care about — and then say so in one line rather than manufacturing a page.
Summary table gains a sixth NOT-BLANKABLE row. A step at the very end of Phase 6 sits in the classic tail-drop position — the same reason the usage record and the reverse-lint each needed one.
🤖 Generated with Claude Code
https://claude.ai/code/session_01G4UwnAwa65pUC7fTBmptsq