Drupal & SOLCOM Skill-Library

Projektlokale Claude-Code-Skill-Library unter .claude/skills/. Skills laden automatisch in passenden Sessions (Trigger über YAML-Frontmatter: Datei-Globs + DE/EN-Phrasen) — kein manuelles Aktivieren nötig. Strategie und Begründung im Implementation-Plan: docs/plans/2026-05-02-001-feat-drupal-best-practice-skills-plan.md.

SOLCOM-spezifische Skills

Skill	Was er kann
solcom-styleguide	Brand-Compliance: Lime/Dark-Blue-Palette aus ADR-0003, Montserrat/ScalaSans, Logo-Usage, Hierarchie zum globalen `adesso-styleguide`. Triggert bei Brand-Reviews und Editierungen an `theme.brand.css` / `theme.css`.
solcom-adr-workflow	ADR-Format (4 Sektionen: Kontext / Entscheidung / Rejected alternatives / Consequences), Naming-Konvention `0NNN-kebab-name.md`, Pflicht-Konsultation des `customer-lens-reviewer` vor Architekturentscheidungen.
solcom-build-frontend	UI-Build-Choreographie als Slash-Command (`/solcom-build-frontend`, `disable-model-invocation: true`). 7-Phasen-Disziplin (Triage → Spec → Decide → Build → Verify-Build → Review → Visual-Verify) mit drei Sub-Workflows (Greenfield SDC, Refactor SDC, Canvas-Page). Ruft die passenden Skills und Reviewer-Agents an den richtigen Stellen. Begründung in `docs/adr/0012-solcom-build-frontend-workflow-skill.md`.
solcom-docs-context	External-Reference-Intake nach `docs/context/`. Definiert Frontmatter-Format (`title`, `source`, `source_type`, `captured`, `last_synced`, `tags`, `supersedes`), Naming `0NNN-kebab-name.md`, Intake-Workflow (Quelle → MD-Konversion → INVENTORY-Eintrag → User-Review). Operativer Intake läuft über den Agent `solcom-docs-ingestion`, Cross-Strand-Discovery beim Planen über `solcom-docs-explorer`. Beide Agents `model: sonnet`.
solcom-design-mapping	Design-Parity zwischen dem SOLCOM-Figma-File und der Drupal-Implementation (SDCs unter `web/themes/custom/byte_theme/components/` plus Canvas-Kompositionen). Definiert das lebende `docs/design/MAPPING.md` (Figma-Frame ↔ SDC ↔ Status `matched`/`partial`/`gap`/`obsolete`) plus versionierte Snapshots. Operativer Scan läuft über den Agent `solcom-design-scanner` (mit Figma-MCP-Tools), Cross-Strand-Discovery beim Planen über `solcom-design-explorer`. Beide Agents `model: sonnet`.
figma-autonomous-implementer	Autonomer Page-Implementer: nimmt Figma-Frame-URL + Drupal-Ziel-Route, decomponiert in SDC-aligned Slices via `grill-with-docs` (eine Bestätigung der Slice-Liste, dann headless), implementiert jede Slice durch Compose bestehender SDCs (Twig/Canvas-Config), commitet per Slice im Conventional-Commit-Format, visual-verifiziert an 375/768/1280 px. Auto-Trigger nur bei Phrase „autonomous implement"/`/figma-autonomous-implement` + Figma-URL + Route — nie auf Figma-URL allein. Auth-Failure: ≤2 Retries, dann NEEDS_REAUTH-JSON — kein Loop (ADR-0020).
solcom-figma-to-sdc	Figma-spec-driven inner loop für Bau oder Refactor einer einzelnen SDC-Komponente. Holt Figma-Material (Metadata, Design-Context, Screenshot, Variable-Defs), mappt Figma-Variants/Props auf `component.yml`-Schema (CVA-Variants vs. `data-*`-Attrs vs. JS-Config), implementiert Twig/CSS/JS und prüft mid-build visuell gegen den Figma-Frame (375/768/1280 px) — nicht nur post-build. Enthält SOLCOM-spezifische Patterns: Canvas-Editor-Kompatibilität, Mobile-Disable-Pattern für JS-Verhalten, Descendant-Cursor-Fix, `data-attr`-driven JS-Config, Accessibility-Checkliste und Kernel-Render-Contract-Test-Skelett. Scope: genau eine SDC. Für Page-Composition → `figma-autonomous-implementer`; für Post-build Drift-Audit → `solcom-figma-reviewer`; für Multi-SDC-Choreography → `/solcom-build-frontend`.
solcom-canvas-best-practices	byte_theme-abgeleitetes Canvas-Best-Practices-Playbook: das Architektur-/Kompositions-Wissen „wie bauen wir Canvas in SOLCOM richtig", destilliert aus den realen byte_theme-SDCs + den Content-Templates unter `config/sync/canvas.*.yml`. Canvas-Eligibility-Kriterien (Anker `card-frame`), Slot-vs-Prop-Entscheidungsregel (slot-basierter `card-frame`-Wrapper vs. prop-driven `card`), Card-Familie-als-Canvas-Wrapper-Pattern, Content-Template-Komposition, häufige Pitfalls — jede Regel an einer realen byte_theme-Datei verankert. Abgegrenzt: NICHT Canvas-API/Mechanik (`drupal-canvas`), NICHT SDC/CVA/Twig-Syntax (`drupal-twig-sdc-authoring`). Aus der Skill-Gap-Analyse 2026-06-19.
mittwald-hosting	Hosting-Provider-Choreographie für SOLCOMs Mittwald-Setup: mStudio-Layout, `mw`-CLI (Installation via `brew tap mittwald/cli`, Auth via `MITTWALD_API_TOKEN`-ENV — kein `mw login`, kein `mw deploy`), Sub-Kommandos (`app list`, `app upload`, `app exec`, `app ssh`), Deploy-Pattern (`mw app upload` für rsync + `mw app exec` für drush). Live-Inventar in `docs/context/0005-mittwald-hosting.md`. Nicht für CI-YAML — dafür `drupal-ci-cd`.
backlog-to-jira	Interaktiver Zeile-für-Zeile Workflow: liest `docs/context/260507 Story Backlog.xlsx`, erstellt pro Story ein Jira-Ticket (Projekt P2503, Typ Story, Label `backlog:<ID>`, Epic via Phase) und ein selbst-enthaltendes HTML-Doc unter `docs/stories/`. Preview → AskUserQuestion → Create (niemals Bulk-Import). Idempotent via JQL-Label-Check. Phase/Epic-Entscheidung wird pro Story bestätigt — Excel-Phase ist nur Vorschlag, Jira ist Single Source of Truth. Refinement der Tickets danach via `grill-with-docs`.
figma-ready-for-dev-to-jira	Liest `docs/design/MAPPING.html`, findet den ersten Frame mit `Figma-Status = ready-for-dev` und leerer `Jira Sub-Task`-Spalte, und legt per Jira REST API v3 einen Sub-Task unter Parent `P2503-83` an (Label `figma-node:<node-id>`, ADF-Description mit User Story + Figma-Deep-Link). Pre-Flight: Jira `/project/P2503` + Figma `whoami`. Defense-in-Depth via JQL-Drift-Check: existiert bereits ein Sub-Task mit dem Label, wird MAPPING auto-geheilt statt zu posten. Eine Frame pro Run, AskUserQuestion-Pflicht (`anlegen`/`skippen`). Trigger: „ready for dev nach Jira", „Figma ready-for-dev als Sub-Tasks", „figma-ready-for-dev-to-jira".
auto-review-fix	Autonomer End-to-End-Loop nach `/solcom-review`: liest Findings, fixt Hard-Items mit den passenden Drupal-Skills (`drupal-config-workflow`, `drupal-module-development`, `drupal-testing`), schreibt ADR bei Spec-Konflikten, commitet mit Conventional-Format, resolved Merge-Konflikte (LOG/index append-only), pusht, postet ADF-Kommentar mit Trade-off auf Jira, armed einen Persistent-Comment-Watcher. Default: KI merged nicht — der PR bleibt review-ready offen; PR-`autoComplete` nur via opt-in Flag `--merge` (Memory `feedback_ki_merged_nicht_bis_mr`). Input: Jira-URL ODER Azure-DevOps-PR-URL. Designed für `/goal`-Driver. Idempotent (Re-Run skippt bereits abgeschlossene Schritte). Pilot: `feature/P2503-105`, Commit `18d0ab5`. Trigger: „/auto-review-fix", „review-und-fix", „review and merge P2503-XX".
implement	Autonomer End-to-End-Bau-Loop für eine Story: nimmt Jira-Story-Key (P2503-XXX), liest alle Sub-Tasks und Story-Hub, iteriert sequenziell durch alle Sub-Tasks via Sonnet-Sub-Agents (Heavy-Brief Pattern: Opus-Orchestrator entscheidet Trade-offs vorab, Sonnet implementiert), prüft pro Sub-Task die Layer-Evals + Diff-Reviewer-Agent, committet, transitioniert Jira, öffnet am Ende einen Azure-DevOps-PR. Designed für `/goal`-Driver mit Persistent-Monitor. Komplementiert `solcom-review` (Review erzeugen) und `auto-review-fix` (Findings fixen + mergen). Trigger: „/implement P2503-XXX", „bau P2503-XXX", „arbeite P2503-XXX ab".
solcom-review	Manueller in-session PR-Review auf zwei Achsen: (1) Standards (CLAUDE.md, byte_theme/AGENTS.md, ADRs, docs/wiki/, docs/agents/, die vier Code-Reviewer-Prompts als Rule-Korpora), (2) Spec (Jira-Story F-XXX/P2503-XX aus Commits + Branch-Name plus passende HTML-Docs unter docs/prds/, docs/plans/, docs/brainstorms/). Zwei Input-Modi: git-Fixed-Point (`/solcom-review main`, SHA, Branch) ODER Azure-DevOps-PR-URL (REST-API holt Source/Target/Description/Linked-Work-Items). `--persist` ist Default — Report wird nach `docs/reports/` geschrieben (Template `03-code-review-pr.html`) mit LOG + INDEX. Dritte Review-Stage neben Decision-Time (`customer-lens-reviewer`) und Cloud-Post-PR (PR-Agent, ADR-0021). Source: ADR-0028.
solcom-lfg	Dünner in-session Orchestrator (Stil des EveryInc-`lfg`): kettet ab vorhandenem PRD/Parent-Key gated sequenziell `solcom-to-issues` → `implement` → `solcom-dogfood` → `solcom-review --persist` → `auto-review-fix` (ohne `--merge`) → Learn → DONE. Autonom ohne Zwischen-Gate bis zum review-ready MR; der finale Merge bleibt menschlich. Sonnet-Hauptschläger, Opus nur als Buddy für ambige Review-Findings. Begründung: `docs/adr/0049-solcom-lfg-in-session-orchestrator.html`.
solcom-dogfood	Branch-weite Frontend-QA mit Auto-Fix (adaptiert von EveryInc-`ce-dogfood-beta`): diff-scoped gegen `origin/develop`, baut aus jeder Änderung eine User-Journey-Test-Matrix, fährt die DDEV-Site via `agent-browser` durch (3 Breakpoints 375/768/1280 + Figma-Side-by-Side), fixt Klein-Bugs autonom (+ Regression-Test + per-Pfad-Commit), eskaliert große Entscheidungen nach `docs/reports/pending-approvals/`. HTML-Report unter `docs/reports/` (+ LOG/INDEX). Ist der Skill, den `solcom-lfg` Step 3 ruft. Nur `agent-browser`, nie `mcp__claude-in-chrome__*`. Trigger: „/solcom-dogfood", „dogfood P2503-XXX", „QA den Branch".
solcom-docs-lint	Deterministisches Lint für `docs/`-Strang. Acht Regel-Klassen: `stale`, `orphan`, `broken-link`, `status-drift`, `log-gap`, `wiki-drift`, `naming`, `frontmatter`. Komplementiert `solcom-docs-curator` (LLM-Lint für Contradictions + Data-Gaps). Periodik: alle 30 Tage vorschlagen — bei Session-Start prüfen, ob letzter `lint-pass`-Eintrag in `LOG.html` älter als 30 Tage ist.
solcom-docs-curator	LLM-pflichter Karpathy-Wiki-Curator für den `docs/`-Strang. Zwei Klassen, die kein deterministischer Check abdecken kann: contradictions (zwei Pages widersprechen sich) und data-gaps (wichtige Konzepte, zu denen wir noch nichts wissen). Suggestion-Style — sammelt Befunde mit Begründung, schreibt nichts. Komplementiert `solcom-docs-lint` (8 deterministische Klassen) — Curator ist die LLM-Pflicht-Schicht.
solcom-tdd	TDD-Philosophie-Skill für den gesamten SOLCOM Drupal-Stack: Drupal-PHP (Services, Plugins, Hooks, Forms, EventSubscriber, Drush-Commands), Twig/SDC-Components, Drupal-Config, Drupal-Behaviors (JavaScript), Recipes, Canvas-Code-Components. Vertical-Slices statt Horizontal, ein PHPUnit/FunctionalJavascript-Test → ein Implementation-Schritt → repeat. Zwölf Files: SKILL.md plus fünf mattpocock-adaptierte Helper (`deep-modules`, `interface-design`, `mocking`, `refactoring`, `tests`) und sechs SOLCOM-Ergänzungen (`pyramid` — 10×-Speed-Differenz pro Test-Tier; `tracer-bullets` — sechs Drupal-Layer-Tracer mit Skeleton-Code + Skeleton-Test + Verifikations-Command; `fixtures` — Domain-Helpers + SF-JSON-Fixtures, Anker `drupal-testing`; `naming` — Test-Naming gegen CONTEXT.md/wiki-Vokabular; `ci-integration` — Watch-Loop, Pre-Commit, Azure-Stages, Anker `drupal-ci-cd`; `async-testing` — Queue/Cron/Batch/Lock + TimeInterface-Mock, Anker `drupal-module-development`). Adaption von `mattpocock/skills/skills/engineering/tdd` (SHA `7a989411`) — Philosophie 1:1 übernommen, alle TS/Jest-Beispiele durch PHP/Drupal/Twig/PHPUnit ersetzt. Komplementiert `drupal-testing` (PHPUnit-Mechanik) als Philosophie-Schicht darüber.

Generisch-Drupal Skills

Neu oder aus ../adesso-sports-cms adaptiert.

Skill	Was er kann
drupal-ddev-drush-workflow	DDEV-Lifecycle, Drush-Standard-Commands, die häufigen Choreographien (`composer require → pm:enable → cr`, `update:db` nach Code-Change), typische Pitfalls.
drupal-twig-sdc-authoring	SDC + CVA + Twig-Konventionen. Verlinkt auf `byte_theme/AGENTS.md` als kanonische Quelle der 13 Regeln; ergänzt SDC-`component.yml`-Schema-Heuristik (Slot vs. Prop). Seit 2026-05-03 zusätzlich Twig-adaptierte Heuristiken aus `drupal-canvas/skills` — Variants-vs-granular-Props, Repeatable-Content-Pattern, Granularity-Audit, Pre-Decision-Workflow.
drupal-config-workflow	`drush cex/cim`, `config_split` mit Dev-Profile, `settings.local.php`-Onboarding (siehe `AGENTS.md` Repo-Root und ADR-0010), Pitfall „frisch geklonte Site + sofortiges `cim` deinstalliert Dev-Module".
drupal-module-development	Custom-Module-Best-Practices: `.info.yml`/`.routing.yml`-Schema, Hook vs. Service vs. EventSubscriber, Dependency Injection, Plugins (Drupal-11-Attribute), Update-Hooks, Coding Standards, 5 Sicherheits-Anti-Patterns. Seit 2026-06-19 (Skill-Gap-Analyse) erweitert um Cacheability (Tag-Naming, Context-Wahl, `max-age`-Entscheidungsbaum, `#lazy_builder`), Search-API-Processor, Migrate-Sync (operationalisiert ADR-0032), File-Upload-Security und OOP-Hooks (`#[Hook]` in `src/Hook/`).
drupal-security	Proaktiver Authoring-time-Security-Skill (prevention-first): die vier Review-Fragen (woher kommen die Daten / wohin / wer greift zu / was bei Malicious Input) plus konkrete Drupal-11-Patterns — Output-Sanitization (Twig-Autoescape vs. `\|raw`, `Xss::filter`, `Html::escape`), parametrisierte DB-Zugriffe, CSRF-Token, Route-/Entity-Access mit Cacheability, Secrets, File-Upload-Härtung (Extension-Whitelist + MIME-Cross-Check gegen Polyglot-Files). Deckt die SOLCOM-Cross-Cutting-Fläche (`\|raw` in SDCs, AI-Prompt-Injection, Migrate-External-Data, Canvas-Slots). Backing-Source-of-truth, die der Diff-time-Agent `drupal-security-sentinel` zitiert. Aus der Skill-Gap-Analyse 2026-06-19.

Bulk-Adopt aus `../adesso-sports-cms`

Übernommen mit Cleansing der sports-cms-Spezifika und Provenance-Banner. Sport-spezifische Beispiele wurden durch generische Drupal-Beispiele ersetzt.

Skill	Was er kann
drupal-recipes	Drupal Recipes (Feature-Pakete), Recipe-Struktur, Composer-Integration, Unpack-Workflow.
drupal-testing	PHPUnit Unit/Kernel/Functional/FunctionalJavascript, Base-Classes, Traits, Decision Guide.
drupal-canvas	Drupal Canvas: Components, Content Templates, Slots, Shape-Matching. Seit 2026-05-03 erweitert um das Code-Components-Bundle (`drupal-canvas/code-components/<topic>.md`, elf Themen-Files wholesale aus `drupal-canvas/skills@f3faac0767b1` (MIT)). Frontmatter um Code-Component-Trigger ergänzt (Workbench, JsonApiClient, canvas push, JSX, Tailwind theme etc.).
drupal-ai-integration	`drupal/ai`-Modul: Provider-Plugins, Key-Modul, Queue-Worker, Safety-Rules, Review-Workflow.
drupal-htmx-patterns	HTMX im Drupal-Kontext: `data-hx-*`-Attribute, OOB-Swap, CSP-Hinweise, Routing-Konventionen.
drupal-ci-cd	CI/CD-Pipeline-Pattern für Drupal CMS. GitHub-Actions- und GitLab-CI-Sections als Referenz aus dem sports-cms-Foundation-Import. Solcom-Zielarchitektur: Section "Azure DevOps Pipeline (Mittwald-Deploy)" — verifizierter `mw`-CLI-Pfad, Variable-Group-Layout, Bootstrap-Vorbedingung. Cross-Reference: Skill `mittwald-hosting`, Context-Snapshots `0004-azure-devops-…` + `0005-mittwald-hosting`.

Wholesale-Pull aus `drupal-canvas/skills`

Elf Themen-Files aus dem offiziellen drupal-canvas/skills-Repo (MIT, SHA f3faac0767b1) wholesale übernommen am 2026-05-03 — Originalwortlaut (englisch), kein Cleansing. Gebündelt unter .claude/skills/drupal-canvas/code-components/<topic>.md. Claude Code scannt nur .claude/skills/<name>/SKILL.md — verschachtelte SKILL.md-Files lösen kein Auto-Trigger aus. Konsequenz: Die Code-Component-Trigger-Phrasen wurden in das Frontmatter des Hub-Skills drupal-canvas/SKILL.md eingehängt.

Zielen auf die Code-Components-Surface (canvas.js_component.*) parallel zur SDC/Twig-Surface. Stack-agnostische Heuristiken (Composability, Decomposition) liegen zusätzlich Twig-adapted in drupal-twig-sdc-authoring vor.

.claude/skills/drupal-canvas/ ├── SKILL.md # Hub mit erweiterten Trigger-Phrasen └── code-components/ ├── component-definition.md # + component-definition/{component-mocks,naming}.md ├── component-metadata.md ├── composability.md # + composability/repeatable-content.md ├── design-decomposition.md # + design-decomposition/{granularity,props-vs-slots-rubric,worked-example}.md ├── styling-conventions.md ├── component-utils.md ├── data-fetching.md ├── navigation-components.md # + navigation-components/data-sources.md ├── page-definition.md ├── workbench.md # + workbench/{components,pages}.md └── component-push.md

Themen-File	Was es enthält
component-definition.md	Component-Contract: `index.jsx` + `component.yml` + Workbench-Mock-Coverage. Einstiegspunkt für jeden Code-Component-Task.
component-metadata.md	`component.yml`-Schema-Detail für JS-Components (gleiches JSON-Schema-Format wie SDC), Prop-Types, `meta:enum`, Slot-Map vs. `[]`.
composability.md	Props-vs-Slots-Heuristik, Variants-vs-granular-Props, Repeatable-Content-Pattern, Granularity-Audit. JSX-Cut; Twig-Cut in `drupal-twig-sdc-authoring`.
design-decomposition.md	Mandatory Pre-Implementation-Workflow A–G für neue Figma-Frames / greenfield Screens (Region-Map, Inventar, Tree, Props/Slots-Sketch, Granularity-Audit, Handoff).
styling-conventions.md	Tailwind 4 `@theme`-Tokens + CVA-JS + `cn()`-Utility (`clsx` + `tailwind-merge`). Brand-Token-Compliance zusätzlich via `solcom-styleguide`.
component-utils.md	`FormattedText` (für `contentMediaType: text/html`-Props) und `Image` aus dem `drupal-canvas` npm-Paket.
data-fetching.md	SWR + `JsonApiClient` + `DrupalJsonApiParams` für Drupal-Daten in JSX-Components, inkl. Filter-Pattern und Request-Verifikation.
navigation-components.md	Nav-Patterns (Header / Footer / Sidebar / Mobile / Breadcrumb) mit JSON:API-Menü-Source und Page-Context.
page-definition.md	Canonical Contract für Page-JSON-Specs in `pagesDir` (Canvas-CLI `push`/`pull`-Sync).
workbench.md	`@drupal-canvas/workbench` Dev-Server-Setup, Verifikations-Loop für Component-Mocks und Page-Previews.
component-push.md	Canvas-CLI `push`-Workflow mit Auth-Setup (`.env`, `~/.canvasrc`, OAuth) + Recovery bei Dependency-Failures.

Provenance: Banner pro Themen-File mit Upstream-SHA f3faac0767b1, Adoption-Datum 2026-05-03, MIT-Lizenz-Hinweis.

Workflow & Doc-Authoring

Cross-cutting Skills für Doku-Authoring, Plan-Decomposition, TDD und Debugging. Großteils aus mattpocock/skills übernommen und für SOLCOM adaptiert; html-doc-authoring ist projekt-eigener Pflicht-Skill für alles unter docs/.

SOLCOM-Pflicht

Skill Was er kann

html-doc-authoring Schreibt alle Doku-Files unter docs/ als HTML — Plans, PRDs, ADRs, Brainstorms, Reports, Context-Snapshots, Design-MAPPING/INVENTORY. Definiert Naming, Frontmatter via <meta name="solcom:*">, Template-Auswahl aus docs/_templates/ und den 8-Schritt-Workflow. Pflichtschritte 9 (LOG.html-Eintrag) + 10 (INDEX-Zeile) für jeden Skill, der nach docs/ schreibt. Sub-Workflow Wiki-Promote für docs/wiki/<kebab-slug>.html. Begründung: ADR-0022 (HTML-First-Documentation).

Skill	Was er kann
html-doc-authoring	Schreibt alle Doku-Files unter `docs/` als HTML — Plans, PRDs, ADRs, Brainstorms, Reports, Context-Snapshots, Design-MAPPING/INVENTORY. Definiert Naming, Frontmatter via `<meta name="solcom:">`, Template-Auswahl aus `docs/_templates/` und den 8-Schritt-Workflow. Pflichtschritte 9 (LOG.html-Eintrag) + 10 (INDEX-Zeile)* für jeden Skill, der nach `docs/` schreibt. Sub-Workflow Wiki-Promote für `docs/wiki/<kebab-slug>.html`. Begründung: ADR-0022 (HTML-First-Documentation).

Decomposition-Pipeline

Skill	Was er kann
to-prd	Wandelt den aktuellen Konversations-Kontext in ein PRD um und veröffentlicht es im Projekt-Issue-Tracker (Jira P2503). Erster Schritt der Decomposition-Pipeline.
to-plan	Zerlegt ein PRD in Tracer-Bullet-Vertical-Slices und emittiert einen Implementation-Plan unter `docs/plans/`. Default-Decomposition-Pfad, wenn AFK-Agents / Jira-Sub-Tasks nicht nötig sind.
to-issues	Zerlegt einen Plan, Spec oder PRD in unabhängig-grabbare Issues im Projekt-Issue-Tracker mittels Tracer-Bullet-Vertical-Slices. Sub-Tasks-Variante mit Jira-Push.
grill-me	Interviewt den User unermüdlich zu einem Plan oder Design, bis geteiltes Verständnis erreicht ist. Resolved jeden Branch des Decision-Trees.
grill-with-docs	Grilling-Session, die den Plan gegen das existierende Domain-Modell challenged, Terminologie schärft und Doku inline aktualisiert (CONTEXT.md, ADRs), während Entscheidungen kristallisieren.
prototype	Baut einen wegwerfbaren Prototyp, um ein Design auszuarbeiten, bevor man sich committet. Routes zwischen zwei Branches — Terminal-App für State/Business-Logic-Fragen, oder mehrere radikal-verschiedene UI-Varianten unter einer Route.

Bau- und Debug-Tools

Skill	Was er kann
tdd	Test-driven development mit red-green-refactor-Loop. Für Feature-Bau oder Bug-Fix mit Test-First-Disziplin. Komplementiert `drupal-testing` (PHPUnit-Patterns).
diagnose	Disziplinierter Diagnose-Loop für harte Bugs und Performance-Regressionen: Reproduce → minimise → hypothesise → instrument → fix → regression-test.
improve-codebase-architecture	Findet Deepening-Opportunities im Codebase, informiert durch die Domain-Sprache in `CONTEXT.md` und die Entscheidungen in `docs/adr/`. Konsolidiert tight-coupled Module, macht Codebase testbarer und AI-navigierbar.
triage	Triagiert Issues durch eine State-Machine, getrieben von Triage-Rollen. Erstellt Issues, reviewt eingehende Bugs/Feature-Requests, bereitet Issues für AFK-Agents vor.

Author-Helpers

Skill	Was er kann
edit-article	Editiert und verbessert Artikel durch Section-Restructuring, Klarheit und Prosa-Verdichtung.
handoff	Kompaktiert die aktuelle Konversation in ein Handoff-Doc für einen anderen Agenten.
zoom-out	Sagt dem Agenten, breiteren Kontext oder eine höhere Perspektive zu liefern.
caveman	Ultra-komprimierter Kommunikations-Modus. Reduziert Token-Verbrauch um ~75% durch Weglassen von Füllwörtern bei voller technischer Genauigkeit. Trigger: „caveman mode", „/caveman".
obsidian-vault	Sucht, erstellt und verwaltet Notes im Obsidian-Vault mit Wikilinks und Index-Notes.
write-a-skill	Erstellt neue Agent-Skills mit korrekter Struktur, Progressive Disclosure und gebündelten Resources. Meta-Skill für Skill-Library-Wartung.

Setup-Skills

Skill	Was er kann
git-guardrails-claude-code	Setzt Claude-Code-Hooks auf, die gefährliche git-Commands (push, reset --hard, clean, branch -D) blockieren, bevor sie ausgeführt werden.
setup-matt-pocock-skills	Richtet einen `## Agent skills`-Block in `AGENTS.md`/`CLAUDE.md` und `docs/agents/` für Skill-Registrierung ein. Meta-Setup für die mattpocock-Bulk-Adoption.

Bulk-mitgekommen, nicht SOLCOM-aktiv

Aus mattpocock/skills-Bulk übernommen, aber Stack-fremd. Werden nicht durch SOLCOM-Triggers angesprochen — können entfernt werden, falls sie in 2-3 Sessions nicht referenziert werden.

Skill	Status
migrate-to-shoehorn	TypeScript-Specific (`@total-typescript/shoehorn`) — nicht solcom-relevant.
setup-pre-commit	Husky / Node-Stack-Pre-Commit-Hooks — SOLCOM nutzt PHP-/Composer-Setup, nicht direkt anwendbar.
scaffold-exercises	Teaching/Course-Material-Skill — nicht solcom-relevant.

Verworfen

drupal-sync-architecture — nach Cleansing-Bewertung 75-80 % sport-platform-API-spezifisch ohne generischen Mehrwert. Begründung im Plan unter U7. Generische Sync-Pattern-Konzepte (Polling vs. Push, Webhook-Handling, Idempotency, Queue-Pattern) werden bei konkretem solcom-Use-Case separat dokumentiert.

Konventionen

Trigger zweisprachig (DE + EN), wo sinnvoll plus File-Globs (web/themes/custom/byte_theme/**, config/sync/** etc.).
Bulk-übernommene Skills tragen einen Provenance-Banner direkt nach dem YAML-Frontmatter mit Source-Pfad, Datum, Plan-Referenz und Drift-Awareness-Hinweis. Zwei Adoption-Modi:
- Cleansing-Bulk (z. B. drupal-recipes, drupal-canvas, drupal-testing aus ../adesso-sports-cms) — sport-spezifische Beispiele durch generische ersetzt, Verweise auf solcom-Konventionen ergänzt.
- Wholesale-Pull (die elf Themen-Files unter drupal-canvas/code-components/<topic>.md aus drupal-canvas/skills) — Originalwortlaut unverändert übernommen. Gebündelt unter dem Hub-Skill drupal-canvas/. Provenance-Banner referenziert Upstream-SHA.
SOLCOM-Skills (solcom-* Prefix) bleiben projektlokal. Generisch-Drupal-Skills (drupal-* Prefix) sind perspektivisch nach ~/.claude/plugins/adesso-drupal/ heb-bar.
customer-lens-reviewer bleibt die kanonische Review-Instanz für Komponenten- und Architekturentscheidungen — Skills verweisen auf ihn statt eigene parallele Review-Mechanik einzuführen.

Wartung & Hinzufügen

Wartung

Skill-Inhalte sind kondensierte Zusammenfassungen mit Verlinkung auf die Source-of-Truth (byte_theme/AGENTS.md, ADRs, externe Drupal-Doku) — keine vollständige Duplikation.
Bei größeren Änderungen an byte_theme/AGENTS.md oder einem ADR prüfen, ob ein Skill nachgezogen werden muss.
Drift gegenüber sports-cms-Originalen wird über Provenance-Banner (mit Datum) sichtbar gehalten. Re-Sync ist ein separater PR.
Drift gegenüber drupal-canvas/skills-Upstream: Provenance-Banner enthält Upstream-SHA. Beim Bump: SHAs in allen elf Themen-Files aktualisieren, Diff prüfen, ggf. mergen. Kein automatischer Sync.
Trigger-Schärfung nach 2-3 Live-Sessions empfohlen — Trigger-Listen empirisch validieren.

Hinzufügen eines neuen Skills

Verzeichnis anlegen: .claude/skills/<name>/SKILL.md.
YAML-Frontmatter mit name, description (inkl. Triggers in DE+EN).
Wenn der Skill aus einem anderen Repo geforkt wird: Provenance-Banner direkt nach Frontmatter — bei Wholesale-Pull mit Upstream-SHA, bei Cleansing-Bulk mit Source-Pfad und Datum.
Wenn der Skill references/-Subfiles braucht: Verzeichnis references/ daneben anlegen.
Bei Wholesale-Pull mehrerer thematisch verwandter Upstream-Skills: Bündeln unter einem Hub-Skill (analog drupal-canvas/code-components/<topic>.md) statt separater Top-Level-Skills.
Bei SOLCOM-spezifischem Inhalt solcom--Prefix; bei generisch-Drupal drupal--Prefix.
Diese Doku (docs/agents/skills.html) im Inventar ergänzen.

Diff-time Reviewer-Agents

Die Skills sind Source of Truth für Authoring-Konventionen. Fünf projektlokale Diff-time Reviewer-Agents (solcom-brand-reviewer, drupal-twig-sdc-reviewer, drupal-php-reviewer, drupal-config-architecture-reviewer, drupal-test-coverage-reviewer) referenzieren die Skills inline und sind manuell via Task-Tool aufrufbar — Skill-Updates wirken automatisch beim nächsten Lauf. Vollständiges Inventar inklusive Decision-time-Achse (customer-lens-reviewer), Trigger-Globs, Skill-Source-of-Truth und Konventionen in docs/agents/reviewers.html. Kurzform auch in der Strand-Tabelle in AGENTS.md.

Docs-Workflow-Agents (Ingestion + Discovery)

Zwei projektlokale Agents unterstützen den solcom-docs-context-Skill operativ. Beide laufen mit model: sonnet.

Agent	Trigger	Rolle
solcom-docs-ingestion	User übergibt PDF / Bild / PPTX / DOCX / Miro-URL / Slack-Upload zur Verankerung im Repo.	Liest die Quelle (multimodal Read, `pages:` für PDF, MCP/WebFetch für URLs), draftet Markdown mit Frontmatter, vergibt nächste `0NNN`, hängt INVENTORY-Zeile an, zeigt Diff zur Review. Committet nicht selbst.
solcom-docs-explorer	Vor jedem Planungs-Schritt: PRD, Plan, Refactor-RFC, Architektur-Exploration, neuer ADR.	Durchsucht `docs/{context,adr,plans,prds,brainstorms}/` cross-strand, gibt strukturierte Snippets mit Pfad + Begründung + empfohlener Lese-Reihenfolge zurück. Read-only, schreibt nichts.

Definitionen in .claude/agents/solcom-docs-ingestion.md und .claude/agents/solcom-docs-explorer.md. Format-/Workflow-Source-of-Truth: Skill solcom-docs-context.

Design-Workflow-Agents (Scanner + Explorer)

Zwei projektlokale Agents unterstützen den solcom-design-mapping-Skill operativ. Beide laufen mit model: sonnet.

Agent	Trigger	Rolle
solcom-design-scanner	Refresh der Design-Parity, nach Component-Build, nach Figma-Update, oder quartalsweiser Drift-Check.	Verifiziert Figma-MCP-Auth (`whoami`), zieht das Frame-Inventar via `mcp__claude_ai_Figma__get_metadata`, liest selektiv `get_design_context` für `gap`-/neue Frames, glob't SDCs, diff't beide Seiten gegen `docs/design/MAPPING.md`, schreibt die Tabelle, draftet optional einen Snapshot. Committet nicht selbst.
solcom-design-explorer	Vor jedem design-bezogenen Planungs-Schritt (neuer SDC, Refactor, Page-Komposition, Figma-driven Build, ADR zu Komponenten-Topologie).	Liest `docs/design/MAPPING.md` + `INVENTORY.md`, gibt strukturierten Match/Gap-Report mit Status-Aggregation, Mapping-Lücken und empfohlenen nächsten Schritten zurück. Read-only, schreibt nichts.

Definitionen in .claude/agents/solcom-design-scanner.md und .claude/agents/solcom-design-explorer.md. Format-/Workflow-Source-of-Truth: Skill solcom-design-mapping.

★

Wichtig: Status-Verdicts matched ↔ partial (visueller Compliance-Vergleich) sind nicht Aufgabe des Scanners — die fällt der solcom-figma-reviewer. Der Scanner übernimmt das Verdict in die Notes/Status-Spalten, beurteilt aber nicht selbst.