Marks the family-reference agent sections - #214
Merged
Conversation
Records which of this repo's agent-facing sections the sibling repos copy, and whether each is copy-verbatim or adapt-per-repo, so their standardization beads can cite a written record instead of saying "copy statifier-ex's, adapted down". The custom gate stages - the gate guard, the ADR guard, the ADR judge, the regression ratchet, and gate.check with its guard ledger - are marked out of scope for copying, so the scaffolds' deliberately smaller gates stand. mix gate.verify is the one exception, on the user's 2026-08-22 ruling: it adds no stage to .quality.exs, and a repo without it has a broken unattended commit path. The authority section is the worked example of adapt-per-repo. This repo's grant is standing, three siblings' are consent-scoped, and copying either way would silently change a repo's authority level. Refs: st-i0qa
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.
Why
This repo is the de-facto reference for the family's agent-facing conventions,
but that status was implicit and the copies drift. Beads in the five sibling
repos currently say some version of "copy statifier-ex's, adapted down", which
is only safe if what to copy - and what not to - is written down here rather
than inferred by whoever reads the file next.
What
Adds
docs/family-reference.mdand pointsCLAUDE.mdat it from two places:the paragraph that already describes the
.claude/wurk/extension contract,and the read-before-deciding list.
The doc marks each agent-facing section copy-verbatim, adapt-per-repo,
or not reference, and says what an adopter must change:
distinction matters. This repo's grant is standing; statifier_persistence,
statifier_oban and opentelemetry_statifier hold a consent-scoped grant.
Copying verbatim in either direction would silently change a repo's
authority level. What is common is the structure: the per-action table, the
anti-inference paragraph, the two override paragraphs, the reversibility
principle, and the closing widening line.
deps/ex_quality/usage-rules.mdpointer -copy-verbatim; statifier-ui's copy is byte-identical today and that is the
correct state.
.claude/wurk/extension mechanism - adapt-per-repo. The contractis the reference; the per-repo count of override files is not, and should
not be levelled up to match.
the ADR judge, the regression ratchet, and
mix gate.checkwith its guardledger stay out of scope for copying, so the scaffolds' "deliberately
smaller than statifier-ex's gate" comments stand unreversed.
mix gate.verify- the one exception, adopted by px-591, sui-4py,sp-7cu, sob-ehl and ots-4l6. It adds no stage to
.quality.exs, so thesmaller-gate statement stays true; it reads nothing but ex_quality's own
report; and without it the wurk pipeline reports
attested: falseand thecommit skill refuses, which is a broken unattended commit path. The doc
records that it is being extracted upstream into ex_quality (st-wgr0), so
adopters should expect to collapse their copies later.
Notes
gate.rbreports the carve-out (applicable: false, nothingunder
lib/,test/,config/,mix.exs,mix.lock), butmix quality --profile mergewas run unconditionally per.claude/wurk/mr.mdand is green across every stage. The ADR judge skippedcleanly - no file in this diff is in a judged ADR scope.
using the public API.
statifier_persistence'sCLAUDE.mdonmainplus its request numbers, deliberately not as a commitSHA - two SHAs written down earlier in this standardization pass were
orphaned by non-fast-forward merges.
Closes st-i0qa