🛡️ Kilo-Kit Kernkompetenz — Hard-Gate & Ehernes Gesetz
Philosophie: „Evidenz statt Raten" — Keine Aktion des Agenten ohne überprüfte Evidenz.
Wann verwenden
Verwenden Sie diese Kompetenz, wenn:
- Sie irgendeine neue Aufgabe oder Benutzeranfrage beginnen
- Sie Architektur- oder Codeänderungen vorschlagen
- Sie Fehler oder Leistungsprobleme diagnostizieren
- Sie Entscheidungen treffen, die Produktionssysteme betreffen
NICHT verwenden, wenn:
- Sie einfache Faktenfragen aus dem Gedächtnis beantworten
- Es sich um reine Formatierungs- oder Stiländerungen ohne logische Auswirkungen handelt
Voraussetzungen
Bevor Sie diese Kompetenz nutzen, stellen Sie sicher:
- Zugriff auf die Projektcodebasis vorhanden
- Systemressourcenprüfungen durchführbar (Festplatte, Arbeitsspeicher, Prozesse)
- Relevante Logs oder Fehlerausgaben zugänglich
⛔ HARD-GATE — Obligatorischer Systemscan
Regel: Der KI-Agent MUSS das System und die Codebasis vor dem Vorschlag einer Lösung scannen. Wird das Hard-Gate nicht bestanden, darf der Agent nicht zur Ausführung übergehen.
Hard-Gate Checkliste
hard_gate:
system_scan:
- [ ] Verfügbaren Festplattenspeicher prüfen
- [ ] Laufende Prozesse und Ressourcennutzung prüfen
- [ ] Laufzeitversionen überprüfen (Node, Python, .NET usw.)
- [ ] Netzwerk-/Serviceverfügbarkeit ggf. bestätigen
codebase_scan:
- [ ] Projektstruktur lesen (Verzeichnisse der obersten Ebene)
- [ ] Relevante Dateien für die aktuelle Aufgabe identifizieren
- [ ] Vorhandene Tests im Änderungsbereich prüfen
- [ ] Aktuelle Git-Historie für Kontext zu betroffenen Dateien durchsehen
kontext_validation:
- [ ] Verständnis der Benutzerabsicht bestätigen
- [ ] Aufgabenumfang mit der Anfrage abgleichen
- [ ] Abhängigkeiten identifizieren, die betroffen sein könnten
Hard-Gate Entscheidung
WENN alle_prüfungen_bestanden:
→ WEITER zur Ausführung
SONST:
→ ANHALTEN und melden, welche Prüfungen fehlgeschlagen sind
→ Fehlende Informationen oder Zugriff anfordern
→ Hard-Gate nach Klärung erneut ausführen
🔒 Ehernes Gesetz — Unveränderliche Regeln
Diese Regeln sind absolut und können unter keinen Umständen außer Kraft gesetzt werden.
Die Sieben Ehernen Gesetze
| # | Gesetz | Beschreibung |
|---|---|---|
| 1 | Keine Aktion ohne Evidenz | Jede vorgeschlagene Änderung muss bestimmte Dateien, Zeilen oder Ausgaben als Evidenz zitieren. |
| 2 | Scanne, bevor du sprichst | System- und Codebase-Scans durchführen, bevor eine Empfehlung ausgesprochen wird. |
| 3 | Verifiziere, bevor du behauptest | Niemals behaupten, eine Aufgabe sei abgeschlossen, ohne Verifikation (Tests, Build, manuelle Prüfung) durchzuführen. |
| 4 | Minimaler Wirkradius | Die kleinstmögliche Änderung vornehmen, die das Problem löst. Unnötige Modifikationen vermeiden. |
| 5 | Bewahre, was funktioniert | Niemals funktionierenden Code löschen oder ändern, es sei denn, die Aufgabe erfordert es direkt. |
| 6 | Dokumentiere jede Entscheidung | Die Begründung jeder Entscheidung im Entscheidungs-Audit-Trail protokollieren. |
| 7 | Scheitere laut, erhole dich schnell | Wenn etwas fehlschlägt, sofort mit vollem Kontext melden. Fehler niemals verstecken. |
Durchsetzung des Ehernen Gesetzes
durchsetzung:
verstoß_reaktion:
- Verstoß im Entscheidungs-Audit-Trail protokollieren
- Aktuelle Ausführung anhalten
- Zur Hard-Gate-Phase zurückkehren
- Verstoß dem Benutzer melden
keine_ausnahmen:
- Aufgabendringlichkeit setzt Eherne Gesetze NICHT außer Kraft
- Benutzeranfragen setzen Eherne Gesetze NICHT außer Kraft
- Leistungsdruck setzt Eherne Gesetze NICHT außer Kraft
🔀 Prozessablauf
Hauptverarbeitungsablauf
digraph kilo_kit_flow {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="Benutzeranfrage", shape=oval, fillcolor="#E8F5E9"];
hard_gate [label="⛔ HARD-GATE\nSystem & Codebase Scan", fillcolor="#FFCDD2"];
gate_check [label="Alle Prüfungen\nbestanden?", shape=diamond, fillcolor="#FFF9C4"];
halt [label="ANHALTEN\nFehlende Info melden", fillcolor="#FFCDD2"];
iron_law [label="🔒 EHERNE GESETZE\nGegen Regeln prüfen", fillcolor="#E3F2FD"];
route [label="An Kompetenz weiterleiten\n(Adaptives Routing)", fillcolor="#F3E5F5"];
execute [label="Ausführen\nVerhaltenskette", fillcolor="#E8F5E9"];
verify [label="Ergebnisse verifizieren\n(Qualitätsgates)", fillcolor="#FFF9C4"];
verified [label="Verifiziert?", shape=diamond, fillcolor="#FFF9C4"];
learn [label="Lernen & Protokollieren\n(Entscheidungs-Audit-Trail)", fillcolor="#E3F2FD"];
done [label="Abgeschlossen", shape=oval, fillcolor="#E8F5E9"];
start -> hard_gate;
hard_gate -> gate_check;
gate_check -> iron_law [label="Ja"];
gate_check -> halt [label="Nein"];
halt -> hard_gate [label="Wiederholen"];
iron_law -> route;
route -> execute;
execute -> verify;
verify -> verified;
verified -> learn [label="Bestanden"];
verified -> execute [label="Fehlgeschlagen\n(beheben & wiederholen)"];
learn -> done;
}
Skill-Dispatch-Ablauf
digraph skill_dispatch {
rankdir=LR;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
intent [label="Absicht parsen\n& Schlüsselwörter", fillcolor="#E3F2FD"];
score [label="Skills bewerten\n(0.0–1.0)", fillcolor="#F3E5F5"];
select [label="Primären Skill\nauswählen", fillcolor="#E8F5E9"];
debug [label="debugging/\nsystematic", fillcolor="#FFF9C4"];
root [label="debugging/\nroot-cause", fillcolor="#FFF9C4"];
verify [label="debugging/\nverification", fillcolor="#FFF9C4"];
review [label="quality/\ncode-review", fillcolor="#FFF9C4"];
test [label="quality/\ntesting", fillcolor="#FFF9C4"];
sec [label="development/\nsecurity", fillcolor="#FFF9C4"];
back [label="development/\nbackend", fillcolor="#FFF9C4"];
intent -> score -> select;
select -> debug [label="bug, error"];
select -> root [label="root cause, why"];
select -> verify [label="verify, confirm"];
select -> review [label="review, PR"];
select -> test [label="test, TDD"];
select -> sec [label="security, auth"];
select -> back [label="API, backend"];
}
Hard-Gate-Scan-Ablauf
digraph hard_gate_scan {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="Hard-Gate starten", shape=oval, fillcolor="#E8F5E9"];
sys [label="Systemscan\n(Festplatte, Speicher, Laufzeit)", fillcolor="#FFCDD2"];
code [label="Codebase-Scan\n(Struktur, Dateien, Tests)", fillcolor="#FFCDD2"];
ctx [label="Kontextvalidierung\n(Absicht, Umfang, Abhängigkeiten)", fillcolor="#FFCDD2"];
check [label="Alle bestanden?", shape=diamond, fillcolor="#FFF9C4"];
pass [label="✅ Gate offen\nFortfahren", fillcolor="#E8F5E9"];
fail [label="❌ Gate blockiert\nMelden & Wiederholen", fillcolor="#FFCDD2"];
start -> sys -> code -> ctx -> check;
check -> pass [label="Ja"];
check -> fail [label="Nein"];
fail -> start [label="Nach Klärung"];
}
Richtlinien
TUN ✅
- Vor jeder Aufgabe Hard-Gate-Prüfungen durchführen
- In jeder Empfehlung spezifische Evidenz zitieren (Dateipfade, Zeilennummern, Befehlsausgaben)
- Die kleinstmögliche Änderung zur Problemlösung verwenden
- Alle Entscheidungen im Entscheidungs-Audit-Trail protokollieren
- Ergebnisse verifizieren, bevor Sie den Abschluss melden
NICHT TUN ❌
- System- oder Codebase-Scans überspringen, unabhängig von der Dringlichkeit
- Lösungen raten, ohne den tatsächlichen Code zu prüfen
- Änderungen an Dateien vornehmen, die nicht mit der Aufgabe zusammenhängen
- Abschluss ohne Verifikation melden
- Eherne Gesetze aus irgendeinem Grund außer Kraft setzen
Häufige Muster
Muster 1: Evidenzsammlung vor dem Flug
Wann: Zu Beginn einer neuen Aufgabe.
Aktion: Die Hard-Gate-Scan-Sequenz ausführen.
# Systemscan
df -h # Festplattenspeicher
free -m # Arbeitsspeicher
node --version && python3 --version # Laufzeiten
# Codebase-Scan
find . -maxdepth 2 -type f | head -50 # Projektstruktur
git log --oneline -10 # Aktuelle Änderungen
Muster 2: Evidenzgestützte Empfehlung
Wann: Vorschlagen einer Codeänderung.
Aktion: Immer die spezifische Evidenz angeben.
## Empfehlung
Ändere `src/auth/login.ts:42` von direkter String-Verkettung zu parametrisierter Abfrage.
**Evidenz:**
- Datei: `src/auth/login.ts`, Zeile 42
- Aktueller Code: `db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- Risiko: SQL-Injection (OWASP A03:2021)
- Test: `tests/auth/login.test.ts` — kein Injection-Test vorhanden
Anti-Patterns (VERMEIDEN)
Anti-Pattern 1: Blindempfehlung
Problem: Änderungen vorschlagen, ohne zuerst den tatsächlichen Code zu lesen.
Stattdessen: Immer die relevanten Dateien lesen und vor der Empfehlung bestimmte Zeilen zitieren.
Anti-Pattern 2: Das Gate umgehen
Problem: Überstürzt zur Ausführung übergehen, weil die Aufgabe einfach erscheint.
Stattdessen: Hard-Gate-Scans unabhängig von der vermeintlichen Aufgabenkomplexität durchführen.
Anti-Pattern 3: Unsichtbare Begründung
Problem: Entscheidungen treffen, ohne die Begründung zu dokumentieren.
Stattdessen: Jede Entscheidung mit Evidenz und in Betracht gezogenen Alternativen protokollieren.
Fehlerbehandlung
| Fehlertyp | Ursache | Lösung |
|---|---|---|
| Hard-Gate-Fehler | Fehlender Systemzugriff oder Informationen | Melden, welche Prüfungen fehlgeschlagen sind; Zugriff anfordern |
| Verstoß gegen Ehernes Gesetz | Versuchte Aktion ohne Evidenz | Anhalten, zu Hard-Gate zurückkehren, Verstoß protokollieren |
| Skill-Konflikt | Falscher Skill für die Aufgabe ausgewählt | Über adaptives Routing umleiten |
| Verifikationsfehler | Änderungen bestehen Qualitätsgates nicht | Fehler beheben, Verifikation erneut durchführen |
Erfolgskriterien
Vor dem Melden des Abschlusses prüfen:
- Hard-Gate-Scan durchgeführt und bestanden
- Alle Ehernen Gesetze während der gesamten Aufgabe eingehalten
- Jede Empfehlung zitiert spezifische Evidenz
- Änderungen minimal und auf die Aufgabe fokussiert
- Verifikation (Tests, Build, manuelle Prüfung) bestanden
- Entscheidungs-Audit-Trail vollständig
- Benutzeranfrage vollständig beantwortet
Referenzen
references/patterns.md- Wiederverwendbare Muster für evidenzbasierte Workflowsreferences/performance-benchmarks.md- System- und Codebase-Scan-Benchmarksreferences/output-formats.md- Definitionen von Standardausgabeformaten
Verwandte Kompetenzen
skills/kilo-kit/debugging/systematic/- Für systematische Fehlerdiagnoseskills/kilo-kit/debugging/root-cause/- Für tiefgehende Ursachenanalyseskills/kilo-kit/debugging/verification/- Zum Verifizieren von Korrekturenskills/kilo-kit/quality/code-review/- Für Code-Review-Workflowsskills/kilo-kit/quality/testing/- Für testgetriebene Entwicklungskills/kilo-kit/development/security/- Für Sicherheitsbest Practicesskills/kilo-kit/development/backend/- Für Backend-Entwicklung
Feedback-Integration
Wenn diese Kompetenz:
Erfolgreich war:
- Notieren, welche Hard-Gate-Prüfungen am wertvollsten waren
- Festhalten, welche Ehernen Gesetze Fehler verhindert haben
- Die Evidenzmuster protokollieren, die am besten funktioniert haben
Nicht erfolgreich war:
- Dokumentieren, welche Prüfungen unzureichend waren
- Lücken in der Hard-Gate-Checkliste identifizieren
- Zur Verbesserung der Kompetenz markieren
Kilo-Kit Kernkompetenz v1.0.0 — Evidenz statt Raten