docs: add Phase 8C MCP design-only plan#7
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces a design-only document, docs/PHASE8C_MCP_DESIGN_ONLY.md, which outlines candidate Model Context Protocol (MCP) concepts for future CompText and sparkctl operating-layer work. The feedback identifies several hallucinated URLs pointing to developers.openai.com/codex/... and suggests replacing them with correct official sources, such as modelcontextprotocol.io and Anthropic's documentation, or internal references.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| - `https://developers.openai.com/codex/app` | ||
| - `https://developers.openai.com/codex/app/worktrees` | ||
| - `https://developers.openai.com/codex/app/local-environments` | ||
| - `https://developers.openai.com/codex/app/review` | ||
| - `https://developers.openai.com/codex/app/automations` | ||
| - `https://developers.openai.com/codex/app/computer-use` | ||
| - `https://developers.openai.com/codex/app/commands` | ||
| - `https://developers.openai.com/codex/app/windows` | ||
| - `https://developers.openai.com/codex/permissions` | ||
| - `https://developers.openai.com/codex/rules` | ||
| - `https://developers.openai.com/codex/hooks` | ||
| - `https://developers.openai.com/codex/guides/agents-md` | ||
| - `https://developers.openai.com/codex/mcp` | ||
| - `https://developers.openai.com/codex/plugins` | ||
| - `https://developers.openai.com/codex/skills` | ||
| - `https://developers.openai.com/codex/concepts/subagents` |
There was a problem hiding this comment.
The listed URLs point to https://developers.openai.com/codex/..., which appears to be a hallucinated domain/path structure. Model Context Protocol (MCP) is an open standard created by Anthropic, and its official documentation is hosted at https://modelcontextprotocol.io. Similarly, concepts like 'Computer Use' are Anthropic-specific features (typically documented under docs.anthropic.com).
If 'Codex' refers to a local/proprietary desktop application or internal tool, these links should point to the internal repository documentation or the correct internal domain rather than openai.com. Please update these references to point to their actual official or internal sources.
| - `https://developers.openai.com/codex/app` | |
| - `https://developers.openai.com/codex/app/worktrees` | |
| - `https://developers.openai.com/codex/app/local-environments` | |
| - `https://developers.openai.com/codex/app/review` | |
| - `https://developers.openai.com/codex/app/automations` | |
| - `https://developers.openai.com/codex/app/computer-use` | |
| - `https://developers.openai.com/codex/app/commands` | |
| - `https://developers.openai.com/codex/app/windows` | |
| - `https://developers.openai.com/codex/permissions` | |
| - `https://developers.openai.com/codex/rules` | |
| - `https://developers.openai.com/codex/hooks` | |
| - `https://developers.openai.com/codex/guides/agents-md` | |
| - `https://developers.openai.com/codex/mcp` | |
| - `https://developers.openai.com/codex/plugins` | |
| - `https://developers.openai.com/codex/skills` | |
| - `https://developers.openai.com/codex/concepts/subagents` | |
| - https://modelcontextprotocol.io | |
| - https://docs.anthropic.com/en/docs/build-with-claude/computer-use | |
| - Internal Codex App Reference (docs/placeholder.md) |
Summary
Adds a docs-only Phase 8C MCP design plan for the CompText / Codex operating layer.
This PR defines review-gated MCP concepts only. It does not activate MCP, install plugins, enable hooks, register global skills, run provider/model calls, or mutate runtime/source artifacts.
Scope
Added:
docs/PHASE8C_MCP_DESIGN_ONLY.mdCovers:
.mcp.jsonor.codex/**changesExplicit non-goals
This PR does not:
.mcp.json.codex/**.agent/skills/**AGENTS.mdREADME.mdValidation
Local:
git diff --check origin/main...HEADgit diff --stat origin/main...HEADExpected diff:
Review status
Draft PR. Keep draft until review confirms:
.mcp.json,.codex/**, plugin, hook, skill, or automation activation