Team Intern

Code-Konventionen

Verbindliche Regeln fuer einheitlichen Code im gesamten Monorepo.

Naming

• Web Components: shield-<name> (kebab-case)
• CSS Klassen: BEM mit shield- Prefix
• Tokens: --shield-<category>-<name>
• Dateien: kebab-case, kein Uppercase

Komponenten-Entwicklung

• Jede Komponente hat eigenen Ordner unter src/components/
• Pflicht: .tsx, .css, .interfaces.ts, readme.md
• Shadow DOM nur wenn explizit benoetigt, Standard ist shadow: false
• Props immer mit Default-Wert und JSDoc

Docs Quality

Fuer Doku-Aenderungen im Team-Intern- und Komponenten-Bereich gilt die abhakbare Quality-Checklist unter apps/astro-start/DOCS_QUALITY_CHECKLIST.md.

• In PRs idealerweise 10/10 Punkte erfuellt oder begruendete Ausnahme mit Ticket.
• Fokus: Zielklarheit, Suchqualitaet, A11y, Performance und Aktualitaet.
• Die Checklist ist als Review-Gate gedacht, nicht nur als Empfehlung.

Git Workflow

• Feature-Branches: feature/<ticket>-<beschreibung>
• Commits: Conventional Commits (feat:, fix:, docs:, ...)
• PRs: Review + CI gruen vor Merge
• Release: Changesets via pnpm changeset