Skip to content

chore(framework): stop shipping .mcp.json, recommend MCP servers in README#263

Merged
blafourcade merged 1 commit into
mainfrom
chore/remove-shipped-mcp-recommend-cli
Jun 12, 2026
Merged

chore(framework): stop shipping .mcp.json, recommend MCP servers in README#263
blafourcade merged 1 commit into
mainfrom
chore/remove-shipped-mcp-recommend-cli

Conversation

@blafourcade

@blafourcade blafourcade commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

🎯 What & why

Plugins shipped disabled placeholder .mcp.json files that added no value and pushed MCP config users never asked for. This removes them and instead documents which MCP servers we recommend, steering users toward the CLI where one exists.

🛠️ How it works

  • Deleted plugins/aidd-dev/.mcp.json (figma, playwright) and plugins/aidd-pm/.mcp.json (atlassian). .mcp.json stays a supported plugin surface, just no longer shipped, so users add their own.
  • Added a Recommended MCP servers section in README.md:200: a table of GitHub, Atlassian, Playwright, Figma, Notion with official MCP endpoints + CLI alternatives.
  • Verdict column is CLI-when-it-exists (gh, acli, playwright), MCP only where no CLI covers the service (Figma design data, Notion). Every endpoint was checked against the vendor's official docs.
  • Note leads with "prefer the CLI over MCP" (MCP loads its full schema each turn, bloats context) and "verify your sources before installing".

🧪 How to verify

  • ls plugins/aidd-dev/.mcp.json plugins/aidd-pm/.mcp.json → both absent.
  • Open README.md:200, confirm the note + 5-row table render.
  • Spot-check the MCP / CLI links resolve to official sources.

⚠️ Heads-up

Counts and CATALOG are untouched on purpose. This PR adds no skills, so it stays off the skill-generate work in flight on main.

✅ I certify

  • I DO CERTIFY I READ EACH LINE OF THE PULL REQUEST BECAUSE I AM A SOFTWARE ENGINEER, NOT A AI PUPPY.

@blafourcade blafourcade requested a review from alexsoyes June 12, 2026 07:18
@blafourcade blafourcade self-assigned this Jun 12, 2026
@blafourcade blafourcade added the enhancement New feature or request label Jun 12, 2026
@blafourcade blafourcade marked this pull request as ready for review June 12, 2026 07:19
@blafourcade blafourcade requested a review from a team as a code owner June 12, 2026 07:19
…EADME

Remove the disabled placeholder .mcp.json files from aidd-dev (figma,
playwright) and aidd-pm (atlassian). The framework no longer ships MCP
configs; .mcp.json remains a supported plugin surface that users add
themselves.

Add a 'Recommended MCP servers' section to the root README with a
fact-checked table (GitHub, Atlassian, Playwright, Figma, Notion) and
guidance to prefer the CLI over MCP for context efficiency, and to
verify sources before installing.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Signed-off-by: Baptiste LAFOURCADE <[email protected]>
@blafourcade blafourcade force-pushed the chore/remove-shipped-mcp-recommend-cli branch from bddc30d to 6b7f859 Compare June 12, 2026 07:20
@blafourcade blafourcade merged commit e602fa0 into main Jun 12, 2026
10 checks passed
@aidd-bot aidd-bot Bot mentioned this pull request Jun 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants