repo-hc: Wie wir AI-Agent-Workflows standardisieren

repo-hc ist unser npm-Paket, das CLAUDE.md, AGENTS.md und eine .agents/ Wissensbasis in jedes Projekt bringt — für konsistente, auditierbare AI-Arbeit.

Wenn man täglich mit AI-Agenten arbeitet, merkt man schnell: Ohne Struktur wird jedes Projekt zur Blackbox. Der Agent tut irgendwas, irgendwie, ohne dass man nachvollziehen kann warum.

repo-hc ist unsere Antwort darauf.

Das Problem

In jedem neuen Projekt fingen wir von vorne an:

Neue CLAUDE.md schreiben (oder vergessen)
Prompts nochmal erklären
Conventions nochmal festlegen
Derselbe Fehler in der Commit-Message

Das skaliert nicht. Wenn das Team wächst oder man mehrere Projekte parallel betreut, wird das zur echten Belastung.

Die Lösung: repo-hc

npx repo-hc init

Ein Befehl, der folgendes in jedes Repository bringt:

CLAUDE.md — Anweisungen für Claude Code
AGENTS.md — Allgemeine AI-Agent-Regeln (provider-agnostisch)
.agents/ — Wissensbasis mit Rules und Skills
.agents/skills/ — Wiederverwendbare Prompt-Skills

Was reinkommt

CLAUDE.md

Eine strukturierte Anleitung für Claude Code mit:

Plan-first Execution (erst planen, dann schreiben)
Branch-Disziplin
Security-aware Changes
Commit-Konventionen

Skills

Vorgefertigte Skills, die sofort nutzbar sind:

| Skill | Beschreibung | |-------|-------------| | /commit | Strukturierte Git-Commits | | /review-pr | Code-Review nach Standards | | /simplify | Qualitätscheck nach Änderungen |

AGENTS.md

Für Teams, die nicht nur Claude Code nutzen. Die Regeln gelten für jeden AI-Agenten — Codex, OpenCode, Kiro oder andere.

Open Source & AGPL-3.0

repo-hc ist unter AGPL-3.0 lizensiert und auf GitHub verfügbar. Contributions sind willkommen — besonders neue Skills und verbesserte Rule-Sets.

npm install -g repo-hc
# oder
npx repo-hc init

GitHub →