docs: Update MCP tools docs for iteration 2 (30 verbs, 6 namespaces) [doc-updater] - #1990
Conversation
Update four docs that still referenced the old iteration-1 verb count (15) and namespace set (5) after #1981 shipped 12 additional verbs and the checkpoint namespace. - docs/index.md: 15 iteration-1 verbs → 30 verbs across 6 namespaces - sandbox/agent-config/rules/environment.md: same; add egg-checkpoint to prefer list - sandbox/agent-config/rules/README.md: add mcp__checkpoint__* to namespace list - docs/guides/sdlc-pipeline.md: 15-verb → 30-verb; update iter-2 status note (peer-read, checkpoint, overseer-alert, task-gap shipped; anchor deferred to iter-3)
![egg-reviewer[bot]](https://avatars.githubusercontent.com/u/8340608?s=60&v=4){kind=small}
There was a problem hiding this comment.
No agent-mode design concerns.
Documentation-only change updating verb counts (15 → 30) and namespace lists (adding mcp__checkpoint__*) across four files to reflect iteration-2 MCP tools shipped in #1981. No prompts, workflows, or code affected.
— Authored by egg
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Documentation-only PR updating four files to reflect the iteration-2 MCP tool surface (30 verbs across 6 namespaces). Verified all claims against the source of truth (docs/reference/agent-tools.md):
- Verb count: 30 total (sdlc:5, brc:10, phase:3, progress:5, task:4, checkpoint:3) — confirmed by the reference doc and its drift-gate assertion (
len(TOOL_REGISTRY) == 30). - Namespace list: All 6 namespaces correctly listed in every updated file, including the new
mcp__checkpoint__*. - Iteration-2 shipped verbs (sdlc-pipeline.md): peer-read, checkpoint, overseer-alert, task-gap, and additional contract/phase verbs — all confirmed present in the tool registry.
- Anchor deferral: Confirmed deferred to iteration 3 per
agent-tools.md:421-426. - CLI additions:
egg-checkpointcorrectly added to the "shell out to" lists alongsideegg-contract/egg-orch.
Changes are internally consistent across all four files.
Non-blocking suggestion
docs/releases/agent-mcp-tools.md:114 still says "full 15-verb surface" while linking to agent-tools.md, which now documents 30 verbs. The rest of the release note is fine as historical context (lines 10, 106 correctly describe iteration-1 scope), but line 114's cross-reference could confuse a reader following the link. Consider updating it to something like "full tool surface (15 iteration-1 verbs; see the reference for the current inventory)".
— Authored by egg
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Agreed. Updated docs/releases/agent-mcp-tools.md:114 cross-reference from "full 15-verb surface" to "full tool surface (15 iteration-1 verbs; see the reference for the current inventory)" — fixed in b64db0e.
— Authored by egg
There was a problem hiding this comment.
No agent-mode design concerns.
Re-review delta: single commit (b64db0e) fixing a stale "15-verb" cross-reference in docs/releases/agent-mcp-tools.md:114 per previous review feedback. Documentation-only change, no agent-mode impact.
— Authored by egg
There was a problem hiding this comment.
Re-reviewed at commit b64db0e.
Delta since last review (6274fc0): Single new commit fixing the stale "15-verb surface" cross-reference in docs/releases/agent-mcp-tools.md:114, as suggested in the previous review.
Previous feedback addressed
The non-blocking suggestion to update the cross-reference in the release notes has been properly fixed. The new text — "full tool surface (15 iteration-1 verbs; see the reference for the current inventory)" — preserves the historical context while directing readers to the current 30-verb reference doc.
Verification
- All "15-verb" references outside
.egg-state/pipeline artifacts are now either updated (this PR) or correctly scoped to iteration-1 historical context (release notes lines 106-107). docs/reference/agent-tools.mdconfirms 30 verbs, 6 namespaces, and anchor deferral to iteration 3 — all consistent with the PR's claims across all 5 files.- No new issues introduced.
No blocking issues.
— Authored by egg
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
| egg is addressing review feedback... |
|
egg feedback addressed. View run logs 5 previous review(s) hidden. |
…[doc-updater] (#1990) * docs: Update MCP tools docs for iteration 2 (30 verbs, 6 namespaces) Update four docs that still referenced the old iteration-1 verb count (15) and namespace set (5) after #1981 shipped 12 additional verbs and the checkpoint namespace. - docs/index.md: 15 iteration-1 verbs → 30 verbs across 6 namespaces - sandbox/agent-config/rules/environment.md: same; add egg-checkpoint to prefer list - sandbox/agent-config/rules/README.md: add mcp__checkpoint__* to namespace list - docs/guides/sdlc-pipeline.md: 15-verb → 30-verb; update iter-2 status note (peer-read, checkpoint, overseer-alert, task-gap shipped; anchor deferred to iter-3) * docs: Fix stale 15-verb cross-reference in release notes (review feedback) --------- Co-authored-by: jwbron <8340608+jwbron@users.noreply.github.com> Co-authored-by: egg-reviewer[bot] <261018737+egg-reviewer[bot]@users.noreply.github.com>
1 participant
Update documentation to reflect changes from b701c50 (Ship iteration 2 MCP tools: 12 new verbs + rule-doc drift gate, #1981):
docs/index.md: "15 iteration-1 verbs" → "30 verbs across 6 namespaces"; addmcp__checkpoint__*to namespace listsandbox/agent-config/rules/environment.md: same count/namespace fix; addegg-checkpointto the "Prefer these tools over…" notesandbox/agent-config/rules/README.md: addmcp__checkpoint__*andegg-checkpointto the agent-tool preambledocs/guides/sdlc-pipeline.md: update 15-verb → 30-verb, update the iter-2 shipped/deferred note (peer-read, checkpoint, overseer-alert, task-gap, contract/phase verbs shipped; anchor deferred to iter-3)docs/reference/agent-tools.mdwas already updated in the same PR that shipped the code.Triggered by: #1981
Authored-by: egg