Magento Spec & Standards (SSOT & MCP Server)

Dieses Repository ist die zentrale Wissensbibliothek (Single Source of Truth - SSOT) für den Magento 2.4.8-p5 / PHP 8.3 Standard, integriert mit einem MCP Server Stdio.

Dieses Repository enthält keine Prozesse oder Task/Feature-Verwaltung. Sie können diesen MCP Server mit jedem Magento-Projekt verbinden, damit der AI Agent in diesem Projekt auf die technischen Standards verweisen kann.

📌 Struktur

• config/ — Quelle der Wahrheit:

  • constitution.md — Technische Standards für PHP 8.3 & Magento Core.

  • checklist.md — Kriterien für Review Gate & DoD.

  • magento-patterns.md — Design-Landkarte (Plugin, Event, GraphQL, REST, Admin...).

  • references/ — Detaillierte Codebeispiel-Anleitungen für jede Komponente.

  • glossary.md — Magento Core-Begriffe.

• examples/ — Muster-Code-Blueprints nach Thema (siehe examples/INDEX.md zur Auswahl).

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

Related MCP server: Coding Tools MCP

⚡ Konfiguration der MCP Server-Verbindung

Claude Code (empfohlen mit Scope user, damit es in allen Projekten verfügbar ist):

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

Cursor (~/.cursor/mcp.json), Antigravity (~/.gemini/antigravity/mcp_config.json) und andere Clients:

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

SPEC_ROOT (env) ist optional — standardmäßig verwendet der Server das Stammverzeichnis des Repos. Nur setzen, wenn Sie das Repository an einem anderen Ort ablegen und überschreiben möchten.

🛠️ MCP Tools für AI

🔄 Empfohlener Ablauf für AI Agent

1. Vor dem Code: get_team_standards → Constitution + Checklist + Pattern Index laden.

2. Bei der Implementierung: get_pattern_reference / search_standards / read_spec_file zum Nachschlagen von Patterns verwenden — nicht aus dem Gedächtnis raten.

3. Vor der Meldung „Fertig“: get_review_gate → §12 Review Gate in checklist.md durchgehen.