38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
# 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__*`.
|