2.4 KiB
HiveGrid 2.0 — Einstieg für Coding-Agenten
Zentrale Regeln stehen in
AGENTS.md— zuerst lesen. Diese Datei ist nur der Wegweiser.
@AGENTS.md
Arbeitsmodus (Kurzform)
- 2 Devs bauen parallel: Raffael = Kern-Kette (P1→P2→P5→P6→P7→P8→P9→P11→P12→P13, sequenziell) · Akeshan = Trabanten (Infra, P3, P4, P17, P19, dann P14/P15/P16/P20/P21). + David (Screens). Sync-Punkt: P14/P15/P16 brauchen P5.
- Arbeitsmodus: ausschließlich ticket-getrieben über Plane und die zugehörigen Ticket-Docs.
- Parallel-Schema-Regel (AD-21): Modul = eigene
prisma/schema/<modul>.prisma; Branch =prisma db push; Migration erst beim Merge.
Ein Ticket bauen
Du bekommst eine Ticket-ID → lies .planning/ticket-docs/<ID>.md (self-contained Bau-Spec) + AGENTS.md. Prüfe die blocked-by der Doc. Voller Einstiegs-Prompt: .planning/ticket-docs/README.md.
Verbindlich (Details in AGENTS.md §„Ticket-Treue, Verbesserungs-Vorschläge & Fortschritt"): strikt im Scope der Ticket-Doc/DoD bleiben, nichts erfinden (bei Lücke: Stop + Rückfrage); Verbesserungsideen nur explizit als „💡 Vorschlag (außerhalb Ticket-Scope)" ausweisen, nie still einbauen; Fortschritt stets als % der DoD melden (Done erst bei 100 %). Vor jedem Commit/Push: die Checkliste docs/AGENT-CHECKLIST.md abarbeiten (lokal typecheck+lint+test grün, passende verify:*, Footguns).
Wo finde ich was
| Was | Wo |
|---|---|
| Bau-Spec je Ticket (Einstieg) | .planning/ticket-docs/<ID>.md |
| Datenmodell (LOCKED, Vorrang P6–P9) | .planning/ENTITY-MODEL.md |
| Phasen v1/v2 | .planning/ROADMAP.md · ROADMAP-V2.md |
| Reihenfolge (Start-Tag je Ticket) | .planning/SPRINT-DAYPLAN.md |
| Requirements | .planning/REQUIREMENTS.md |
| Screen-Briefs (Designer) | .planning/designer-briefs/PXX.md |
| Architektur-Vertrag | AGENTS.md + .planning/ENTITY-MODEL.md |
| Entscheidungsregister / Warum | docs/ARCHITECTURE-DECISIONS.md |
| Pre-Push-Checkliste (lokal grün) | docs/AGENT-CHECKLIST.md |
| Live-Tickets/Status | Plane: project.tool-ctrl.de (Projekt HiveGrid) |
Datenmodell: .planning/ENTITY-MODEL.md ist alleinige Quelle (AD-20, projekt-zentrisch).