コンセプト

Apothem のドキュメント全体で目にする用語のクイックリファレンスです。

共有プロファイル

~/.config/apothem/profile.yaml にある、スキーマ検証済みの YAML ファイルです （--profile PATH で上書き可能）。あなたの識別情報、設定、構成の唯一の信頼できる情報源で あり、各ハーネスアダプターはインストール時にそれを読み取り、そこからそのハーネスの ネイティブ設定を導きます。

ハーネスアダプター

共有プロファイルを特定のハーネス向けのネイティブ設定フォーマットへ 変換する、プラットフォームごとのアダプターです。サポートされているランタイムは以下に列挙されています。

Claude Code, Cursor, Gemini CLI, etc.

Apothem をインストールするということは、常に次を意味します。共有プロファイルをインストールし、 続いて 1 つ以上のアダプターをマテリアライズすることです。

振る舞いルール

すべてのインタラクションで読み込まれる（常時オン）、または特定のパス配下のファイルを編集する ときのみ読み込まれる（パスフィルター付き）、src/apothem/rules/ 配下の Markdown ファイルです。 ルールはハーネスがどう振る舞うべきかを成文化します。

フック

settings.json に登録され、ハーネスのライフサイクルイベント （PreToolUse、PostToolUse、SessionStart、PreCompact、Stop、PostCompact）で発火する Python スクリプトです。フックは出力がディスクに到達する前に、リアルタイムでコンフォーミティ義務を 強制します。フックイベントモデルは現時点では Claude Code のサーフェスです。フック機構を持たない ハーネス向けのアダプターは、単にこれを省略します。

コンフォーミティゲート

15 バーの事前出力ゲート（M1〜M15）のうち機械的に判定される部分 — どのアーティファクトが 出力される前にも合格しなければならないスタンドアロンのバリデーター群です。事前出力ゲートは 品質の最低基準であり、コンフォーミティゲートはその機械チェック可能なバーを実行し、フックは 個々のバーをリアルタイムで強制します。

プランスイート

spec、マスタープラン、フェーズごとの PHASE.md ファイル、出力アーティファクトを含む、 <project-root>/.apothem/plans/<suite-name>/ にある構造化されたディレクトリです。/plan パイプラインがプラン スイートを管理します。

スキル

src/apothem/skills/<name>/ 配下の SKILL.md ファイルとしてまとめられた、再利用可能で スラッシュコマンドから呼び出せるテクニックです。スキルは組み込みの /plan パイプラインを超えて スラッシュコマンドサーフェスを拡張します。

委任ワーカー

正規パスで定義される、永続的で目的スコープを持つアシスタントです。

src/apothem/agents/<name>.md

委任ワーカーはリサーチ、監査、品質チェック、メモリ管理を担当します。