Implementation Plan · solcom

feat: Drupal Best-Practice Skill-Library für solcom

Kontext Aufbau einer projektlokalen Claude-Code-Skill-Library unter .claude/skills/, die das im solcom-Repo gelebte Drupal- und Theme-Wissen kanonisiert. Strategie: Bulk-Adopt portabler Drupal-Skills aus ../adesso-sports-cms + selektive SOLCOM-Anpassung + 2 neue SOLCOM-spezifische Skills. Output: ~13 SKILL.md-Dateien mit YAML-Frontmatter und Trigger-Listen.
Status
Completed
Skills gesamt
13
SOLCOM-spezifisch
2 neu
Bulk-Adopt
7 aus sports-cms
01

Milestones

Zwei-stufige Strategie: erst SOLCOM-spezifische Skills, dann Bulk-Adoption aus sports-cms mit Cleansing.

U1–U2

SOLCOM-spezifische Skills anlegen

solcom-styleguide (Brand-Compliance: Lime #BEDC00, Background Blue, ADR-0003) und solcom-adr-workflow (ADR-Format, Trigger, customer-lens-reviewer). Keine sports-cms-Vorlage verfügbar — Neuentwicklung.

solcom-styleguidesolcom-adr-workflow
U3–U5

Adaptierte Drupal-Skills (sports-cms-Basis)

drupal-twig-sdc-authoring (13 byte_theme/AGENTS.md-Regeln, CVA, Slots), drupal-config-workflow (ADR-0010, dev-Split, settings.local.php), drupal-module-development (Hooks vs. DI, Plugin-Attribute, Routing). sports-cms als Foundation, SOLCOM-Eigenheiten ersetzt.

drupal-twig-sdc-authoringdrupal-config-workflowdrupal-module-development
U6

drupal-ddev-drush-workflow (neu)

DDEV-Lifecycle, Drush-Standard-Commands, häufige 3-Step-Choreographie composer require → pm:enable → cache:rebuild. Kein File-Glob — phrasenbasierter Trigger.

drupal-ddev-drush-workflowphrasenbasiert
U7

Bulk-Adopt: 7 portable Drupal-Skills aus sports-cms

drupal-recipes, drupal-testing, drupal-canvas, drupal-ai-integration, drupal-htmx-patterns, drupal-ci-cd, drupal-sync-architecture. Automatisiertes Cleansing: adesso_theme → byte_theme, sports-cms-Bezüge entfernen. Provenance-Banner pro Skill.

bulk-adoptsports-cms-cleansingprovenance-banner
02

Skill-Inventar

13 Skills aufgeteilt nach SOLCOM-spezifisch und generisch-Drupal. Prefix trennt spätere Migration auf globales adesso-Plugin.

SOLCOM-spezifisch (solcom-* Prefix)
  • solcom-styleguide — Brand-Palette (Lime/Dark-Blue), ADR-0003, Typografie, Logo-Usage. Trigger: CSS-Token-Files, "Markenfarbe", "brand review"
  • solcom-adr-workflow — ADR-Format, wann ADR nötig, customer-lens-reviewer-Trigger. Trigger: docs/adr/**, "ADR", "Komponenten-Entscheidung"
Generisch-Drupal (drupal-* Prefix) — adaptiert + bulk
  • drupal-twig-sdc-authoring — 13 byte_theme-Regeln, CVA, Slots. Trigger: *.twig, *.component.yml
  • drupal-config-workflow — Dev-Split (ADR-0010), cex/cim. Trigger: config/sync/**
  • drupal-module-development — Hooks, DI, Routing. Trigger: web/modules/custom/**
  • drupal-ddev-drush-workflow — DDEV/Drush-Lifecycle. Trigger: Phrasen
  • drupal-recipes, drupal-testing, drupal-canvas, drupal-ai-integration, drupal-htmx-patterns, drupal-ci-cd, drupal-sync-architecture — 1:1 aus sports-cms, cleansed
03

Key Code

Skill-Anatomie (Pattern aus sports-cms) und Trigger-Domänen-Map als Referenz für alle 13 Skills.

.claude/skills/<name>/SKILL.md — Frontmatter-Schema
---
name: drupal-twig-sdc-authoring
description: >
  SDC-Authoring-Konventionen für byte_theme.
  Triggers: "CVA", "SDC", "Twig",
    "Slot", "Component erstellen",
    "*.twig", "*.component.yml"
---

# <Skill-Title>

## When to Use
## Rules / Patterns
### <Regel-Name>
**Rule:** <Kurze Aussage>
**Why:** ADR-NNNN / byte_theme/AGENTS.md
**How:** <Code-Beispiel>
## Pitfalls
## References
Output-Struktur .claude/skills/
# SOLCOM-spezifisch (neu)
solcom-styleguide/
  SKILL.md
  references/colors.md      # optional
solcom-adr-workflow/
  SKILL.md

# Generisch, von sports-cms adaptiert
drupal-twig-sdc-authoring/SKILL.md
drupal-config-workflow/SKILL.md
drupal-module-development/SKILL.md
drupal-ddev-drush-workflow/SKILL.md

# 1:1 Bulk-Adopt (cleansed)
drupal-recipes/SKILL.md
drupal-testing/SKILL.md
drupal-canvas/SKILL.md
drupal-ai-integration/SKILL.md
drupal-htmx-patterns/SKILL.md
drupal-ci-cd/SKILL.md
drupal-sync-architecture/SKILL.md
04

Risks & Mitigations

Risk
Sev
Mitigation
Drift zwischen Skill-Text und Source-of-Truth (byte_theme/AGENTS.md, ADRs) nach späteren Änderungen.
MED
Skills verlinken explizit auf Originale, fassen nur kondensiert zusammen. Bei AGENTS.md-Änderungen Skill nachziehen.
Trigger zu breit — Skill lädt in nicht-relevanten Sessions und verschwendet Kontext.
MED
Max. 8–10 Phrasen + 1–2 File-Globs pro Skill. Nach ersten Live-Sessions empirisch überprüfen.
Bulk-Adopt zieht sports-cms-Spezifika mit (adesso_theme, Player, Sports-Klassen).
MED
Cleansing-Validierung: grep auf „sports", „adesso_theme", „match", „player" muss leer sein.
solcom-styleguide enthält versehentlich FCN-Inhalte (Nürnberg, Glober, Chevron).
LOW
Cleansing-Grep: FCN/Nürnberg/Bayer/Glober/Knile/Burggraf muss leer sein.
Überlappung solcom-styleguide mit globalem adesso-styleguide führt zu Konfusion.
LOW
Skill-Description macht Hierarchie explizit: solcom-styleguide hat Vorrang im solcom-Repo.
05

Open Questions

Globaler Lift auf adesso-Plugin-Bundle
Sobald die drupal-*-Skills sich projektlokal bewähren, können sie nach ~/.claude/plugins/adesso-drupal/ gehoben werden. Zeitpunkt: nach 2–3 Live-Sessions mit empirisch geprüften Triggern. Deferred, kein Blocking-Issue für diesen Plan.
Deferred · marc · nach Live-Validation
Cross-References zwischen solcom-styleguide und drupal-twig-sdc-authoring
Beide Skills berühren Twig-Klassen-Strings mit Brand-Tokens. Frage: soll drupal-twig-sdc-authoring den Styleguide-Skill direkt verlinken oder ist die byte_theme/AGENTS.md-Referenz ausreichend? Resolved: AGENTS.md ist ausreichend; cross-Reference optional.
Resolved · byte_theme/AGENTS.md als kanonische Quelle