General Codebase Template

Generisches Boilerplate fuer Claude-Code-getriebene SaaS- und Web-Dev-Projekte. Klonen, initialisieren, sofort produktiv arbeiten — mit eingebauter 6-Rollen-Agenten-Architektur, Wissensmanagement-Layer und Sicherheits-Defaults.

Was ist das

Ein Repo-Skelett, das die wiederkehrenden Bestandteile eines professionellen Claude-Code-Projekts vorbereitet:

• 6 spezialisierte Agent-Rollen (Requirements, Solution Architect, Frontend, Backend, QA, DevOps) mit klarer Sequenz und isolierten Verantwortungen
• features/-Ordner als Single Source of Truth pro Feature — User Stories, Tech-Design, Akzeptanzkriterien, QA-Report, Deployment-Status in einer Markdown-Datei
• Wiki-Layer (Decisions, Briefings, Glossar) fuer Entscheidungen und Wissen, das nicht in den Code gehoert
• Memory-Pattern fuer Claude (User-/Feedback-/Project-/Reference-Eintraege mit Frontmatter)
• Slash-Commands und Hooks als Skeletons fuer eigene Automation
• Sicherheits-Defaults: .env-Hygiene, RLS-Doku, WebFetch-Quarantaene, Audit-Skript

Annahme: Du bist mit Claude Code unterwegs und baust eine Web-App. Default-Tech-Stack ist Next.js + Supabase + Vercel + ShadCN — aber jeder Teil ist austauschbar.

Tech-Stack (Default-Annahme)

Layer	Default
Frontend	Next.js (App Router) + ShadCN-Komponenten
Backend	Supabase (Postgres + Auth + RLS)
Hosting	Vercel
Agent-Harness	Claude Code
MCP	Supabase MCP + GitHub MCP (Beispiel-Konfig in .mcp.json.example)

Stack-Wechsel: passe CLAUDE.md (Project-Context), .mcp.json.example und docs/SECURITY.md entsprechend an. Die Agent-Rollen sind tech-agnostisch beschrieben — du kannst ohne Vorlagen-Bruch auf Remix, SvelteKit oder ein anderes Backend wechseln.

Quick Start

# 1. Klonen
git clone <DEINE-REPO-URL> mein-neues-projekt
cd mein-neues-projekt

# 2. Initialisieren (ersetzt Platzhalter in CLAUDE.md, README, LICENSE, STATUS.md)
# Windows
.\scripts\init-project.ps1
# macOS / Linux
./scripts/init-project.sh

# 3. .env.local anlegen (kopiere .env.example, falls vorhanden)
# 4. Erstes Feature starten — siehe docs/GETTING_STARTED.md

Detaillierter Einstieg: docs/GETTING_STARTED.md.

Der 6-Rollen-Workflow

Jedes Feature laeuft durch sechs Phasen, ideal jeweils in einer eigenen Claude-Session, um Context-Overload zu vermeiden. Alle Rollen lesen und schreiben in dieselbe Feature-Datei unter features/.

#	Rolle	Verantwortung
1	Requirements Engineer	User Stories, Akzeptanzkriterien, Edge Cases
2	Solution Architect	DB-Schema, API-Design, Komponenten-Plan, Implementierungs-Reihenfolge
3	Backend Developer	Tabellen + RLS, API-Routes, Rate-Limiting, Server-Validation
4	Frontend Developer	UI-Komponenten, Form-Validation, Loading/Error-States
5	QA Engineer	Pruefung gegen Akzeptanzkriterien, Edge-Cases, Security-Check
6	DevOps Engineer	CI/CD, Env-Vars, Production-Deploy, Smoke-Test

Vollstaendige Beschreibung mit Best Practices und Anti-Patterns: docs/WORKFLOW.md. Detail-Specs je Rolle: agents/.

Wichtig: Backend kommt vor Frontend — die Datenstrukturen und RLS-Policies muessen stehen, bevor das UI darauf zugreift.

Ordner-Map

.claude/      Claude-Code-Settings, lokale Skills, Plan-Mode-Files
agents/       Die 6 Agent-Rollen (jeweils AGENT.md mit Spec)
commands/     Slash-Command-Vorlagen (/feature-start, /security-audit, ...)
hooks/        Event-Hook-Skeletons (PreToolUse, PostToolUse, SessionStart, ...)
features/     Single Source of Truth pro Feature (Markdown)
wiki/         Decisions, Briefings, Glossar
memory/       Claude-Memory-Pattern (4 Typen: User / Feedback / Project / Reference)
docs/         Anleitungen (Getting Started, Workflow, Patterns, Security, Skills)
scripts/      Init- und Audit-Skripte
src/          Anwendungs-Code (initial leer)

Konventions-Details: docs/PATTERNS.md.

Anpassung

Das Template ist als Startpunkt gedacht, nicht als Korsett. Empfohlene Anpassungs-Hebel:

• Anderer Tech-Stack: CLAUDE.md Project-Context und .mcp.json.example ueberschreiben
• Weniger Rollen: unbenutzte Agents-Ordner loeschen, STATUS.md entsprechend kuerzen
• Kein Wiki gewuenscht: wiki/-Ordner entfernen, Hinweis in CLAUDE.md raus
• Eigene Skills: unter .claude/skills/ nach Vorlage _TEMPLATE/SKILL.md neue Skills anlegen
• Eigene Hooks: Beispiel-Hooks in hooks/ umbenennen (.example.py → .py) und in .claude/settings.json registrieren

Sicherheit

Vor dem ersten Commit:

• .env* ist via .gitignore ausgeschlossen — pruefen mit git status
• .mcp.json (mit echten Tokens) ist via .gitignore ausgeschlossen — nur .mcp.json.example commiten
• scripts/privacy-audit.{ps1,sh} laufen lassen — wirft Treffer, falls Platzhalter oder geheime Patterns drin sind

Details: docs/SECURITY.md.

Lizenz

MIT — siehe LICENSE.

Attribution

Strukturell inspiriert von folgenden oeffentlichen Repos (alle MIT, abgerufen 2026-05-18, kein Code-/Text-Reuse):

• github.com/mattpocock/skills — Skill-Frontmatter-Standard und 5er-Sektionen-Aufbau
• github.com/affaan-m/everything-claude-code — 6-Phasen-Hook-Architektur, Flat-Skills-Layout
• github.com/davila7/claude-code-templates — Plug-and-Play-Komponenten-Idee

Workflow-Konzept (6 Rollen, isolierte Sessions, Feature-Markdown als SSoT) angelehnt an oeffentliche Claude-Code-Best-Practice-Beitraege.