docs: add multi-client MCP genericisation TODO to preflight.md

Author: noelsaw1

experimental/preflight.md

@@ -76,5 +76,39 @@ Only include sections for things that are actually present. If MCP isn't connect
 
 ## Notes
 
-- This checklist helps you discover what's available — it does not change how you should behave. Tool usage guidance is in `~/bin/ai-ddtk/AGENTS.md`, which the user can add to their project's CLAUDE.md if they want it applied.
+- This checklist helps you discover what's available — it does not change how you should behave. Tool usage guidance is in `~/bin/ai-ddtk/AGENTS.md`, which the user can add to their project's `CLAUDE.md` (Claude Code) or `AGENTS.md` (Augment Code, OpenAI Agents) if they want it applied.
 - If AI-DDTK is not installed, disregard this checklist entirely and work with whatever tools are available in the current environment.
+
+---
+
+<!-- TODO: Multi-client MCP genericisation — delete this section when complete -->
+## TODO: Multi-client MCP generics
+
+Tracked here for visibility. Reference: VS Code full MCP spec blog post (June 2025) + analysis in chat.
+
+> **Context:** The MCP server itself is generic. The wiring/onboarding layer is Claude Code-first.
+> Goal: support VS Code Copilot, Augment Code, and Cursor without breaking Claude Code.
+
+### Phase 1 — Config portability
+
+- [ ] Add `tools/mcp-server/mcp-configs/vscode.json` template using VS Code Copilot schema (`"servers"` root key, `"type": "stdio"`)
+- [ ] Add `tools/mcp-server/mcp-configs/cursor.json` template (uses same `"mcpServers"` schema as Claude Code)
+- [ ] Retitle `.mcp.README.md` from "for Claude Code" to client-agnostic (e.g. "MCP Server Configuration")
+- [ ] Add VS Code Copilot setup instructions to `AGENTS.md` (alongside existing Claude Code / Augment Code sections)
+- [ ] Document the two config schemas side-by-side somewhere (`.mcp.json` vs `.vscode/mcp.json`)
+
+### Phase 2 — `wire-project` multi-client
+
+- [ ] Detect VS Code and write `.vscode/mcp.json` (VS Code Copilot format) in addition to `.mcp.local.json`
+- [ ] Detect Augment Code (`~/.augment/`) and offer to merge entry into `~/.augment/settings.json`
+- [ ] Detect Cursor (`~/.cursor/`) and write `~/.cursor/mcp.json`
+- [ ] Write `AGENTS.md` reference in addition to `CLAUDE.md` (Augment Code and OpenAI agents read `AGENTS.md`, not `CLAUDE.md`)
+- [ ] Add `--client` flag (e.g. `--client=vscode`, `--client=augment`, `--client=all`) for non-interactive use
+- [ ] Verify `.mcp.local.json` and `.vscode/mcp.json` are both gitignored in generated projects
+
+### Phase 3 — MCP server full-spec primitives (stretch)
+
+- [ ] Add MCP **Prompts** for common AI-DDTK workflows — these surface as slash commands in VS Code Copilot (`/mcp.ai-ddtk.preflight`, etc.)
+- [ ] Verify MCP **Resources** (`wpcc://latest-scan`, `auth://status/*`) render correctly in VS Code Copilot's resource browser
+- [ ] Evaluate MCP **Sampling** — allows the server to make LLM calls via the user's model subscription; useful for on-server triage/summarisation
+<!-- END TODO -->