Shuffle/README.md

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

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__*.