# HiveGrid 2.0 — Session Resume Guide

> **Zweck:** Wenn du Claude clearst, gib ihm diese Datei. Er kommt damit komplett wieder rein.

## Stand: 2026-05-08 — ALLE PHASE-1-DETAIL-SPECS FERTIG ✓

Alle **35 Phase-1-Module** sind detail-spec'd. **36 Markdown-Specs + 36 PDFs** (~9 MB) liegen unter `_bmad-output/specs/`.

**Was ist passiert seit Brainstorming-Session 2026-05-07:**
1. Brainstorming-Session mit User: 13 Leitplanken, 5 Pre-mortem-Schutz, 9 Edge-Case-Schutz, 40-Modul-Phase-1/2/Raus-Schnitt, Anti-Liste, 20 Architektur-Vorschriften
2. PDF-Export Pflichtenheft-Übersicht für Noah-Review (`exports/feature-scope.pdf`)
3. **Detail-Specs für alle 35 Phase-1-Module** geschrieben (Mix aus dialogisch + Auto-Spec)
4. **PDF-Konvertierung** aller Specs (`specs/pdfs/`)
5. Stil-Vorgabe etabliert: requirements-pur (kein UI-Layout)

## Was ist der nächste Schritt?

**Ein Pflichtenheft konsolidieren** aus den 35 Detail-Specs. Sag dem nächsten Claude:

> Lies `_bmad-output/brainstorming/RESUME.md`. Erstelle aus den Detail-Specs unter `_bmad-output/specs/M*.md` ein **konsolidiertes Pflichtenheft** für HiveGrid 2.0. Ziel: ein einziges Dokument (oder strukturierter Multi-Dokument-Set), das Noah als Vertragsgrundlage durchgehen kann. Das Pflichtenheft soll:
>
> - Eine Executive-Summary mit Vision, USP-Säulen, Anti-Liste
> - Eine Modul-Übersicht (alle 35 Phase-1-Module mit Kurzbeschreibung)
> - Pro Modul die wichtigsten Anforderungen (nicht zu detailliert — Detail-Specs bleiben als Anhang)
> - Klare Schnittstellen-Definition zwischen Modulen
> - Architektur-Vorschriften als Querschnitts-Kapitel
> - Pricing-Platzhalter (geparkt) und Migration-Platzhalter (geparkt)
> - Verifikations-Workflow für Noah (was bestätigen, wann)
>
> Bewahre die Klartext-Diagnostik-Pflicht (LP-10) und die Anti-Listen-Disziplin (PM-1) durchgehend.

## Wichtige Dateien (alle persistent)

### Brainstorming + Kontext

| Datei | Was drin steht |
|---|---|
| `_bmad-output/brainstorming/brainstorming-session-2026-05-07-2206.md` | **Master-Scope** — 13 LPs, 5 PMs, 9 ECs, 40-Modul-Tabelle, Anti-Liste, 20 AVs |
| `_bmad-output/brainstorming/exports/feature-scope.pdf` | Druckbare Feature-Tabelle für Noah-Review |
| `_bmad-output/brainstorming/exports/feature-scope.html` | HTML-Version |
| `_bmad-output/brainstorming/context/hivegrid-inventory-codebase.md` | Alte Codebase (Feature-Inventur) |
| `_bmad-output/brainstorming/context/hivegrid-inventory-planning.md` | März-Planning |
| `_bmad-output/brainstorming/context/hivegrid-apple-rules.md` | Apple-App-Store-Compliance-Briefing |

### Detail-Specs (Markdown + PDF)

Pro Modul liegen Markdown unter `_bmad-output/specs/M*.md` und PDFs unter `_bmad-output/specs/pdfs/M*.pdf`.

```
_SCHEMA.md                          → Pflicht-Schema und Stilregeln
M01-crm-kern.md                     → CRM-Kern (Kontakte + Firmen + Leads)
M02-lead-inbox.md                   → Lead-Inbox
M03-sales-pipeline.md               → Sales-Pipeline (Deals)
M04-auftragspipeline.md             → Auftrags-/Projektpipeline (Geerkens-Kern)
M05-form-builder.md                 → Form Builder (XL)
M06-booking.md                      → Booking
M07-angebot-signatur.md             → Angebot + Signatur (PandaDoc/DocuSign)
M09-email-inbox.md                  → Email Inbox + Sync
M10-email-marketing.md              → Email-Marketing
M12-telefonie.md                    → Telefonie (AirCall)
M13-team-chat.md                    → Team-Chat
M14-hr-hub.md                       → HR-Hub / Mitarbeiterplattform (XL)
M15-customer-portal.md              → Customer-Portal
M17-automation-engine.md            → Automation Engine (USP-Säule)
M18-ki-layer.md                     → KI-Layer / LLM-Gateway (USP-Säule)
M19-kwp-integration.md              → KWP-Integration (USP-Säule)
M20-dashboard.md                    → Dashboard / Reporting
M21-audit-log.md                    → Audit-Log
M22-notifications.md                → Notifications
M23-files.md                        → Files / Dokumentenablage
M24-globale-suche.md                → Globale Suche
M25-calendar-sync.md                → Calendar-Sync
M26-tasks.md                        → Tasks
M27-auth-multi-tenancy.md           → Auth / Multi-Tenancy / Rollen / Permissions
M28-subscriptions-billing.md        → Subscriptions / Billing
M29-onboarding.md                   → Onboarding (branchen-modular)
M30-i18n.md                         → i18n / Mehrsprachigkeit
M31-branding.md                     → Branding / Theme
M32-feature-flags.md                → Feature-Flags
M33a-apps-engine.md                 → Apps-Engine / Adapter-Layer (USP-Foundation)
M34-public-api.md                   → Public API & Webhooks
M35-dsgvo-export.md                 → DSGVO-Export / Account-Löschung
M36-mobile-app.md                   → Mobile-App (Capacitor)
M37-plattform-admin.md              → Plattform-Admin
M38-help-center.md                  → Help-Center (öffentlich)
M39-help-desk.md                    → Help-Desk / Support
```

## Was NICHT spec'd ist (und bewusst so)

### Phase 2 / Anti-Liste (siehe Master-Scope-Dokument)

- M8 Rechnung-UI in HiveGrid (raus aus Phase 1, KWP-Native-Integration nach Termin neu evaluieren)
- M11 WhatsApp (Phase 2, kein Geerkens-Fokus)
- M16 Knowledge Base / Wiki (Phase 2)
- M33b Community-App-Marketplace (Phase 2)
- M33c Template-Marketplace (Phase 2)
- M40 CMS / Sites / Blog (komplett raus, auch Phase 2/3)

### Geparkte Themen (eigene Runden)

- Migration aus HubSpot/Quiply/KWP-Bestand
- Pricing-Modell konkret (Cloud/Cloud+/Enterprise, Trigger-Volumen, Setup-Fee, Seat-Preise)
- Sales-Flow Self-Service vs. Demo
- Nach KWP-Geschäftsführer-Termin: Native-Integration neu evaluieren (kann M19 vereinfachen)

## Wie startest du eine neue Session?

Sag dem neuen Claude:

> Wir arbeiten an HiveGrid 2.0. Bitte lies erst:
>
> 1. `_bmad-output/brainstorming/RESUME.md` (diese Datei)
> 2. `_bmad-output/brainstorming/brainstorming-session-2026-05-07-2206.md` (Master-Scope)
> 3. `_bmad-output/specs/_SCHEMA.md` (Spec-Stil + Pflicht-Schema)
> 4. Die für die Aufgabe relevanten Detail-Specs unter `_bmad-output/specs/M*.md`
>
> Dann führe Aufgabe X aus (Pflichtenheft-Konsolidierung / Detail-Spec-Verfeinerung / Implementierungs-Beratung / Verifikation mit Noah).

## Stil-Vorgaben

- **Requirements pur** — KEINE UI-Layouts, ASCII-Mockups, Anordnungs-Beschreibungen (Memory `feedback_spec_style_no_ui.md`)
- **Schema strikt einhalten** (Frontmatter + Pflicht-Sections, siehe `_SCHEMA.md`)
- **Dialogische Konversation mit Raffael** — eine Frage nach der anderen, keine Bullet-Wände (Memory `feedback_dialog_style.md`)
- **Subframe für UI** — wenn Routes implementiert werden, Subframe-Designs sind Pflicht (Memory `feedback_subframe_mandatory.md`)

## PDF-Konvertierungs-Tool

Für Re-Konvertierung der Specs:
```bash
/tmp/hivegrid-pdf-venv/bin/python /tmp/spec-to-pdf.py
```
(Nutzt virtualenv mit `markdown` + `weasyprint` + `pygments`. Konvertiert alle `*.md` aus `_bmad-output/specs/` nach `_bmad-output/specs/pdfs/`.)

## Verifikations-Workflow vor Implementierung

Vor dem Build sollte das **Pflichtenheft mit Noah verifiziert** sein. Empfohlene Reihenfolge:

1. **Pflichtenheft konsolidieren** (nächster Schritt — siehe oben)
2. **Pflichtenheft mit Noah durchgehen** (60-90 Min Termin pro Modul-Cluster)
3. **Korrekturen einarbeiten** in einzelne Detail-Specs
4. **KWP-Geschäftsführer-Termin** abwarten — kann M19 vereinfachen
5. **Pricing-Modell finalisieren** (geparkt)
6. **Boilerplate fertigstellen** (parallel zur Verifikation)
7. **Build starten** Modul für Modul, nach Cluster-Reihenfolge:
   - Block 1: Plattform-Fundament (M27, M30, M31, M32, M37)
   - Block 2: Stammdaten (M1, M2, M23, M24)
   - Block 3: Workflow-Kern (M3, M4, M26)
   - Block 4: USP-Säulen (M33a, M17, M18, M19)
   - Block 5: Kommunikation (M9, M10, M12, M13, M22, M25)
   - Block 6: Spezial (M5, M6, M7, M14, M15, M20)
   - Block 7: Plattform-Outer (M28, M29, M34, M35, M36, M38, M39, M21)