No description
Karpathy-inspired: minimal code for the exact problem, and verifiable success criteria (test-first where sensible). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| principles | ||
| skills | ||
| stacks | ||
| templates | ||
| readme.md | ||
Vibe-Grundlagen
Universelle Programmier-Prinzipien und Stack-spezifische Konventionen fuer die Verwendung mit Claude Code.
Einbindung in Projekte
1. Als Git Submodule hinzufuegen
git submodule add <dieses-repo> vibe-grundlagen
2. Template kopieren und anpassen
cp vibe-grundlagen/templates/CLAUDE.md.example CLAUDE.md
In der kopierten CLAUDE.md:
- Projektinfos ausfuellen
- Relevante Stack-Dateien einkommentieren
- Projektspezifische Regeln ergaenzen
3. Submodule aktuell halten
git submodule update --remote vibe-grundlagen
Struktur
principles/ — Universelle Prinzipien (sprachunabhaengig)
| Datei | Inhalt |
|---|---|
ai-agent-workflow.md |
AI-Agent Arbeitsweise, Planung, Dokumentation |
api-design.md |
Response-Schema, Endpoint-Naming, Pagination |
architecture.md |
Layered Architecture, DRY, zentrale Module, Logging |
error-handling.md |
End-to-End Error Flow, Klassifikation, Retry, DLQ |
security.md |
Validierung, Auth, XSS, File-Uploads, sensible Daten |
database.md |
ORM, Migrations, Timestamps, Race Conditions |
frontend-ux.md |
Loading States, User Feedback, Komponenten-Philosophie |
testing.md |
Test-Strategie, was testen, was nicht |
i18n.md |
Mehrsprachigkeit, Locale-Formatting |
background-jobs.md |
Queues, Idempotenz, Retry, Scheduling |
release-workflow.md |
Changelog, Deploy-Reihenfolge, Rollback |
stacks/ — Stack-spezifische Konventionen
| Datei | Stack |
|---|---|
python-fastapi.md |
Python + FastAPI |
typescript-react-nextjs.md |
TypeScript + React + Next.js |
sqlalchemy-alembic.md |
SQLAlchemy 2.0 + Alembic |
tailwind.md |
Tailwind CSS |
testing-tools.md |
pytest, Vitest, MSW |
php-twig.md |
PHP + Twig |
skills/ — Claude Code Skills
Wiederverwendbare Skills fuer Claude Code.
templates/ — Vorlagen
| Datei | Zweck |
|---|---|
CLAUDE.md.example |
Template fuer Projekt-CLAUDE.md mit Submodule-Pattern |