No description
Find a file
Sebastaian Vogt 86b1ecf75e Add Simplicity First and Goal-Driven Execution principles
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>
2026-04-14 21:03:49 +02:00
principles Add Simplicity First and Goal-Driven Execution principles 2026-04-14 21:03:49 +02:00
skills Remove brand name from publish skill 2026-04-06 23:21:26 +02:00
stacks Restructure: replace flat files with principles/ and stacks/ structure 2026-04-06 21:15:36 +02:00
templates Add CLAUDE.md repo docs and project template 2026-04-06 22:13:00 +02:00
readme.md readme.md aktualisiert 2026-04-07 12:56:35 +00:00

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