# 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, Subframe-Handoffs und Ticket-Handoff-Dateien. Die HiveGrid-Cloud-Referenz liegt im Ordner `03 Quellen und Referenzen/hivegrid-cloud/` und wird mit diesem Repo mitgepusht, damit Planning, Ticket-Docs und Code-Kontext fuer alle Agents/Menschen verfuegbar bleiben. ## Start jeder Arbeit Bevor neue Planung, Research oder Subframe-Arbeit beginnt, immer den Stand von `03 Quellen und Referenzen/hivegrid-cloud/` pruefen und bei Bedarf aktualisieren: ```bash cd "03 Quellen und Referenzen/hivegrid-cloud" git status --short git pull --ff-only ``` Gemeint ist der lokale Ordner `./03 Quellen und Referenzen/hivegrid-cloud/`. Wenn fuer die aktuelle Aufgabe ein bestimmter Branch oder Pull Request in HiveGrid Cloud relevant ist, diesen Stand dort zuerst auschecken bzw. aktualisieren und erst danach die Planung in diesem Wireframe-Repo bearbeiten. Relevante Planning-/Ticket-Aenderungen in der HiveGrid-Cloud-Referenz sollen zusammen mit dem Wireframe-Repo committed und gepusht werden. ## Wichtige Bereiche | Pfad | Zweck | |---|---| | `00 Start Here.md` | Einstieg in den Vault | | `Todo.md` | Zentrale, projektweite und abhakbare Aufgabenliste | | `01 Regeln/` | Arbeitsregeln fuer Wireframing, Obsidian, Subframe und Brainstorming | | `01 Regeln/Screen Agent Workflow.md` | Operative Checkliste fuer AI-Agenten bei Screen-/Flow-Arbeit | | `02 Wireframes/Screen Paket Tracker.md` | Zentrale Paket- und Flow-Uebersicht | | `02 Wireframes/P2 …/` | Eigenständige Auth-/Account-/Admin-Toolordner, jeweils mit eigenem Wireframe-Paket | | `02 Wireframes/_Templates/` | Vorlagen fuer neue Pakete und Screens | | `03 Quellen und Referenzen/` | Quellen, Referenz-Repos und Repo-Hinweise | | `03 Quellen und Referenzen/hivegrid-cloud/` | Mitgepushte HiveGrid-Cloud-Referenz inklusive Planning und Ticket-Docs | | `04 Standards/Subframe UI Standards/` | Eigenes Standards-Projekt fuer dauerhafte Subframe-, Komponenten- und Layout-Standards | | `Tickets/` | Ticket-Handoff-Index | | `Tickets/Fertige Tickets/` | Fertige oder handofffaehige Ticket-Zusammenfassungen | ## Arbeitsregeln - Fuer Screen-/Flow-Arbeit zuerst `01 Regeln/Screen Agent Workflow.md` lesen und anwenden. Die Brainstorming-Datei dazu ist nur Archiv, nicht operative Regel. - Danach die bestehenden Detailregeln lesen, besonders `01 Regeln/Wireframing Playbook.md`. - Die Subframe UI Standards unter `04 Standards/Subframe UI Standards/` sind ein eigenes Standards-Projekt. Sie dienen als Referenz fuer dauerhafte Subframe-, Komponenten- und Layout-Standards, duerfen aber bei normaler Screen-Arbeit nicht nebenbei geaendert werden. - Aenderungen an den Subframe UI Standards sind nur erlaubt, wenn David explizit daran arbeiten will oder eine konkrete systemweite Regel vorher validiert wurde. - 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. - Bei jeder Screen-Umbenennung, Screen-Aufteilung, Screen-Loeschung oder neuem Subframe-Screen muss der komplette Sync geprueft werden: Screen-Datei, Paket-MD, `Screen Paket Tracker`, Canvas und Subframe-Flow. Wenn daraus mehrere echte Screens entstehen, brauchen sie eigene Tracker-Zeilen und eigene Canvas-Nodes. - Wenn eine moegliche Screen-Aufteilung noch nicht von David validiert ist, nur als offene Entscheidung dokumentieren und keine neuen Subframe-Screens anlegen. - Backlog-Punkte klar markieren, damit V2-Themen nicht verloren gehen. - Wenn ein Ticket fertig oder uebergabereif ist, immer eine Ticket-Handoff-Datei in `Tickets/Fertige Tickets/` anlegen bzw. aktualisieren. Formatvorlage ist `Tickets/Fertige Tickets/D-P2 Auth Wireframes.md`. - Bei Subframe-Arbeit bestehende Nutzer-Anpassungen nicht rueckgaengig machen. - `03 Quellen und Referenzen/hivegrid-cloud/` als Referenz und Planning-Quelle verwenden; relevante Updates mittracken. ## Subframe-Kontext Subframe-Links stehen in den jeweiligen Screen-Dateien im Frontmatter-Feld `subframe`. Bei jeder Subframe-MCP-Arbeit an Screens oder Modalen muessen die validierten Layout-Standards als Referenz genutzt werden: - Vor dem Prompten oder Editieren `04 Standards/Subframe UI Standards/Layout/README.md` lesen. - Im Subframe-Prompt explizit sagen, dass die Layout-Regeln aus den Subframe UI Standards einzuhalten sind. - Page Padding, Card/Surface Padding, Text-Rhythmus, Dialogbreiten, Dialog-Padding und Dialog-Internal-Gaps nicht frei nachbauen, sondern die Standards und vorhandenen Komponenten-Defaults verwenden. - Wenn eine Subframe-Komponente den Standard bereits intern abbildet, diese Komponente/Variante nutzen statt manuelle Tailwind- oder Container-Overrides zu setzen. - Nach MCP-Aenderungen per Readback pruefen, ob die relevante Struktur und die Layout-Standards tatsaechlich angewendet wurden. Modal-Screens muessen als echte Subframe-Dialoge gebaut werden: - Struktur: `DialogLayout` -> `Dialog` -> `Dialog.Content` -> Modal-Inhalt. - Nicht erlaubt: Modal per `Card`, freiem `div`, absolutem Overlay, Blur-Hintergrund oder Fullscreen-Container nur visuell nachbauen. - Beim Subframe-Prompt fuer jedes Modal explizit die echte Dialog-Struktur verlangen; sonst baut Subframe haeufig nur ein Fake-Modal nach. - Vor Handoff per `get_page_info` pruefen, ob `Dialog` importiert wird und `Dialog.Content` im JSX existiert. - Layout bevorzugt mit Subframe-Komponenten und Auto Layout/Flex aufbauen. - Custom Tailwind-Klassen nur verwenden, wenn sie fuer feste Groessen, Max-Breiten, Scroll-/Overflow-Verhalten oder responsive Constraints wirklich noetig sind. ## 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 keine fremden lokalen Aenderungen wie `.obsidian/workspace.json` oder unrelated Canvas-Aenderungen versehentlich committed werden. `03 Quellen und Referenzen/hivegrid-cloud/` darf und soll mitgestaged werden, wenn dort Planning-, Ticket- oder Referenzstand fuer die aktuelle Arbeit relevant ist. ## Aktueller Remote Das Repo soll nach `git.hg-int.dev/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.