用語集
Apothem 用語集 — 主要な用語と概念。
Apothem のドキュメント、コード、ガバナンス全体で使われる主要な用語を、アルファベット順に 掲載します。
アダプター
HarnessAdapter プロトコルを実装し、共有プロファイルをハーネス固有の設定フォーマットへ
変換するクラスです。アダプターは src/apothem/harnesses/<name>/ 配下のサブパッケージごとに
1 つずつ存在します。ハーネスアダプター抽象化を
参照してください。
監査レビューシーケンス
コード、コードレビュー、セキュリティ、パフォーマンス、アーキテクチャ、UX、アクセシビリティ、
ドキュメント、依存関係、サプライチェーン、脅威モデルを網羅する 11 コマンドの監査スイープです。
/fortress 堅牢化パイプラインによって駆動されます。
監査レビューシーケンスを参照してください。
振る舞い差分ゴールデン
tests/fixtures/behavior-diff/ にコミットされたスナップショットで、決定的なインストールと
CLI のオラクルがこれとバイト単位で比較されます。そのため、インストールプラン、レンダリング
されたコホート、または CLI 出力への意図しない変更が、無言で出荷されるのではなくドリフトと
して検出されます。この比較はプラットフォームによって異なるバイトを正規化するため、コーパスは
オペレーティングシステムをまたいで可搬性を保ちます。
コホート
1 種類の同期アーティファクト——ルール、コマンド、スキル、エージェント、フック、出力スタイル、 スキーマ、またはテンプレート——をまとめたセットで、エンジンが単一の共有プロファイルから各 ハーネスへマテリアライズします。1 つのプロファイルがすべてのコホートを携え、各アダプターが それらをそのハーネスのネイティブ面へ投影します。
コンフォーミティゲート
15 バーの事前出力ゲートのうち機械的に判定される部分 — src/apothem/conformity/gate.py にある
機械チェック可能なバリデーター群です。どのアーティファクトが出力される前にも実行されます。
判断を要するバーはレビューで評価されます。
エントリーポイント
pyproject.toml に宣言された apothem.harnesses setuptools エントリーポイントグループです。
ハーネスレジストリを正確に反映します。テストは宣言されたエントリーポイントが登録済みの
アダプターと等しいことを表明するため、規約は正しいが未登録のアダプターはカバレッジの
リグレッションとして表面化します。
ハーネス
Apothem が専用アダプターを介してサポートする、アシスタントプラットフォームです。 サポート対象プラットフォーム:
Antigravity
Claude Code
CodeBuddy
Codex
Cursor
Gemini CLI
GitHub Copilot
GLM (Z.ai)
Hermes
Kimi Code
Kiro
Open-Claw
OpenCode
Qwen Code
Trae
Windsurf
Zedハーネスを参照してください。
ハーネスレジストリ
src/apothem/lib/harness_registry.py(データは harness_registry_data.py)にあるカタログで、
すべてのアダプターを列挙し、実行時に権威を持ちます —— エンジンはすべてのアダプターを
そこから解決するため、素のチェックアウトから読み込めます。src/apothem/harnesses/ 配下の
ファイルシステム規約による発見は、実行時のリゾルバーではなく適合性のパリティチェックです。
フック
ハーネスのライフサイクルイベント(PreToolUse、PostToolUse、SessionStart、Stop)に登録される
コマンドです。ネイティブな登録面はハーネスごとに異なります——設定ファイル、専用のフック
マニフェスト、あるいはハーネスがネイティブなフック面を公開しない場合は、命令アンカーから
参照される Apothem のサポート素材です。フックスクリプトとそのメッセージコンテキストは
src/apothem/hooks/ 配下に置かれます。
マテリアライザー
アダプターの任意の materialize_native_config(profile) -> str で、設定が 1 つの構造化された面
(例:JSON または YAML の設定ファイル)であるハーネス向けに、共有プロファイルから単一ファイルの
ネイティブ構成をレンダリングします。テンプレート伝播アダプターはマテリアライザーを省略し、
代わりに伝播マニフェストに従ってコホートをコピーまたは変換します。
出力スタイル
output-styles/ 配下の Markdown 定義で、アシスタントの応答形式と声(例:簡潔なエンジニア
スタイルやフォレンジック監査スタイル)を形作ります。アダプターがインストールする同期
コホートの 1 つです。
プランスイート
/plan-generate によって生成され、/plan-execute によって実行される、計画アーティファクトの
構造化されたコレクション(PREAMBLE.md、MASTER-PLAN.md、PROGRESS.md、PLAN-NOTES.md、フェーズ
ごとの PHASE.md ファイル)で、プロジェクトローカルの .apothem/plans/ ディレクトリ配下に
置かれます(レガシーの .plans/ ツリーは apothem migrate-workspace でアップグレードします)。
事前出力ゲート
アーティファクトが出力される前、またはフェーズ出力が完了とみなされる前に記録される 15 バーの サインオフブロックです。機械的なバーはコンフォーミティゲートとして実行され、判断を要する バーはレビューで評価されます。事前出力ゲートを 参照してください。
伝播マニフェスト
src/apothem/lib/propagation-manifest.yaml —— テンプレート伝播アダプターごとに、どのコホートを
インストールするか、そしてハーネスネイティブ形式への変換(例:コマンドをハーネスの TOML 形式へ
変換する)を宣言します。
リリース準備ゲート
3 つの収束ゲート: ローカルのコンフォーミティ、継続的インテグレーション、監査レビューシーケンス です。リリースは該当するゲートが合格した後にのみ進みます。
自己完結型ランタイム
Apothem はランタイムの Python 依存関係(pyyaml や jsonschema など)を src/apothem/_vendor/
配下にベンダリングするため、エンジンは素のチェックアウトから実行されます。インストール時に
解決されるのは click と rich だけです。
自己完結型ランタイムを参照してください。
シリアスネスティア
どの品質管理が適用されるかを決定する、4 つのガバナンスレベル(EXPLORING、PERSONAL_USE、 SHARED、PUBLIC_LAUNCH)のいずれかです。シリアスネスティアを 参照してください。
共有プロファイル
~/.config/apothem/profile.yaml または --profile PATH にある、スキーマ検証済みの YAML
ファイルです。ハーネスアダプターはこれをパッケージ化された Apothem コホートと組み合わせ、
サポート対象の各ハーネス向けにネイティブ設定を導出します。
STANDARD-CONVENTION-PIN
アダプターごとの STANDARD-CONVENTION-PIN.md で、アダプターの規約が固定されているベンダー
ドキュメントの URL、コミット SHA、スナップショット日付、正規のファイル名とスキーマを記録します。
アダプターが対象とするベンダー面から無言でドリフトしないよう、一定の頻度で再検証されます。
サポートサブツリー
ハーネスにネイティブなプリミティブがないコホート(ルール、フック、スキル、エージェント)のために、 ハーネスのインストールが使用する Apothem 所有のディレクトリです。ベンダー予約ディレクトリへ 強制されるのではなく、ハーネスのネイティブな命令アンカーから参照されます。