spec(0062): resolve Q6 — every comment summons the machine while coediting; 'Stop editing with Claude' context-menu off switch (D10)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
BenStullsBets
2026-06-28 07:03:37 -07:00
parent aaf5fb46eb
commit 81b6891805
+9 -7
View File
@@ -329,7 +329,7 @@ Scenario: PUC-7 — enter (and leave) coediting mode (realizes INV-10)
When I run "Coedit this Document with Claude" (command, editor title, or context menu)
Then this document gains the Cowriting source-control entry, the annotation toggle, and machine-edit/comment-response behavior
And my other markdown documents are unaffected
And running "Stop Coediting" removes those surfaces (the saved sidecar is kept for next time)
And running "Stop editing with Claude" (context menu) removes those surfaces (the saved sidecar is kept for next time)
```
```gherkin
@@ -348,7 +348,8 @@ panel to wireframe. Described in text (source of truth):
- **Entering coediting.** A **"Coedit this Document with Claude"** command (command
palette, editor title menu, and editor/explorer context menu, markdown-gated)
turns the active document into a coedited document; a **"Stop Coediting"** command
turns the active document into a coedited document; a **"Stop editing with Claude"**
command — in the same command palette **and the editor/explorer context menu**
reverses it. A subtle status-bar item ("✦ Coediting") indicates when the active
document is in coediting mode. Until a document is entered, **none** of the
surfaces below attach to it (INV-10).
@@ -676,9 +677,10 @@ sequenceDiagram
- **Implementation:** gated on `isCoediting` (INV-10) — inert otherwise. The turn
runs with live progress (PUC-5). The reply is a machine `Comment`; an accepted
offer never edits the document directly, only proposes (INV-5). Whether *every*
comment fires a turn or only an explicit "Ask Claude" affordance on the thread is
open (§13-Q6).
offer never edits the document directly, only proposes (INV-5). **While the
document is in coediting mode, every new comment fires a turn (D10)** — the opt-in
mode is the control, so there is no per-comment gate; "Stop editing with Claude"
is the off switch.
#### PUC-5 — live machine progress
@@ -878,8 +880,7 @@ a bug reaches us as a tracker issue.
| Q2 | Per-change Keep/Undo: how far can the stable API go before falling back to per-hunk CodeLens? | Ben | PUC-2 build (last surface) |
| Q3 | One "Cowriting" SourceControl vs. QuickDiff-only (no full SCM viewlet entry) — how much SCM presence is wanted | Ben | PUC-1 build |
| Q4 | Does any need genuinely require a webview the native surfaces can't serve (INV-3 escape hatch)? | Ben | Per-surface build |
| Q5 | Authorship (human vs. machine) cannot live in the native diff (INV-11, verified). Which surface carries it — the annotated preview only, or **also** a decoration-based track-changes editor pane? | Ben | PUC-3 build / whether a track-changes editor is in scope |
| Q6 | Comment auto-response: should it run automatically on every new comment, or only when the writer's comment is phrased as a request / via an explicit "Ask Claude" affordance on the thread? | Ben | PUC-8 build |
| Q5 | Authorship (human vs. machine) cannot live in the native diff (INV-11, verified). Which surface carries it — the annotated preview only, a preview **plus** in-editor authorship decorations, or an **owned author-colored track-changes view** that replaces the native diff for review? | Ben | PUC-3 build / authorship-surface scope |
**Resolved**
@@ -894,6 +895,7 @@ a bug reaches us as a tracker issue.
| D7 | Coediting is opt-in per document | A document enters coediting via "Coedit this Document with Claude"; every surface gates on the active coediting set (INV-10), so other markdown files are never hijacked | 2026-06-27 |
| D8 | Comments can summon the machine | On a coedited doc, a comment fires a turn that replies in-thread + offers an edit → pending proposal (BUC-5, INV-5); inert on non-coedited docs | 2026-06-27 |
| D9 | Native diff is author-blind | Verified the diff editor has no per-author color API; authorship lives in the preview (and optionally a decoration track-changes editor), not the native diff (INV-11) | 2026-06-27 |
| D10 | Comment trigger | While a document is in coediting mode, **every** new comment summons the machine (no per-comment gate); coediting mode is the control, "Stop editing with Claude" the off switch | 2026-06-27 |
## 14. Glossary & References