# Shuffle – Starter-Kit

Grundgerüst für die Entwicklung der Brettspiel-App **Shuffle** mit spezialisierten Claude-Code-Agents.
Die vollständige Schritt-für-Schritt-Anleitung liegt als separates Dokument bei.

## Inhalt
| Pfad | Zweck |
|---|---|
| `CLAUDE.md` | Projektkontext, Regeln, Definition of Done – wird in jeder Session geladen |
| `.claude/agents/` | 9 spezialisierte Subagents |
| `.claude/commands/` | Workflows: `/intake`, `/feature`, `/review`, `/adr`, `/release` |
| `.claude/settings.json` | Berechtigungen (erlaubt/nachfragen/verboten) und Hooks |
| `.claude/hooks/` | Auto-Format für Dart, Schutz bestehender Migrationen |
| `.mcp.json` | MCP-Server: Forgejo, Outline, Dart, Playwright |
| `.forgejo/` | CI-Pipeline, Issue- und PR-Vorlagen |
| `docs/` | ADR-0001 (Tech-Stack-Vorschlag), Vorlagen für Specs und ADRs |
| `requirements/` | Ablage für deine fachlichen Anforderungen |
| `supabase/` | R1-Datenbank: Migrationen, RLS-Policies, pgTAP-Tests, Seed |
| `scripts/` | Setup-Check, Forgejo-Labels |

## Schnellstart
```bash
cp -r shuffle-starter ~/dev/shuffle && cd ~/dev/shuffle
chmod +x .claude/hooks/*.sh scripts/*.sh
./scripts/check-setup.sh
git init -b main && git add . && git commit -m "chore: project scaffold"
```
Danach weiter mit Phase 2 der Anleitung.

## MCP-Zugänge einrichten
Die Server in `.mcp.json` lesen ihre Zugangsdaten aus Umgebungsvariablen (nie ins Repo):

| Variable | Zweck |
|---|---|
| `FORGEJO_URL`, `FORGEJO_ACCESS_TOKEN` | Forgejo (Issues, PRs) |
| `OUTLINE_API_KEY` | Outline (Doku). In Outline unter *Einstellungen → API* einen Schlüssel anlegen und z. B. in `~/.zshenv` als `export OUTLINE_API_KEY=…` setzen; Claude Code danach neu starten. |

Outline-Endpunkt: `https://outline.cshomelabs.work/mcp`. Ist zusätzlich ein Outline-Connector in der Claude-App aktiv, sind die Tools doppelt vorhanden; die Agents nutzen `mcp__outline__*`.