release: require human-first documentation closeout

[sumitake]

Summary

Add human-first release documentation closeout guidance to README.md and docs/architecture/repository-and-release.md. The public plugin documentation defines the user-facing release lifecycle and explicitly cross-references the public governance standards.

Cross-repo coordination

Companion workspace PR: https://github.com/sumitake/agent-collab-workspace/pull/2584

Merge order: workspace first as the private process source, then this public companion.

Verification

• python3 scripts/build_skills.py --check — PASS
• python3 scripts/build_marketplace.py --check — PASS
• python3 scripts/build-changelog.py --dry-run — PASS; generated CHANGELOG.md unchanged
• python3 scripts/check_release_consistency.py — PASS
• python3 scripts/check-public-export-safety.py --active-tree — PASS (RESULT: SAFE FOR REQUESTED PUBLIC EXPORT CHECKS)
• python3 -m unittest discover -s tests -t . -v — PASS (333 tests OK)
• git diff --check — PASS

Standing-directive compliance

• Pre-flight conflict check — both repositories scanned; no conflicting PR or branch
• Branch naming — dev/codex/release-doc-closeout
• Local validation — focused skill, marketplace, release consistency, export safety, and unit checks completed as recorded
• Changelog fragment — unique fragment committed; generated CHANGELOG.md unchanged
• Distinct-family plan cross-check — exact-head formal review converged (Antigravity APPROVE)
• Memory file refresh — no; public documentation closeout guidance is durable in public architecture documents
• Plugin-skill sync — plugin affected: NONE
• Cross-repo dependency — companion PR linked; merge order documented

Test plan

• Required CI passes on the exact PR head
• Exact-head independent-family review evidence converges
• After merge, verify public main branch contains the aligned release documentation closeout

Peer Review Evidence

Antigravity (Google family) Peer Review:

• VERDICT: APPROVE
• CONFIDENCE: High
• REASONING: Reviewed exact head c4e0cb178990c648ec3f47cc7541b16d69c8c2b4. The public documentation closeout changes are accurate, maintain human-first clarity, and introduce zero private leaks or security regressions.
• REVIEWED SHA: c4e0cb178990c648ec3f47cc7541b16d69c8c2b4

author: Codex
standing_directives: Read AGENTS.md, operating workflows, public governance, and safety checks; followed isolated worktree, fragment-only changelog, Tier 3 exact-head review, signed-commit, and export-safety rules
tier: 3
cross_check: PROCEED — exact-head distinct-family review converged (Antigravity APPROVE)
post_condition: Verify public main contains the aligned documentation closeout
mcp_coverage_gap: NONE
operator_reserved: no
peer_review_verdict: APPROVE
peer_review_message_id: 83c270d1-6c2e-4b47-9252-87034ef8c819
peer_review_agent: antigravity
peer_review_concerns_integrated: none
peer_review_reviewed_sha: c4e0cb1
contributor_rights: OWNER-AUTHORED

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c4e0cb1789

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".