Repository navigation
Write the governing documents for their readers, not for the release campaign - #70
Merged
Merged
Conversation
…campaign RELEASE-CRITERIA, LIMITATIONS, COMPATIBILITY, docs/defects.md and the harness, conformance and soak READMEs named people and work-order IDs as owners, recorded who ruled what on a campaign thread, and told the reader to "record in the task" and check in "without waiting". None of that helps someone deciding whether to depend on W# or contributing to it. Ownership is now stated as what enforces a gate -- a CI job, a workflow, the repository owner, or maintainers -- and rulings as dated decisions. Part three of the criteria becomes a short issue map, because all nine issues it tracked are closed. Stale facts are corrected: #8 is fixed and guarded by the contributor-commands job, the four err_ffi_* cases are blessed, there are 68 rejection cases, and the signing decision is criterion 7's rather than 5's. docs/runtime-shared-flags.md becomes a design note with a Test section in place of a PR transcript. soak/subjects.tsv's second column names what writes the rows, and soak-report.sh labels it "written by:". No gate, threshold, severity definition, promise or decision changed; every gate script and its self-test still passes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VFShdAwiJBvpP7G13QUJdN
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.
This is a documentation pass. The goal is that everything outside
CLAUDE.mdis written for someone using or contributing to W#, not for the agents that ran the v1.0 campaign.What changed
Johnny,Mira,WLA-7, …) are gone fromRELEASE-CRITERIA-1.0.md,docs/defects.md,soak/, the workflows and the scripts. An owner is now a CI job, a workflow, the repository owner, or "maintainers". Each ruling is recorded as Decision (2026-09-26).contributor-commands, so the "fails today" text and thedefects.mdworkaround section are replaced.err_ffi_*conformance cases are blessed.COMPATIBILITY.mdnow states it.LIMITATIONS.mdlinks for its non-promises now point to theCOMPATIBILITY.mdsections that make them.docs/runtime-shared-flags.mdis now a design note for the flag words. Its PR transcript is replaced by a Test section that names the two regression tests and how to run them.tests/harness/README.md's soak procedure is written for a person running a detached window, not for an agent reporting to a task.soak/subjects.tsv's second column names what writes the rows, andsoak-report.shprints it aswritten by:. The column is display-only; nothing parses it.No gate, threshold, severity definition, promise or decision changed.
CLAUDE.mdis untouched.Checked
All exit 0 locally:
scripts/gate-table-check.sh: 13 of 15 rows held to the tree.soak-report-selftest.sh.check-doc-examples.sh.Label:
change:none, because nothing shipped changes.🤖 Generated with Claude Code
https://claude.ai/code/session_01VFShdAwiJBvpP7G13QUJdN
Generated by Claude Code