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:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user