Magento Spec & Standards (SSOT & MCP Server)

Этот репозиторий является Центральной библиотекой знаний (Single Source of Truth - SSOT) по стандартам Magento 2.4.8-p5 / PHP 8.3, со встроенным MCP Server Stdio.

Этот репозиторий не содержит процессов или управления задачами/функциями. Вы можете подключить этот MCP Server к любому проекту Magento, чтобы AI Agent в этом проекте мог обращаться к техническим стандартам.

📌 Структура

• config/ — Источник истины:

  • constitution.md — Технические стандарты PHP 8.3 и Magento core.

  • checklist.md — Критерии Review Gate & DoD.

  • magento-patterns.md — Карта проектирования (Plugin, Event, GraphQL, REST, Admin...).

  • references/ — Подробные примеры кода для каждого компонента.

  • glossary.md — Терминология Magento core.

• 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 (env) является опциональным — по умолчанию сервер автоматически определяет корневую папку репозитория. Устанавливайте только если репозиторий находится в другом месте и вы хотите переопределить.

🛠️ MCP Tools, предоставляемые AI

🔄 Рекомендуемый процесс для AI Agent

1. Перед кодом: get_team_standards → загрузка Constitution + Checklist + Pattern index.

2. При реализации: get_pattern_reference / search_standards / read_spec_file для поиска шаблона — не угадывать из памяти.

3. Перед сообщением о завершении: get_review_gate → раздел §12 Review Gate в checklist.md.