Skip to content

Commit 6610002

Browse files
alicodingclaude
andauthored
docs: DoR gains the integration-surfaces triage (#175)
* chore: build config version follows v0.4.0 (release preflight parity) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FW5GkkAG8du7tNdYLk2SZd * docs: DoR gains the integration-surfaces triage -- ten explicit answers before a goal starts Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FW5GkkAG8du7tNdYLk2SZd --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent d76b57f commit 6610002

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

.claude/rules/delivery-discipline.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,42 @@ owner-mandated: "DoR should be industry standard").
2121
negotiates shared *team* capacity, which a solo-owner +
2222
agent-execution loop doesn't have.
2323

24+
## Definition of Ready, part 2 — the integration-surfaces triage
25+
26+
Owner-mandated (2026-08-16, after a day of live retrofits proved the
27+
gap: ⌘↑, ⌘-click, context menus, and palette scoping all arrived as
28+
catches on shipped features rather than with them). Before a
29+
capability's goal starts, answer EVERY line below explicitly in the
30+
goal file — "wired", "deliberately not, because …", or "follow-up
31+
goal NNNN" — never silence:
32+
33+
1. **Configure** — does it introduce a "which external thing" value
34+
(credential/endpoint/model/list)? → Configure entity + RefKind
35+
(architecture.md's business-vs-integration test).
36+
2. **Workflows** — is it composition-shaped (ADR-0035: node/trigger/
37+
connector)? → arrives as composition with a seeded example.
38+
3. **Atlas** — does it produce or reference knowledge a card should
39+
point at (a new artifact type, a mirrorable output)?
40+
4. **Settings** — does it need an app-level preference? (Kernel
41+
config only — a Settings toggle never implements a side effect.)
42+
5. **Keyboard shortcut** — is there a repeated action deserving a
43+
command-registry entry (surface-scoped via `surface` when it
44+
isn't global)?
45+
6. **Quick access** — palette entry (via the same command) and, for
46+
away-from-app entry points, a Quick Panel row.
47+
7. **Context menu** — does it render as a right-clickable object? →
48+
ContextMenuItem items, sharing commandIds so menu/palette/
49+
keyboard stay one source.
50+
8. **Contract/MCP** — does an agent need to see or drive it?
51+
9. **Mobile posture** — usable (or deliberately read-only) at the
52+
companion breakpoints and 44px targets?
53+
10. **Data stewardship** — does it write user data? → covered by
54+
export/backup/import paths.
55+
56+
The triage is a DoR gate, not a build mandate: most answers are one
57+
honest sentence. Retroactive coverage of already-shipped
58+
capabilities is goal 0076's audit, not ad-hoc.
59+
2460
## Definition of Done — before the checkbox flips and the file moves to archive/
2561
- Local lefthook suite green, never bypassed.
2662
- CI's `ci-gate` required check green on the **merged** PR (ADR-0034).

0 commit comments

Comments
 (0)