You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 223503a
Browse filesBrowse the repository at this point in the historyBrowse files
- S3 defines a per-workspace validate aggregated at the root; each CI
matrix leg gates only its own package
- local-dev and the boot smoke cover each server's implemented transports
(stdio for all; Streamable HTTP only for everything)
- DCO is deferred to the S6 maintainer decision, not N/A
- Part numbers match the retitled issues (#4472 is Part 13)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Copy file name to clipboardExpand all lines: docs/agent-guidance-inception.md
+16-11Lines changed: 16 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -105,10 +105,10 @@ The **Sub-issue** column points into [§9](#9-proposed-sub-issues).
105
105
|`board-ops`|`gh project` recipes for two boards; ID tables; resolving option IDs by name; the option-deletion hazard and its recovery | Adapt | One board, #43. Its fields: Status (with **Incoming**), Priority, Size. Hazard and recovery copy unchanged | S5 |
106
106
|`issue-create`| Five-step create flow: version label, type label, milestone, card, Status + Priority; duplicate check across all states | Adapt | Version label is always `v2`. Add a **server-scope label** step (`server-<name>`). Milestone = nearest due v2.x | S5 |
107
107
|`issue-triage`| Two-pass sweep (board as Incoming, then human approval), priority rubric with a score comment, 12-check board audit | Adapt | The **highest-leverage skill here** given the inflow (§3.4). Add spam/registry-redirect classes, server-scope labelling, and outside-PR triage | S7 |
108
-
|`pr-flow`| Assign + In Progress, branch naming, DCO signoff, screenshots, `Closes #N`, `addCloseIssueReferences`, In Review, Copilot loop to exhaustion, per-thread replies, manual close-out | Adapt | Board #43; branch `v2/<type>/<N>-<slug>`. **DCO: N/A**, since no DCO app is installed here (§10). **Screenshots → client evidence**: for a server-facing change, Inspector and LLM-client transcripts in both spec eras; otherwise a targeted probe (§3.2). The Copilot loop copies unchanged | S6 |
108
+
|`pr-flow`| Assign + In Progress, branch naming, DCO signoff, screenshots, `Closes #N`, `addCloseIssueReferences`, In Review, Copilot loop to exhaustion, per-thread replies, manual close-out | Adapt | Board #43; branch `v2/<type>/<N>-<slug>`. **DCO: deferred** to a maintainer decision in S6 (§10). No DCO app is installed here, and the recommendation is not to adopt one. **Screenshots → client evidence**: for a server-facing change, Inspector and LLM-client transcripts in both spec eras; otherwise a targeted probe (§3.2). The Copilot loop copies unchanged | S6 |
109
109
|`pre-push-gate`| Running `local:gate`; diagnosing each stage | Adapt | Rewrite around our stages: TS workspaces, Python per server, per-file coverage both sides | S10 |
110
110
|`project-structure`| Where a file goes; who owns what | Adapt | Per-server layouts (e.g. `everything`'s `tools/`, `resources/`, `prompts/`, `transports/`) | S11 |
111
-
|`local-dev`| Install/run each client; dependency-placement reasoning | Adapt | Workspaces + `uv`; running each server over stdio / Streamable HTTP; `npx`/`uvx` local builds | S11 |
111
+
|`local-dev`| Install/run each client; dependency-placement reasoning | Adapt | Workspaces + `uv`; running each server over the transports it implements (stdio for all seven; `everything` also serves SSE and Streamable HTTP); `npx`/`uvx` local builds | S11 |
112
112
|`testing`| Test placement, commands, tiers, coverage gate, `renderWithMantine`| Adapt | In-process protocol harness (`Client` ↔ server over in-memory transport; `ClientSession` for Python), per #4854/#4855| S11 |
113
113
|`test-servers`| Picking and running the Inspector's fixture MCP servers | Adapt | Inverted: here the servers are the product. The equivalent is **driving a server with a client**: Inspector V2 (web/CLI) and an LLM client, in both spec eras (#4857). Proposed name: `client-smoke`| S11 |
114
114
|`release`| Name-only. Two PRs (audit + bump on `v2/main`; milestone merge to `main`), a ledger artifact, then a human-published GitHub Release | Adapt | Two registries, per-package versions, CalVer (Py) vs semver/changesets (TS, #4472), `release` environment approvals | S12 |
@@ -133,7 +133,7 @@ The **Sub-issue** column points into [§9](#9-proposed-sub-issues).
133
133
|`verify:dep-lockstep`| One version per install-crossing dependency across 5 installs | N/A | One workspace lockfile for TS; each Python server has its own `uv.lock` and its own deps by design | — |
134
134
|`verify:install-fresh`|`node_modules` matches its lockfile | N/A | Single workspace install; `npm ci` in CI already enforces it | — |
135
135
|`verify:bundle-externals` / `verify:build-gate`| Bundler guards for tsup/Vite output | N/A | Servers compile with plain `tsc`| — |
136
-
|`smoke:*` (launcher/cli/tui/web/engines), `local:storybook`| Built-artifact smokes of the three clients | Adapt | Inverted: a **stdio + Streamable HTTP boot smoke per server**, from the built `dist/` (TS) and console script (Py): connect, list, call one tool. Only a thin spawn test, per #4854/#4855| S10, S11 |
136
+
|`smoke:*` (launcher/cli/tui/web/engines), `local:storybook`| Built-artifact smokes of the three clients | Adapt | Inverted: a **boot smoke per server over each transport it implements** (stdio for all; Streamable HTTP for `everything`), from the built `dist/` (TS) and console script (Py): connect, list, call one tool. Only a thin spawn test, per #4854/#4855| S10, S11 |
137
137
|`pack:verify` (`pack-and-verify.mjs`) | Installs the exact publish tarball into a throwaway consumer and runs the bin | Adapt | Per package: `npm pack` → install → `npx` boot; `uv build` → install wheel → console-script boot | S12 |
138
138
|`install-clients.mjs`, `install-smoke-browser.mjs`, `run-engine-smokes.mjs`, `docker-healthcheck.mjs`| Inspector-specific install/browser/Docker helpers | N/A | No non-workspace installs, browsers or Docker healthcheck. Our Dockerfiles aren't published by CI | — |
139
139
@@ -371,7 +371,7 @@ Facts discovered while writing this doc. Each is owned by a sub-issue.
371
371
372
372
## 9. Proposed sub-issues
373
373
374
-
The sub-issues now exist under #4858. The S-ids used throughout this doc map to them as follows. #4472 sits in Wave 5, between S11 and S12.
374
+
The sub-issues now exist under #4858. The S-ids used throughout this doc map to them as follows. #4472 sits in Wave 5, between S11 and S12, as Part 13.
375
375
376
376
| Id | Issue | Title prefix |
377
377
| --- | --- | --- |
@@ -386,8 +386,8 @@ The sub-issues now exist under #4858. The S-ids used throughout this doc map to
386
386
| S9 |#4870| Part 10 |
387
387
| S10 |#4871| Part 11 |
388
388
| S11 |#4872| Part 12 |
389
-
| S12 |#4873| Part 13|
390
-
| S13 |#4874| Part 14|
389
+
| S12 |#4873| Part 14|
390
+
| S13 |#4874| Part 15|
391
391
392
392
Each targets **`v2/main`**, carries the `v2` label and a milestone, and sits on
393
393
the Servers V2 board (#43). "After" means the listed issue must merge first.
0 commit comments