Files

33 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).