60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
# 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:
|
|
|
|
1. Nach abgeschlossenem Flow-/Screen-Paket committen.
|
|
2. Nach wichtigen Nutzer-Validierungen committen.
|
|
3. Nach laengeren Subframe- oder Canvas-Aenderungen pushen.
|
|
|
|
Standardbefehle:
|
|
|
|
```bash
|
|
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.
|