keksdestodes/vibe-grundlagen
Watch
1
0
Fork
You've already forked vibe-grundlagen
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
14 commits 1 branch 0 tags 110 KiB
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Sebastian Vogt 3bc073b2ee docs(readme): Subtree als Einbindungs-Variante ergaenzen 
Submodule bleibt Standard; Subtree empfohlen fuer Worktree-lastige
Workflows (Dateien in jedem Checkout vorhanden, Updates als PR).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-12 17:43:55 +02:00
principles feat(principles): ai-delegation — Model-Tiers, Eskalation, Workflow-Opt-in 2026-08-12 15:54:18 +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 feat(principles): ai-delegation — Model-Tiers, Eskalation, Workflow-Opt-in 2026-08-12 15:54:18 +02:00
readme.md docs(readme): Subtree als Einbindungs-Variante ergaenzen 2026-08-12 17:43:55 +02:00

readme.md

Vibe-Grundlagen

Universelle Programmier-Prinzipien und Stack-spezifische Konventionen fuer die Verwendung mit Claude Code.

Einbindung in Projekte

1. Repo einbinden — Submodule oder Subtree

Variante A: Submodule (Standard fuer einfache Repos)

git submodule add <dieses-repo> vibe-grundlagen
git submodule update --remote vibe-grundlagen   # aktualisieren

Nachteil: In frischen Worktrees und Clones ist das Submodule leer, bis git submodule update --init laeuft — Agent-Sessions verlieren die Regeln dann stillschweigend.

Variante B: Subtree (empfohlen bei Worktree-lastigen Workflows)

Echte getrackte Dateien — in jedem Worktree, CI-Checkout und Clone ohne Zusatzschritt vorhanden. Updates laufen als normaler, reviewbarer PR:

git subtree add  --prefix=vibe-grundlagen <dieses-repo> main --squash   # einmalig
git subtree pull --prefix=vibe-grundlagen <dieses-repo> main --squash   # aktualisieren

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

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
environments-deployment.md Dev/Stage/Live, Branching, CI/CD, Prod-Gate
ai-autonomy.md Delegations-Check, Leitplanken fuer Langlaeufer, Rollback via Git
spec-workflow.md 8-Fragen-Spec, Non-Goals, Vertical-Slice-Tickets
ai-delegation.md Subagenten: Model-Tiers, Eskalation, Workflow-Opt-in

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