Magento Spec & Standards (SSOT & MCP Server)

このリポジトリは、Magento 2.4.8-p5 / PHP 8.3 標準に関する集中知識ライブラリ (Single Source of Truth - SSOT) であり、MCP Server Stdio が統合されています。

このリポジトリにはプロセスやタスク/機能管理は含まれていません。この MCP Server は任意の Magento プロジェクトに接続でき、そのプロジェクトの AI エージェントが技術標準を参照できるようになります。

📌 構成

• config/ — 真実のソース:

  • constitution.md — PHP 8.3 および Magento コアの技術標準。

  • checklist.md — レビューゲートおよび完了条件の基準。

  • magento-patterns.md — 設計マップ (Plugin、Event、GraphQL、REST、管理画面...)。

  • references/ — 各コンポーネントの詳細なコード例ガイド。

  • glossary.md — Magento コア用語集。

• examples/ — トピック別のサンプルコードブループリント (examples/INDEX.md で選択)。

• src/index.js — MCP Server (stdio)。

Related MCP server: Coding Tools MCP

⚡ MCP Server 接続設定

Claude Code (すべてのプロジェクトで利用可能にするため、スコープ user 推奨):

claude mcp add magento-spec -s user -- node /path/to/spec/src/index.js

Cursor (~/.cursor/mcp.json)、Antigravity (~/.gemini/antigravity/mcp_config.json)、およびその他のクライアント:

{
  "mcpServers": {
    "magento-spec": {
      "command": "node",
      "args": ["/path/to/spec/src/index.js"]
    }
  }
}

SPEC_ROOT (環境変数) はオプションです。デフォルトではサーバーがリポジトリのルートディレクトリを自動的に取得します。リポジトリを別の場所に配置し、上書きしたい場合にのみ設定してください。

🛠️ MCP Tools 提供

🔄 AI エージェント推奨フロー

1. コード作成前: get_team_standards → Constitution + Checklist + Pattern index を読み込みます。

2. 実装時: get_pattern_reference / search_standards / read_spec_file でパターンを参照します（メモリからの推測は禁止）。

3. 完了報告前: get_review_gate → checklist.md の §12 レビューゲートを確認します。