drift: Skill for Claude Code

Drift Evidence Artifact Authoring Skill

Dieser Skill produziert ein vollständiges, commit-readies vX.Y.Z_<feature-slug>_feature_evidence.json in benchmark_results/.

Wann Verwenden

• feat: commit geplant und drift-commit-push beanstandet fehlendes Evidence-File
• Neues Signal oder materielle Heuristikänderung abgeschlossen
• Precision-/Recall-Änderung > 5 Prozentpunkte vorhanden und zu belegen
• Signal-Fix oder FP-Reduktion mit empirischen Belegen versehen

Pflicht-Vorbedingungen

1. Tests laufen durch (make test-fast grün)
2. ADR vorhanden oder Entscheidung explizit als fix/refactor eingestuft
3. Version aus pyproject.toml oder geplanter nächster Version bekannt
4. git diff --stat zeigt, welche Dateien tatsächlich geändert wurden

---

Step 1: Evidence-Datei deterministisch generieren (PRIMÄRE METHODE)

Ab Gate 2b ist manuelles Erstellen von Evidence-Dateien für neue feat:-Commits nicht zulässig. Der Pre-Push-Hook verifiziert, dass die Datei maschinell erzeugt wurde.

Befehl:

python scripts/generate_feature_evidence.py --version X.Y.Z --slug my-feature

Das Script:

1. Läuft drift analyze --repo . --format json --exit-zero → erfasst drift_score, total_findings
2. Läuft pytest tests/ -q --tb=short -m not slow -n auto → erfasst total_passing, total_failing
3. Läuft pytest tests/test_precision_recall.py → erfasst Precision/Recall (optional via --skip-precision-recall)
4. Bettet einen generated_by-Block mit git_sha, Timestamp und Script-Name ein
5. Schreibt benchmark_results/vX.Y.Z_{slug}_feature_evidence.json

Flags:

--version X.Y.Z         Semver-Version (Pflicht)
--slug    my-feature    Kebab-Case-Slug (Pflicht)
--feature "Text"        Kurzbeschreibung (optional, Default: Slug)
--skip-tests            Nur Self-Analysis (kein pytest)
--skip-precision-recall Precision-Recall-Suite überspringen

Validierung manuell prüfen:

python scripts/validate_feature_evidence.py \
    benchmark_results/vX.Y.Z_my-feature_feature_evidence.json \
    --require-generated-by --push-head $(git rev-parse HEAD)