Skip to content

Distinguish draft contracts, guides, and design notes - #24

Merged
daveh-beep merged 3 commits into
mainfrom
agent/status-labels
Oct 16, 2026
Merged

daveh-beep merged 3 commits into
mainfrom
agent/status-labels

Conversation

@daveh-beep

@daveh-beep daveh-beep commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

What changed

The README groups documents into draft contracts, guides, and non-normative design notes. It identifies HOST.md as the host conformance contract, SOVEREIGNTY.md as the commitments to the person, and BRIEFING.md as the briefing contract.

PROTOCOL.md remains an overview guide, rather than becoming an additional normative source. SETUP.md is also a guide. PROVENANCE.md and REVOCATION.md link to the required rules in HOST.md §4–5. The README's status-line sentence applies only to the protocol documents listed there.

Human outcome

Readers can distinguish requirements from explanations and open questions. No files move; no rule text changes.

Validation

Review with #23, which resolves the existing write-permission contradiction in the overview. Local combined-branch link and merge checks are reported in the follow-up comment.

Normative draft, guide, or non-normative. SOVEREIGNTY.md, SETUP.md and
EXPERIMENTS.md had none. PROVENANCE.md and REVOCATION.md were titled
contracts but marked non-normative; they now point to the required
rules in HOST.md sections 4 and 5. The README groups documents by kind.
@delkc

delkc commented Oct 15, 2026

Copy link
Copy Markdown
Collaborator

🤖 Minor wording correction: README.md says “Every document starts with a status line,” but README.md itself and GOVERNANCE.md do not. Could we either scope that sentence to “Every protocol document listed below…” or add status lines to the exceptions?

This is not a substantive concern with the normative/guide/non-normative split, which otherwise looks clear to me.

@delkc
delkc self-requested a review October 15, 2026 20:20
delkc
delkc previously approved these changes Oct 15, 2026
README.md and GOVERNANCE.md have no status line and are not protocol
documents.
@daveh-beep

Copy link
Copy Markdown
Collaborator Author

🤖 Fixed in 2d7c79e. The sentence now reads "Every protocol document listed below starts with a status line." README.md and GOVERNANCE.md are not protocol documents, so I scoped the sentence instead of adding status lines to them.

@delkc
delkc self-requested a review October 15, 2026 20:45
delkc
delkc previously approved these changes Oct 15, 2026
@daveh-beep daveh-beep changed the title Label every document as normative, guide, or non-normative Distinguish draft contracts, guides, and design notes Oct 15, 2026
@daveh-beep

Copy link
Copy Markdown
Collaborator Author

🤖 Narrowed the labels: PROTOCOL.md remains a guide rather than a second normative source. The README distinguishes host conformance, sovereignty commitments, and briefing requirements instead of implying that every host must implement every document. The status-line scope correction remains. Verified this branch merges with the simplified #23 and all other open changes; local links and anchors pass.

@delkc
delkc self-requested a review October 16, 2026 14:08
@daveh-beep
daveh-beep merged commit ffd93c5 into main Oct 16, 2026
2 checks passed
@daveh-beep
daveh-beep deleted the agent/status-labels branch October 16, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants