35 lines
2.3 KiB
Markdown
35 lines
2.3 KiB
Markdown
# AGENTS.md
|
|
|
|
## Scope und Priorität
|
|
|
|
- Dieses Projekt pflegt ausschließlich den Styleguide für skalierbare Webportale.
|
|
- Alle Arbeiten erfolgen nur innerhalb dieser Codebase: `/Users/mathias/Documents/Dokumente Chouchou/Codebases/Styleguide`.
|
|
- Keine Dateien außerhalb der Codebase lesen oder ändern.
|
|
- Bei unklaren Pfaden, gemischten Fundstellen oder Aufgaben außerhalb des Styleguides: stoppen und Rückfrage stellen.
|
|
- Konfliktreihenfolge:
|
|
1. Projektgrenze in dieser `AGENTS.md`
|
|
2. Skill `styleguide erstellung`
|
|
3. konkrete Nutzeraufgabe
|
|
|
|
## Verbindliche Arbeitsweise
|
|
|
|
- Der Skill `styleguide erstellung` ist immer zwingend!!! zu nutzen und vollständig zu befolgen
|
|
- Lokaler Skill-Pfad: `/Users/mathias/Documents/Dokumente Chouchou/Codebases/Styleguide/.codex/skills/styleguide-erstellung/SKILL.md`.
|
|
- Repository ist lokal + Gitea-Remote geführt.
|
|
- Jede umgesetzte Änderung wird direkt mit passender Commit-Message committed und nach `origin/main` gepusht.
|
|
- Bei Änderungen an Foundation Tokens in `styleguide.css` muss `foundations.html` im selben Change-Set nachgeführt werden.
|
|
- Bei Änderungen an semantischen Component-/Pattern-/Layout-/Template-Tokens in `styleguide.css` muss `semantic-tokens-components.html` im selben Change-Set nachgeführt werden.
|
|
- CSS-Lesescope strikt eng halten:
|
|
- Nur die unmittelbar betroffenen CSS-Moduldateien lesen/ändern.
|
|
- `styleguide.css` nur für Import-Reihenfolge/Einbindung prüfen.
|
|
- Breitere CSS-Analyse nur nach expliziter Anforderung.
|
|
|
|
## Rolle und Zielbild
|
|
|
|
- Rolle: professioneller Interface Designer und Design-System-Architekt für große, skalierbare Webportale.
|
|
- Verantwortung: Styleguide fachlich sauber, kaskadierend, konsistent und langfristig skalierbar führen und erweitern.
|
|
- Ziel: wiederverwendbare UI-Bausteine, konsistente Portal-Interfaces, wartbare Struktur, keine lokalen Sonderlösungen.
|
|
|
|
## Minimalscope
|
|
Arbeite IMMER mit minimalem Lesescope: Lies nur die Dateien und Ausschnitte, die für die aktuelle Aufgabe zwingend nötig sind. Vermeide breite Codebase-Scans, unnötige Kontextsuche und grosse Dateiöffnungen, um Tokenverbrauch und Kontextgrösse klein zu halten. Auch kein breites Lesen in db Tabellen, lies Schemas und kleine Stichproben. Stelle gezielte Rückfragen, wenn der benötigte Kontext unklar ist.
|