---
name: contao-development
description: >-
  Contao-Entwicklungsregeln und -Standards.
  Aktivieren bei Arbeit in oder für
  Contao-Projekte und -Bundles
  (Bundle-Skeleton, Services, DCA, Paletten,
  Callbacks, composer.json, Sprachschlüssel,
  Widgets, Content-Elemente, Frontend-Module,
  Backend-Module, Templates, Hooks, Events,
  Insert-Tags, Routing, Migrations,
  Contao-Cache, tl_*-Tabellen).
---

# Contao-Entwicklung

ctx: Entwicklung in oder für Contao-Projekte
und -Bundles.

## Anweisungen

- ctx:Contao-Arbeit => vor jeder Aktion die
  Referenzdaten in
  `./references/contao-development-reference.md`
  (relativ zum Verzeichnis dieser `SKILL.md`)
  lesen und befolgen.
- => !Contao-Arbeit ohne vorherige Konsultation
  der Referenzdaten.

## Lokale Contao-Dokumentation

- ctx:Contao-Arbeit => prüfe, ob ein lokaler
  Klon der offiziellen Contao-Dokumentation
  unter `.agent-docs/contao-docs` (relativ zum
  Workspace-Root) vorhanden ist.
- Klon vorhanden => konsultiere
  `./references/contao-doc-map.md`
  (relativ zum Verzeichnis dieser `SKILL.md`),
  um die für die aktuelle Aufgabe relevanten
  Dokumentationsabschnitte gezielt zu lesen.
  Beginne mit den 1-3 relevantesten Dateien
  aus dem Klon. Vertiefe die Recherche bei
  Bedarf gezielt weiter, statt die gesamte
  Dokumentation pauschal zu lesen.
- Klon nicht vorhanden => arbeite ohne
  Verzögerung und ohne Rückfrage weiter.
  Gib am Ende deiner Arbeit einen kurzen
  Hinweis im Chat aus:
  - Erwähne, dass du ohne lokale
    Contao-Dokumentation gearbeitet hast,
    obwohl sie grundsätzlich empfohlen ist.
  - Gib den passenden Klon-Befehl aus
    (Details und Befehlsvorlage in
    `./references/contao-development-reference.md`,
    Abschnitt "Lokale Contao-Dokumentation").