feat(mcp-server): MCP knowledge + tool/resource-contract step (PR2: content)#469
Merged
Conversation
Introduces content/pipeline/specification/mcp-tool-resource-contract.md — a document-creating specification step that defines MCP tool, resource, and prompt contracts, modelled exactly on api-contracts.md (order 835, slots after api-contracts at 830 and before review-api at 840). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…SON-Schema sources
…ject MCP knowledge via overlay - B2: add mcp-tool-resource-contract (enabled: false) to specification phase in all three presets (deep.yml, mvp.yml, custom-defaults.yml) so it is known and warning-clean; the overlay enables it for mcp-server projects - B4: expand mcp-server-overlay.yml — enable mcp-tool-resource-contract (if-needed) via step-overrides; add knowledge-overrides section injecting all 12 mcp-server knowledge entries into 13 pipeline steps across foundation, architecture, specifications, quality, and reviews phases - Fix: extend mcp-transport-patterns.md and mcp-versioning.md to meet 100-line minimum (transport: 89→122, versioning: 88→115); content is substantive (lifecycle/error table, testing pattern; backwards-compatibility checklist, serverInfo versioning guidance) - Fix: add docs/mcp-contract.md to implementation-plan reads + Inputs section, resolving the unconsumed-output eval (analogous to how api-contracts.md feeds implementation-plan) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…metry with operations)
…; avoided guide-regen conflict between build-freshness-reference and guides --build)
…ries (278 entries, 20 categories)
…G for PR2 - README: 267 → 278 entries, nineteen → twenty categories, mcp-server added to all three category lists (line 32 key-concepts, line 1554 knowledge-system section, line 1784 content-tree comment) and overlay table row updated with entry count. - CHANGELOG: new [Unreleased] entry covering mcp-server project type, --mcp-* CLI flags, mcp-server-overlay.yml, content/knowledge/mcp-server/ (12 entries), and mcp-tool-resource-contract pipeline step. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ream steps; changelog phase; reads field; README category counts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rrect CHANGELOG config values Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…yer not the step; note README count reconciliation
…ror per SEP-1303); pipeline count 90; dedupe overlay knowledge; README overlay-table counts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…0, 90, 12) across CLAUDE.md, README, project-structure
…0, freshness-guide diagram 90 steps)
# Conflicts: # CHANGELOG.md
1 task
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Second of two PRs for the
mcp-serverproject type (PR1 #457 registered the type; merged). PR2 adds the MCP-specific depth, per the plan indocs/superpowers/plans/2026-05-30-mcp-server-project-type.md:mcp-tool-resource-contract(content/pipeline/specification/) — an MCP tool/resource/prompt contract spec analogous toapi-contracts; registeredenabled: falsein deep/mvp/custom-defaults presets andenabled: truein the overlay.content/knowledge/mcp-server/— 12 entries (protocol fundamentals, tool/resource/prompt design, transports, SDK selection, auth, error handling, testing, deployment, observability, versioning), verified against the MCP 2025-06-18 spec.mcp-server-overlay.ymlnow injects the 12 entries across 13 pipeline steps (tech-stack, system-architecture, api-contracts, security, operations, tdd, reviews, etc.) and enables the new step.tests/evals/mcp-server-overlay-content.batskeyword checks.mcp-servercategory) + CHANGELOG; regenerated knowledge-freshness guide.Built via subagent-driven development (B1–B6), each task reviewed.
make check-allgreen (3287 vitest + lint/tsc/bats/mmr/guides/citation gates).Test Plan
make check-allgreencheckjob passes