Konformitäts-Gate

Die fünfzehn StufenCopy Anchor Link

Das Gate führt nur maschinell prüfbare Validatoren aus. Die abwägende Beurteilung, die die abwägungsbasierten Stufen verlangen, und die abwägende Hälfte jeder Stufe der Klasse Mechanisch + abwägungsbasiert werden im Review bewertet.

SchweregradleiterCopy Anchor Link

Das Gate kennt keine Leiter aus Kritisch, Wichtig oder Beratend und keinen Schwellenwert von zwei Befunden. Ohne --strict (oder APOTHEM_CONFORMITY_STRICT=1) meldet das Gate Befunde und endet mit 0. Mit --strict endet eine Prüfung einer einzelnen Datei oder eines Hooks mit 2, sobald ein Matcher fehlschlägt, und ein Korpuslauf (--all oder --all-perwrite) endet mit 2, wenn ein blockierender Validator oder Matcher fehlschlägt; beratende Befunde werden nur gemeldet. Der installierte Write/Edit-Hook übergibt kein --strict. Er meldet daher Befunde, und der Schreibvorgang läuft weiter, sofern nicht APOTHEM_CONFORMITY_STRICT=1 in seiner Umgebung gesetzt ist.

ValidatorenCopy Anchor Link

Der mechanische Anteil liegt unter src/apothem/conformity/ und wird von src/apothem/conformity/gate.py orchestriert. Jeder Validator läuft auf eine von drei Arten:

• per-write: bei jedem anstehenden Schreibvorgang (--hook) oder mit --all-perwrite bei jeder versionierten Datei.
• standalone: mit --all über das gesamte Repository oder mit --check <name> einzeln.
• change-set: gegen einen gestagten Diff, direkt ausgeführt als python -m apothem.conformity.semver_stability_grep --staged, nicht über das Gate.

Die folgende Tabelle wird aus den Validator-Modulen generiert.

The conformity package ships 54 validators: 22 per-write, 31 standalone and 1 change-set. The gate registers the per-write and standalone ones.

Das Gate ausführenCopy Anchor Link

Auf einem installierten Harness läuft das Gate automatisch: Die settings.json von Claude Code bindet es als PreToolUse-Hook ein, der vor jedem Write/Edit die materialisierte Kopie unter ~/.claude/.apothem/support/conformity/gate.py aufruft. Das Gate prüft dann nur Schreibvorgänge im Geltungsbereich seines Hooks, und ein Schreibvorgang außerhalb des Geltungsbereichs wird stillschweigend durchgelassen; Das Konformitäts-Gate ausführen listet den Geltungsbereich auf. Aus einem Quell-Checkout treibt die Modulform denselben Code an; setzen Sie jedem python-Befehl unten PYTHONPATH=src voran. Das Gate ist standardmäßig beratend: Es meldet Befunde und endet mit 0. Fügen Sie --strict hinzu, damit es bei einem blockierenden Befund mit 2 endet. Ein unbekannter Validator-Name endet mit 3.

# Every standalone validator across the repository:
python -m apothem.conformity.gate --all .

# The same sweep, failing on a blocking finding (the CI form):
python -m apothem.conformity.gate --all --strict .

# Every per-write validator against every tracked file:
python -m apothem.conformity.gate --all-perwrite .

# One validator by name (names come from --list):
python -m apothem.conformity.gate --check naming-grep .

# List every registered validator as JSON:
python -m apothem.conformity.gate --list

# Single-file dispatch (mimics the PreToolUse hook):
echo '{"tool_input": {"file_path": "path/to/file", "content": "..."}}' \
    | python -m apothem.conformity.gate --hook

python -m apothem.conformity.gate --help gibt die Nutzungsübersicht aus. Das vollständige Verfahren finden Sie unter Das Konformitäts-Gate ausführen.

ReferenzCopy Anchor Link

• Registry des Pre-Emission-Gates — kanonische Definitionen der Stufen
• Registry der externen Konformität — detaillierte Semantik von M1-M15
• Übergreifende Mandate — maßgebliche Quelle der Mandate
• Performance-Disziplin — Laufzeitbudgets je Klasse