Skip to content

docs(design): Ward Gate 3 — add Non-goals section + reframe open question #4#421

Merged
BunsDev merged 1 commit into
mainfrom
docs/gate3-nongoals-2026-07-18
Jul 18, 2026
Merged

docs(design): Ward Gate 3 — add Non-goals section + reframe open question #4#421
BunsDev merged 1 commit into
mainfrom
docs/gate3-nongoals-2026-07-18

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 18, 2026

Copy link
Copy Markdown
Member

Follow-up to #420 (Ward Gate 3 coherence-review design).

What

Two edits to docs/design/ward-gate3-coherence.md:

  1. New Non-goals section immediately after the Summary. Codifies four properties as Ward-contract-level, not Gate 3 implementation choices:

    • Model-scored probes as gate inputs (advisory only, always)
    • Auto-approval on any probe score at any threshold (never)
    • Probe evidence as a substitute for the principal's read
    • Ward-side coherence policy (what 'coherent' means stays with the familiar, not the Ward)
  2. Open question chore(deps): bump portable-pty from 0.8.1 to 0.9.0 #4 rewritten — the old framing ("does auto-approval ever happen?") is now settled by Non-goals. The remaining live question is the presentation of model-scored probes when they arrive (separate advisory_probes block vs. per-entry kind: "advisory" marker) — a UX decision, not a policy one.

Why

The Gate 3 doc's strongest single design property is that the principal remains the sole approver, with probes advisory forever. That property was implicit — spread across §G3.2, §Compatibility, and open question #4. Making it a stated non-goal moves the constraint from implementation intent to contract: any future PR proposing auto-approval on a probe score is visibly out of scope at design-doc level, and relaxing it becomes an RFC-0001 amendment against familiar-contract rather than a Gate 3 tuning decision.

Same shape as WARD-C1–C6 in the two-compaction contract: name the invariants so drift is visible at review time.

Non-changes

Verification

  • git diff clean, 33 insertions / 4 deletions, one file.
  • Gitleaks scan passed on commit.
  • Doc still parses as valid Markdown with intact front-matter.

🌿

#4

Adds a stated Non-goals section immediately after the Summary of the
Gate 3 coherence-review design, and rewrites open question #4 to match.

Non-goals codify four properties as Ward-contract-level, not Gate 3
implementation choices:

- Model-scored probes as gate inputs (advisory only, always)
- Auto-approval on any probe score at any threshold (never)
- Probe evidence as a substitute for the principal's read
- Ward-side coherence policy (what 'coherent' means stays with the
  familiar, not the Ward)

Open question #4 is reframed from 'does auto-approval ever happen'
(now settled: no) to 'how are model-scored probes presented as
advisory evidence when they arrive' — a presentation decision, not
a policy one.

Rationale: preserves Gate 3's design property that the principal is
the sole approver across future probe-mechanism changes; any relaxation
becomes an RFC-0001 amendment, visible at spec-review time.
Copilot AI review requested due to automatic review settings July 18, 2026 09:21

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR refines the Gate 3 coherence-review design doc by making key “principal remains the sole approver” constraints explicit at the contract level, and by reframing an open question away from auto-approval policy toward future probe presentation/UX.

Changes:

  • Adds a Non-goals section to codify Ward-contract-level invariants (e.g., probes remain advisory; no auto-approval).
  • Rewrites Open question #4 to focus on how future model-scored probes should be presented (separate block vs per-entry marker).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +31 to +34
- **Model-scored probes as gate inputs.** Probes at Gate 3 may become
model-scored in a later version, but their role remains advisory: they
inform the principal's decision, they never gate the transition from
*held* to *applied* on their own.
Comment on lines +40 to +43
- **Probe evidence as a substitute for the principal's read.** Probes surface
what a deterministic check can see (parse, size delta, protected-region
touch, pattern lint). They do not summarize intent, drift risk, or
identity coherence — those remain the principal's judgment.
@BunsDev
BunsDev merged commit e83cca7 into main Jul 18, 2026
18 checks passed
@BunsDev
BunsDev deleted the docs/gate3-nongoals-2026-07-18 branch July 18, 2026 09:55
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