docs: triage the 42 unreceipted rituals before building Fix 3 - #31
Closed
MCKRUZ wants to merge 1 commit into
Closed
Conversation
Proposal, not implementation. Fix 3's instruction was "add an artifact spec and a registry entry for each of the 42". Reading all 42 against what they actually are, that is wrong for 24 of them. Four dispositions: 11 required receipts with a HITL gate, 14 optional receipts surfaced at sign-off, 6 states of the world to verify rather than file, 6 that are already recorded inside a parent artifact or would be ceremony. Plus one CI mechanism (the risk:high sign-off belongs at the merge, not in a file) and one already fixed in the defect sweep. Six of the eleven required already exist as optional or recommended, so most of the work is promotion plus a gate, not new authorship. Four open questions for Matt at the end, including the two entries I am least sure about (the PO decision and tooling records, which are commercial artifacts that may belong in the contract rather than in .sdlc/). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014aesqvsMqJpzEdpDXDTjvF
Owner
Author
|
Closing: The copy on
So the branch predates the implementation it describes, and the four in-flight corrections that Nothing is lost by closing — the branch stays if anyone wants the earlier draft. |
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.
Proposal, not implementation. Nothing in Fix 3 is built yet — this is the triage you asked for first, and the four open questions at the end are what I need before starting.
Ships as a major version with a migration note, per your call.
The headline
Fix 3's instruction was "add an artifact spec and a registry entry for each of the 42." Having read all 42 against what they actually are, that would be wrong for 24 of them — and 42 new required files is a lot of scaffolding for a standard that warns scaffolding carrying human accountability should not grow carelessly.
Plus one CI mechanism and one already fixed. The arithmetic reconciles to 42 (two dispositions absorb two ledger rows each).
The test for A vs B: in an incident review, would you need to know whether this happened? If its absence would change the conclusion, it blocks.
Two findings worth your attention
Six of the eleven required artifacts already exist as optional or recommended entries. For those, Fix 3 is a promotion plus a HITL gate rather than new authorship — which materially shrinks the release.
The
risk:highsign-off is not an artifact. It is currently convention in a PR comment that nothing templates and nothing checks. A markdown receipt would sit in.sdlc/describing a merge that already happened; the check has to be at the merge. It becomes a required status check instead.Open questions
Four, at the end of the document. The one I am least sure about is whether the PO decision record and tooling record belong in A or B — they are SOW preconditions with billing teeth, which argues for A, but duplicating contract terms into
.sdlc/risks the file and the SOW disagreeing.Approval
Self-approved under the solo-maintainer carve-out. This is a proposal document; the work it describes has not started.
🤖 Generated with Claude Code
https://claude.ai/code/session_014aesqvsMqJpzEdpDXDTjvF