コンフォーミティゲート
コンフォーミティゲート
Apothem のコンフォーミティゲート — 出力されるすべてのアーティファクトが合格しなければならない、15 バーの事前出力ゲート（M1-M15）のうち機械的に判定される部分。
15 のバー
| バー | ID | マンデート | チェックの種類 | 不合格 → 対処 |
|---|---|---|---|---|
| 1 | M1 | ホストプロジェクト非依存 | 推論型 | ホストの規約に合わせて修正する |
| 2 | M2 | 編集の規律（開示台帳） | 推論型 | 開示マーカーを追加する |
| 3 | M3 | 10 の品質次元 | 機械型 + 推論型 | 不合格の次元について修正する |
| 4 | M4 | 自己適用（検証ブロックが存在する） | 推論型 | 検証ブロックを記録する |
| 5 | M5 | 権威の原則（捏造されたアイデンティティ / エンドポイント / シークレットがない） | 機械型 | 問い合わせに回す |
| 6 | M6 | 専門知識の取り込み（表面化したギャップ） | 推論型 | ギャップを表面化させ、改良を引用する |
| 7 | M7 | 選択肢の注釈（推奨マーカー + 決め手となる根拠） | 機械型 | 選択肢セットに注釈を付ける |
| 8 | M8 | 確定性（規範的な文章でぼかし表現を使わない） | 機械型 | ぼかし表現を条件文に格上げする |
| 9 | M9 | 視覚的レバレッジ（構造的な主題には図を付ける） | 機械型 + 推論型 | 図を作成または更新する |
| 10 | M10 | 双方向バインディング（相互の後方ポインターが閉じている） | 機械型 | ハーフエッジを閉じる |
| 11 | M11 | アジャイルスプリント（ゴール / バックログ / DoR / DoD / レビュー / レトロスペクティブ） | 推論型 | スプリントとして再構成する |
| 12 | M12 | フェーズ報告と正規レイアウト | 機械型 + 推論型 | ロールアップを作成し、正規レイアウトに再配置する |
| 13 | M13 | コードクラフト（lint / format / 型チェック、マジックナンバー、bare-except） | 機械型 | 言語ごとのコードクラフトのルールを適用する |
| 14 | M14 | システム性（上流 / 下流 / ピア / 強制者を宣言する） | 機械型 + 推論型 | 宣言し、レジストリに索引付けする |
| 15 | M15 | 本番対応（テスト + ドキュメント + CHANGELOG + 準拠したコミット + CI グリーン + semver の安定性） | 機械型 + 推論型 | 欠けている面を追加する |
ゲートが実行するのは、機械で判定できるバリデーターだけです。推論型のバーが求める推論による判断と、機械型 + 推論型の各バーの推論型の半分は、レビューで評価されます。
重大度の段階
ゲートには、クリティカル・重要・助言という重大度の段階も、2 件の検出事項というしきい値もありません。--strict（または APOTHEM_CONFORMITY_STRICT=1）を付けない場合、ゲートは検出事項を報告し、0 で終了します。--strict を付けると、単一ファイルまたはフックのチェックは、いずれかのマッチャーが不合格のとき 2 で終了し、コーパス実行（--all または --all-perwrite）は、ブロッキングのバリデーターまたはマッチャーが不合格のとき 2 で終了します。助言的な検出事項は報告されるだけです。インストールされた Write/Edit フックは --strict を渡さないため、検出事項を報告し、書き込みは続行されます。ただし、そのフックの環境で APOTHEM_CONFORMITY_STRICT=1 が設定されている場合は除きます。
バリデーター
機械的に判定される部分は src/apothem/conformity/ にあり、src/apothem/conformity/gate.py によってオーケストレーションされます。
各バリデーターは、次の 3 つの方法のいずれかで実行されます。
- per-write: 保留中のすべての書き込みに対して（
--hook）、または--all-perwriteを指定した場合は追跡対象のすべてのファイルに対して実行されます。 - standalone:
--allでリポジトリ全体に対して、または--check <name>で 1 つずつ実行されます。 - change-set: ステージされた差分に対して、ゲートを経由せず、
python -m apothem.conformity.semver_stability_grep --stagedとして直接実行されます。
以下の表は、バリデーターモジュールから生成されます。
The conformity package ships 54 validators: 22 per-write, 31 standalone and 1 change-set. The gate registers the per-write and standalone ones.
| Validator | Runs | Rule anchor | What it checks |
|---|---|---|---|
agent-capability-grep | standalone | agent-capability-discipline (per-harness capability matrix) | Verify every harness declares its agentic-capability matrix. |
agents-md-coverage-grep | standalone | rules/agents-md-convention.md | Flag stale agent-companion files under the root-only AGENTS.md convention. |
agnosticism-grep | standalone | rules/agnostic-posture.md §3 (harness neutrality) + §1 (default-off) | Flag harness bias and re-introduced enforcement presets in shipped surfaces. |
always-on-budget-grep | per-write | D1 token-budget-discipline §Always-on body budget | Body-budget conformity matcher for always-on rules. Pointed at a rules directory it also holds the loaded always-on set and the rule index to byte ceilings. |
bare-except-grep | per-write | M13.3 error handling | Flag bare except clauses without typed exceptions or re-raise. |
binding-five-direction-grep | standalone | M10 bidirectional-binding §1 (five-direction Bindings section) | Require the five-direction Bindings section on every rule, command, agent, and skill. |
binding-reciprocity-corpus-grep | standalone | M10 bidirectional-binding §2 (↔ self-reciprocal) | Cross-file binding-reciprocity corpus walk — the ↔-symmetric half-edge check. |
binding-reciprocity-grep | per-write | M10 bidirectional-binding §Notation | Flag binding declarations using non-canonical arrow notation. |
brand-mark-grep | per-write | rules/plain-language.md (brand-mark display/identifier casing) | Flag brand-mark display/identifier form drift on brand-touched surfaces. |
commented-out-code-grep | per-write | M13.1 why-not-what comments | Flag substantial commented-out code blocks left in source. |
completion-claim-grep | per-write | rules/session-closure.md (verifiable-close output honesty) | Flag unsupported completion / guarantee claims in cohort prose. |
conventional-commit-grep | standalone | CLAUDE.md Coding Conventions — Conventional Commits | Flag HEAD commit messages that drift from the Conventional-Commits grammar. |
copilot-instructions-presence-grep | per-write | — | GitHub Copilot surface presence check. |
cross-platform-matrix-grep | standalone | cross-platform OS x Python CI matrix | Verify CI declares a cross-platform OS x Python matrix. |
determinism-grep | standalone | rules/determinism.md | Prove every command and skill surface has a deterministic output shape. |
diagram-staleness-grep | per-write | M9 visual-leverage §Fidelity | Flag diagrams whose verification date is missing or stale. |
dynamism-grep | standalone | rules/dynamism.md (static-version embeds) | Flag static-string version embeds in dynamism-required surfaces. |
editorconfig-presence-grep | standalone | supply-chain SOTA-rigor §editorconfig | Verify a canonical .editorconfig is present at the project root. |
file-header-grep | per-write | — | Authorship-header presence and canonical-form check. |
freshness-token-grep | standalone | rules/freshness-facade.md | Flag freshness-narrative phrases on shipped public surfaces. |
frontmatter-grep | per-write | the per-class frontmatter JSON Schemas (src/apothem/schemas/) | Validate per-artifact-class YAML frontmatter against required-key sets. |
frontmatter-value-grep | standalone | per-class JSON Schema enum/pattern value constraints | Validate frontmatter VALUES against the per-class JSON Schema enum/pattern constraints. |
gate-evidence-grep | standalone | commands/plan-execute.md Gate evidence; rules/pre-emission-gate-bars.md section 2 (attestation schema) | Advisory: flag plan-suite gate claims that lack a command, an exit status or output, and a HEAD SHA beside them, and fifteen-bar attestations that omit a field of the rule's schema. |
gitattributes-presence-grep | standalone | supply-chain .gitattributes contract | Verify the repo-root .gitattributes carries the canonical contract. |
harden-runner-grep | standalone | harden-runner egress baseline | Verify every workflow job opens with a conformant harden-runner step. |
hedging-grep | per-write | M8 definitiveness §Hedging | Flag hedging vocabulary in prescriptive contexts. |
license-author-consistency-grep | per-write | — | LICENSE author-identity presence check. |
link-check | per-write | rules/code-craft-markdown.md §6 Link Discipline | Validate Markdown internal links against the on-disk reference graph. |
magic-number-grep | per-write | M13.10 magic numbers | Flag magic numbers in source code. |
multi-surface-coherence-grep | per-write | — | Shared-claim coherence across AI-conventions surfaces. |
naming-grep | standalone | CLAUDE.md Coding Conventions (kebab-case naming) | Validate filesystem paths against the canonical naming convention. |
no-global-plans-grep | standalone | CLAUDE.md Plans Discipline (no global plans) | Walk the git index for tracked plans paths; fail when found. |
no-toplevel-docs-grep | standalone | single-source-of-truth (docs live in site/, not root docs/) | Fail when a top-level docs/ directory exists at the repository root. |
oidc-trusted-publishing-grep | standalone | OIDC trusted publishing | Verify release workflows use OIDC trusted publishing. |
option-annotation-grep | per-write | M7 option-annotation (H6 per-option bind) | Enforce the per-option Recommended label-to-body bind (H6). |
orphan-output-grep | per-write | M12 canonical-layout + M14 systemicity | Flag artifacts emitted to non-canonical locations or without provenance. |
permissions-minimum-scope-grep | standalone | minimum-scope workflow permissions | Verify every GitHub Actions workflow declares a minimum-scope permissions: block. |
plain-language-grep | standalone | rules/plain-language.md — user-facing prose | Flag mechanistic / harness-internal vocabulary in user-facing prose. |
plan-next-step-consistency-grep | standalone | rules/recommend-next-step.md | Advisory: flag plan-suite infra files whose Recommended-Next-Step footer drifts from the suite's recorded next pipeline stage. |
plan-suite-structure-grep | standalone | context-management-scratch 2 (suite-locality + closed vocab) + canonical-layout-reporting-tiers 2.1 (numeric-prefix discipline) | Validate plan-suite structure: suite-locality, closed vocab, numeric prefix. |
plans-discipline-language-grep | standalone | CLAUDE.md Plans Discipline (multi-surface language) | Verify the canonical Plans Discipline language reaches every required surface. |
production-ready-pr-grep | per-write | M15 production-ready §Same-change-set | Flag commits whose change-set lacks the production-ready four-class shape. |
recommend-next-step-grep | standalone | rules/recommend-next-step.md | Verify every command file carries a ## Recommended Next Step block. |
redundancy-grep | standalone | rules/operational-mandates.md §CM-7 coherent-product non-redundancy | Flag substantively-duplicated paragraphs across the governed corpus. |
reference-token-grep | standalone | rules/own-voice-reimplementation.md | Flag leaked reference-platform branding tokens on authored surfaces. |
registry-capability-consistency-grep | standalone | rules/agent-capability-discipline.md — registry capability cells backed by evidence | Flag registry capability cells not backed by install / materializer / projection evidence. |
secret-leak-grep | per-write | M13.8 security + M15 production-ready | Block emission of artifacts containing hardcoded credentials. |
semver-stability-grep | change-set | M15 semver-stability | Semver stability matcher (M15 mechanical fraction). |
smoke-install-grep | standalone | production-ready section 8.1 paired install scripts | Smoke-test the paired install scripts at the repository root. |
static-version-grep | standalone | rules/dynamism.md §static-version-resolution | Verify version-bearing sites resolve dynamically, not as static literals. |
token-efficiency-grep | per-write | clean-room-generation §5 + token-efficiency-rewrite | Flag filler phrases, throat-clearing openers, and content-free qualifiers. |
unpinned-action-grep | per-write | M15 production-ready §Supply-chain | Flag GitHub Actions workflows that pin actions to mutable refs. |
user-confirm-grep | per-write | M5 authority-inquiry §10 | Block emission of artifacts containing unresolved authority placeholders. |
workflow-concurrency-grep | standalone | workflow concurrency + per-job timeouts | Enforce concurrency + per-job timeout discipline on GitHub workflows. |
ゲートの実行
インストール済みのハーネスでは、ゲートは自動的に実行されます。Claude Code の
settings.json がゲートを PreToolUse フックとして配線し、すべての Write/Edit の前に、
~/.claude/.apothem/support/conformity/gate.py にあるマテリアライズされたコピーを呼び出します。
ゲートがチェックするのは、フックのスコープ内の書き込みだけであり、スコープ外の書き込みは無言で合格します。
そのスコープは、コンフォーミティゲートの実行に一覧があります。
ソースチェックアウトからは、モジュール形式で同じコードを実行します。
以下の python コマンドには、それぞれ先頭に PYTHONPATH=src を付けてください。
ゲートはデフォルトでは助言的です。検出事項を報告し、0 で終了します。
ブロッキングの検出事項があった場合に 2 で終了させるには、--strict を追加します。不明なバリデーター名を指定すると 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 --hookpython -m apothem.conformity.gate --help は使用方法の概要を表示します。
完全な手順については、コンフォーミティゲートの実行を参照してください。
リファレンス
- 事前出力ゲートレジストリ — 正規のバーの定義
- 対外コンフォーミティレジストリ — M1-M15 の詳細なセマンティクス
- 横断的マンデート — マンデートの信頼できる情報源
- パフォーマンスの規律 — クラスごとのランタイム予算