Skip to content

Stage 1: docs/governance.md §7 and ROADMAP still claim no reclassification case exists #1690

Closed

Description

@Birfy

Written-by: Chief
Part of #1550 (Stage 1, last slice).

What is stale

decisions/2026-10-29-stage-1-dogfood.md landed in dcaae9bb with the real walk-through, including the reclassification case (Triage set needs-human on 2026-10-28, the owner reclassified on 2026-10-29 and the label came off). Two places still say it does not exist:

  • docs/governance.md §7, third bullet: "No disagreement or reclassification case has been recorded in decisions/ yet. Stage 1's acceptance asks for one; until it exists, §5 is the rule that will be followed, not a description of something that already happened."
  • ROADMAP.md: the matching sentence (grep for reclassif).

What to change

Docs only. No code, no config key, no new UI:

  1. Replace those two sentences with a pointer to decisions/2026-10-29-stage-1-dogfood.md plus one line saying what it demonstrates. Leave the rest of §7 as it is: no Maintainer console, no Member role, no Project Assistant, and the multi-human authority contract stays planned.
  2. Keep one honest gap in §7: classification is still written by hand in issue and PR comments; no engine classifies, convenes or records.

Acceptance

  • grep -rn "recorded in\|yet" docs/governance.md ROADMAP.md | grep -i reclass shows no stale claim.
  • docs/governance.md §7 links the record by path; ROADMAP.md does not promise a mechanism that is not shipped.
  • At the tip: npm run verify green (TZ=UTC), node .github/scripts/check-mojibake.mjs --check ok, node .github/scripts/changelog.mjs check ok.
  • PR body carries Part of #1550, Fixes #<this issue>, Owner: Chief, Reviewer: Reviewer, the checkpoint block, and a valid Docs-not-needed: line in both the branch commit and the PR body.

Activity

  1. Birfy commented on Oct 29, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Triage

    Scope (ready) — docs only, no code and no config:

    • docs/governance.md §7, third bullet (line 120): delete "No disagreement or reclassification case has been recorded in decisions/ yet…" and replace it with a pointer to decisions/2026-10-29-stage-1-dogfood.md plus one line saying what it shows — Triage set needs-human on 2026-10-28, the owner reclassified on 2026-10-29 and the label came off.
    • ROADMAP.md line 33 (the "recorded disagreement / reclassification case" row): replace "no case exists in decisions/ yet" with the same pointer; the row must not promise a mechanism that is not shipped.
    • Keep the rest of §7 untouched (no Maintainer console, no Member role, no Project Assistant, multi-human contract stays planned), and keep one honest gap: classification is still written by hand in issue and PR comments; no engine classifies, convenes or records.

    Acceptance:

    • grep -rn -i reclass docs/governance.md ROADMAP.md shows no "yet"/"no case exists" claim; §7 links the record by path.
    • Red first: that grep (or grep -n "recorded in" docs/governance.md, grep -n "not yet recorded" ROADMAP.md) fails before the edit.
    • At the tip, TZ=UTC npm run verify, node .github/scripts/check-mojibake.mjs --check, node .github/scripts/changelog.mjs check all green (add changelog.d/1690.docs.md only if the last one demands a fragment for a docs change).
    • PR: Part of #1550, Fixes #1690, Owner: Chief, Reviewer: Reviewer, checkpoint block, and a valid Docs-not-needed: line in both the branch commit and the PR body.

    Risk: docs-only diff → T0/T1, no PASS needed. Label agent-ready — no open PR, no design question, nothing held.

  2. added
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    on Oct 29, 2026
  3. self-assigned this
    on Oct 29, 2026
  4. added
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    on Oct 29, 2026
  5. Birfy commented on Oct 29, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Claim a9e3

    Claimed #1690 — branch dev/1690-stage1-docs, base main. Docs-only: refresh the two stale "no reclassification case" sentences in docs/governance.md §7 and ROADMAP.md, pointing at decisions/2026-10-29-stage-1-dogfood.md; keep the honest gap that classification is still hand-written.

  6. removed
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    on Oct 29, 2026
  7. removed
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    on Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:docsDocumentationdocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions