33 lines
2.4 KiB
Markdown
33 lines
2.4 KiB
Markdown
# HiveGrid 2.0 — Einstieg für Coding-Agenten
|
||
|
||
> **Zentrale Regeln stehen in [`AGENTS.md`](./AGENTS.md) — zuerst lesen.** Diese Datei ist nur der Wegweiser.
|
||
|
||
<!-- Parität: AGENTS.md wird importiert, damit Claude Code dieselben Instructions wie andere Agents im System-Prompt hat. Quelle der Wahrheit = AGENTS.md. -->
|
||
@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`](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).
|