Revise README for clarity and structure - #85
Conversation
Updated the README to clarify the repository's purpose and contribution guidelines.
axis-marbell
left a comment
There was a problem hiding this comment.
Please correct two authoritative README facts before merge: governance/releases/current.yaml declares v0.159.0, not v0.160.0, and it lists 202 accepted claim IDs; governance/claims.yaml independently has 202 review: accepted entries, not 207. Update the heading and count to match those canonical sources (or include the separately governed release transaction that makes newer values true). The remaining README-only diff is clean, and exact-head repository validation passed.
axis-marbell
left a comment
There was a problem hiding this comment.
Approved on updated head cf6b8c2. I retract my prior change request: it came from reading canonical files in an unrelated local campaign worktree. Exact-base reads from origin/main confirm v0.160.0 and 207 accepted claims, matching the README. The complete README-only diff was inspected, git diff --check is clean, and exact-head repository-validation passed.
Updated the README to clarify the repository's purpose and contribution guidelines.
Objective and issue
Describe the positive deliverable and the smallest coherent merge boundary.
Canonical issue:
Issue relationship:
Authoring agent:
Intended independent merger:
Change classification
Authority and scope
Base release and commit:
Accepted claims and canonical sources used:
Declared imports, assumptions, and conventions:
Files or concerns intentionally out of scope:
New or materially changed public interfaces:
An exported symbol is not accepted scientific authority by itself. For every
conditional unpromoted API, state its explicit inputs, assumptions, exclusions,
and why it is still independently reusable.
Unit-level disposition
List the smallest coherent units. A mergeable unit must remain useful and true
without relying on an unearned headline claim.
Answer each decision independently:
Verification and sensitivity
List exact commands and results. Include the claim-appropriate oracle,
mutations or counterexamples, numeric refinement and independent route when
applicable, and affected consumer replay. A pass tally by itself is not enough.
GitNexus impact
Record index freshness, pre-change symbol/API impact when applicable, and final
diff change detection. For documentation-only work, state that no graph-mapped
symbol or process was expected or found.
Memory, governance, and generated state
Durable contract or decision entry:
Proposal/campaign/claim/release changes:
Generated outputs and synchronization commands:
Debt remaining inside the proposed merge unit:
Campaign frontier outside this merge unit:
Validation boundary
Mark a nonapplicable scientific row
N/Aand explain why in the verificationsection; do not claim it passed. An additive public export may stay scoped when
impact analysis shows a bounded sector, no changed existing contract, known
consumers, and targeted API coverage. Record that rationale rather than treating
the export alone as a full-suite trigger.
scripts/validate.sh --pytest-scope ...passes with the exact selectors recorded,--fixed-onlyis justified by no affected pytest scope, or the full-suite trigger is explained andscripts/validate.sh --fullpasses; PR CI'sscripts/validate_changed.pydecision agrees.git diff --checkpasses in a separate invocation.Author handoff
State what the reviewer should independently reproduce, the riskiest assumption,
and the next decisive action if this PR advances rather than completes the goal.
Reviewer disposition
Review the actual head commit and complete this section or provide the same
fields in a formal review.
Canonical issue predates PR:
Authoring or implementing agent:
Distinct merger:
Artifact merge:
Claim promotion:
Goal completion:
Merge as written:
Refactor or harvest:
Leave in PR history:
Source PR lifecycle:
Terminal-close evidence:
Next decisive action:
Head branch disposition:
Reviewer checks