docs/design/ · Design-Parity · README

docs/design/

TL;DR — Dieser Ordner enthält die Design-Parity-Dokumentation zwischen dem SOLCOM-Figma-File (SOLCOM — Design System — Layouts, fileKey CHHDfbpX8Ys2LBiGs5HVK0) und der Drupal-Implementation (SDCs unter web/themes/custom/byte_theme/components/ plus Canvas-Kompositionen). Lebende Mapping-Tabelle: MAPPING.html. Format-/Workflow-Source-of-Truth: Skill solcom-design-mapping.

Dateien in docs/design/

Übersicht der Dateien docs/design/

Datei	Rolle	Schreibinstanz
MAPPING.html	Die lebende Tabelle: Figma-Frame ↔ SDC ↔ Status (matched partial gap obsolete). Wird mit jedem Component-Build / Refactor aktualisiert.	`solcom-design-scanner`
INVENTORY.html	Index der versionierten Figma-State-Snapshots. Wird beim Session-Start automatisch via `CLAUDE.md` mitgelesen.	manuell / Scanner
`0NNN-figma-state-YYYY-MM-DD.html`	Versionierte Snapshots des Figma-States zu Re-Sync-Zeitpunkten (Frame-Inventar mit Node-IDs, Token-State).	`solcom-design-scanner`
FIGMA-INTEGRATION.html	Codebase-Rules für Figma-MCP-Konsumenten (Tokens, Components, Frameworks, Assets, Icons, Styling, Projektstruktur).	manuell
README.html	Dieses Dokument — Index und Orientierungshilfe für den Ordner.	manuell

Agents

Scan, Explore, Review .claude/agents/

solcom-design-scanner — Figma-MCP, Read-/Write-Rechte, committet nicht. Aktualisiert MAPPING.html und legt neue Snapshots an.
solcom-design-explorer — Cross-Strand-Discovery beim Planen (read-only, kein Figma-MCP).
solcom-figma-reviewer — Visueller Compliance-Vergleich Figma-Frame ↔ SDC. Liefert Status-Verdicts (matched ↔ partial), die der Scanner in MAPPING.html einträgt.

Abgrenzung zu anderen docs/-Strängen

Was gehört wohin? docs/

Wo	Was
`CONTEXT.md` (root)	Domain-Glossar, Modul-Boundaries, ADR-Index. Lazy.
`docs/adr/`	Eigene Architekturentscheidungen (4-Sektionen-Format).
`docs/plans/`	Implementierungs-Pläne.
`docs/prds/`	Produkt-Anforderungen.
`docs/brainstorms/`	Frühe Ideen / Sondierungen.
`docs/context/`	Snapshots fremder Quellen (Miro, IT-Landschaft, externe Specs) — Snapshot-only, kein lebendes Mapping.
`docs/design/`	Implementations-Inventar Figma ↔ SDC mit lebendem Mapping plus Snapshots des Figma-States. Keine eigenen Entscheidungen, kein eigener Plan.
`docs/agents/`	Meta-Anleitungen für die Agenten selbst.

Status-Vokabular (Schnellreferenz)

matched / partial / gap / obsolete MAPPING.html

Status	Bedeutung
matched	Figma-Frame ist 1:1 als SDC/Komposition vorhanden, visuell und semantisch parity.
partial	SDC existiert, weicht vom Figma ab — Notes erklären warum.
gap	Frame im Figma, kein passendes SDC im Code — Greenfield-Build planen.
obsolete	SDC im Code, Frame im Figma nicht mehr — Cleanup-Decision fällig.

Ausführliche Definitionen, Übergangsregeln und Spalten-Konventionen: Skill solcom-design-mapping (.claude/skills/solcom-design-mapping/SKILL.md).

FAQ

Wo liegt die Source-of-Truth für das Mapping-Format?: Skill solcom-design-mapping — .claude/skills/solcom-design-mapping/SKILL.md.
Wer darf MAPPING.html schreiben?: Nur Agent solcom-design-scanner (oder manueller User-Edit). Refactor-Skills (simplify etc.) dürfen die Datei nicht anfassen.
Wo finde ich die Figma-Integration-Rules für Token-Mapping, CVA, Icon-System?: FIGMA-INTEGRATION.html in diesem Ordner.
Wie starte ich einen neuen Figma-Re-Scan?: Agent solcom-design-scanner aufrufen mit File-Key CHHDfbpX8Ys2LBiGs5HVK0. Vorher den aktuellen Snapshot-Stand aus INVENTORY.html lesen.
Kann ich direkt von einem Figma-Node auf das SDC schließen?: Nur wenn die Zeile in MAPPING.html einen Status hat. Für neue Frames: solcom-design-scanner ausführen, Ergebnis durch solcom-figma-reviewer bestätigen lassen.