2.5 KiB
AI README
Diese Datei ist fuer AI-Agenten gedacht, die in diesem Repo weiterarbeiten.
Repo-Zweck
Dieses Repo ist der Obsidian-/Wireframe-Vault fuer HiveGrid. Es enthaelt Planung, UX-Regeln, Screen-Pakete, Canvas-Flows und Subframe-Handoffs. Es ist nicht die Produkt-Codebase.
Die eigentliche Referenz-Codebase liegt lokal in hivegrid-cloud/ und ist bewusst per .gitignore ausgeschlossen. Dieses Verzeichnis darf gelesen werden, soll aber nicht in dieses Wireframe-Repo committed oder gepusht werden.
Wichtige Bereiche
| Pfad | Zweck |
|---|---|
00 Start Here.md |
Einstieg in den Vault |
01 Regeln/ |
Arbeitsregeln fuer Wireframing, Obsidian, Subframe und Brainstorming |
02 Wireframes/Screen Paket Tracker.md |
Zentrale Paket- und Flow-Uebersicht |
02 Wireframes/P2 Auth/ |
Aktuell aktive Auth-/Account-/Admin-Wireframe-Pakete |
02 Wireframes/_Templates/ |
Vorlagen fuer neue Pakete und Screens |
03 Quellen und Repo/ |
Repo- und Quellenhinweise |
Arbeitsregeln
- Bestehende Regeln zuerst lesen, besonders
01 Regeln/Wireframing Playbook.md. - Flows einzeln bearbeiten und nur validierte Entscheidungen final dokumentieren.
- Keine bestehenden Subframe-Screens loeschen oder ueberschreiben, wenn der Nutzer das nicht explizit verlangt.
- Neue Screens/Flows immer in Tracker, Paketdatei, Screen-Dateien und Canvas konsistent halten.
- Backlog-Punkte klar markieren, damit V2-Themen nicht verloren gehen.
- Bei Subframe-Arbeit bestehende Nutzer-Anpassungen nicht rueckgaengig machen.
hivegrid-cloud/nur als Referenz verwenden.
Subframe-Kontext
Subframe-Links stehen in den jeweiligen Screen-Dateien im Frontmatter-Feld subframe. Bei Modal-Screens soll, wenn moeglich, die echte Subframe-Modal-/Dialog-Layout-Funktion verwendet werden, nicht ein nachgebautes Overlay.
Git- und Sync-Regel
Dieses Repo soll haeufig committed und gepusht werden, damit die Planung fuer andere Agents und Menschen synchron bleibt.
Empfohlener Rhythmus:
- Nach abgeschlossenem Flow-/Screen-Paket committen.
- Nach wichtigen Nutzer-Validierungen committen.
- Nach laengeren Subframe- oder Canvas-Aenderungen pushen.
Standardbefehle:
git status --short
git add .
git commit -m "Update wireframe planning"
git push
Vor jedem Commit pruefen, dass hivegrid-cloud/ nicht staged ist.
Aktueller Remote
Das Repo soll nach git.tool-ctrl.de/david/Hivegrid-Wireframes gepusht werden. Falls Push nicht funktioniert, liegt es wahrscheinlich an SSH-/HTTPS-Zugriff oder Server-Port-Konfiguration, nicht an der lokalen Repo-Struktur.