FAQ

よくある質問を、頻度の高い順に並べています。

apothem とは何ですか?Copy Anchor Link

Apothem は、コーディングアシスタントのハーネス向けの、ホスト非依存の構成マネージャーです。 1 つの共有プロファイルを記述すると、Apothem はそれを各ツールのネイティブ設定面へ マテリアライズします — 振る舞いルール、創造的な基準、スラッシュコマンド、永続的な委任ワーカー、 フック、スキルを、すべてのハーネスにわたって一貫性を保つ 1 つの統治されたコーパスに組み合わせます。

どのアシスタントハーネスで動作しますか?Copy Anchor Link

Apothem はハーネス非依存です。src/apothem/harnesses/<harness>/ 配下のハーネスごとの アダプターが、共有プロファイルを各ツールのネイティブ設定ディレクトリへ投影します。実行時の ハーネスレジストリが、サポート対象の集合についての権威ある情報源であり、各ハーネスについては ハーネスページで説明しています。レジストリは現在、以下のサポート対象 ハーネスを網羅しています。

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

Claude Code アダプターは ~/.claude/ にマテリアライズします。そのフックディスパッチャーはホスト非依存です。エコシステムのルートを、まず $CLAUDE_PROJECT_DIR から解決し、次に $LLM_PROJECT_DIR から解決します。その後、スクリプトからの相対的な位置と作業ディレクトリに基づく探索を試み、最後に $HOME/.claude にフォールバックします。

プランスイートパイプラインを使う必要がありますか?Copy Anchor Link

いいえ。プランスイートパイプラインはエコシステムの 1 つのコンポーネントです。振る舞いルール、 創造的な基準、フック、バリデーターツールチェーンは、それぞれ独立して役立ちます。

リポジトリをフォークせずにルールをカスタマイズするにはどうすればよいですか?Copy Anchor Link

~/.config/apothem/profile.yaml の rules: リストに文字列を追加し、インストールまたは更新を再実行してください。src/apothem/rules/ 配下のルールファイルは、パッケージ化されたソースツリーを編集するものです。--yes を付けて実行した場合、アーカイブインストーラーがそのソースツリーを置き換えます。

ルールを一時的に無効にするにはどうすればよいですか?Copy Anchor Link

ファイルの名前を src/apothem/rules/*.md パターンから外すように変更するか、ローダーが スキャンしない兄弟ディレクトリへ移動してください。

ルール、スキル、委任ワーカーの違いは何ですか?Copy Anchor Link

• ルールは振る舞いを統制します — アシスタントが従う、常時オンまたはパスフィルター付きの 義務です。
• スキルは再利用可能な検出可能テクニックです — 検出シグナル、手順、強制フックから成ります。
• 委任ワーカーは独自のツール制限とシステムプロンプトを持つ永続的なロールであり、 ワーカーオーケストレーションプロトコルを介してディスパッチされます。

セキュリティ問題を報告するにはどうすればよいですか?Copy Anchor Link

SECURITY.md を参照してください。サポートされているチャネルは GitHub Security Advisories と [email protected] です。

どのように貢献すればよいですか?Copy Anchor Link

コントリビューションを参照してください。手短に言うと、 CONTRIBUTING.md を読み、リポジトリをフォークし、正規の PR テンプレートを記入した PR を開き、 CI チェックが合格することを確認します — 開発者ガイドには、 PR が通過すべきゲートの一覧があります。

エコシステムの状態はどこに保存されますか?Copy Anchor Link

• スイートごとのプラン状態は、<project>/.apothem/plans/{suite}/ 配下に置かれます。
• Apothem のメモリは、インストールルートの下の .apothem/memory/ 配下に置かれます（Claude Code の場合は ~/.claude/.apothem/memory/、workspace.scope が user-home の場合は ~/.apothem/memory/、プロジェクトスコープのインストールの場合は <project>/.apothem/memory/）。Claude Code 独自の自動メモリは、ハーネスの設定ルート配下の projects/{hash}/memory/ にあります（Claude Code の場合は ~/.claude/projects/{hash}/memory/）。
• プロジェクト横断のメモリは、同じハーネスの設定ルート配下の .apothem/memory/ にあります（Claude Code の場合は ~/.claude/.apothem/memory/）。
• セッションごとのスクラッチ領域は、<project>/.apothem/plans/{suite}/_inputs/ 配下にあります。

長時間に及ぶ作業を、新しいセッションや別のマシンで再開できますか?Copy Anchor Link

はい。長時間に及ぶ作業は、その完全な状態をプロジェクトローカルの .apothem/plans/ スイートへ外部化します — 再開コントラクトとコールドスタートプロトコルの組です — ので、作業は単一のチャット履歴の中には存在しません。状態はあなたのプロジェクトの ファイルの中にあるため、同じプロジェクトを指す任意のアカウントやマシンでの新しい セッションが、その作業をその場で再開します。Apothem 自身がアカウント間でファイルを プッシュすることはありません。ファイルは、あなたのプロジェクトのファイルがすでに 移動しているのと同じ方法で移動します（バージョン管理、共有チェックアウト、同期された ディレクトリ）。再開可能なプランニングを参照してください。

Apothem には pip が必要ですか?Copy Anchor Link

いいえ — エンジン自体には不要です。エンジンは依存関係をベンダーとして同梱した自己完結型のソースツリーであり、 任意のチェックアウト、npx キャッシュ、またはプラグインツリーから、システムの Python 3.10 以上で python -m apothem として実行され、自身のコードを site-packages に一切インストールしません（click と rich が唯一のインタープリター前提条件です）。 唯一の任意的な例外として、click または rich が欠けている場合、インストーラーはその 2 つだけを pip install することを提案します — あなたの確認のもとで、または --yes / APOTHEM_AUTO_INSTALL_DEPS=1 で自動的に。 Apothem 自身のパッケージが site-packages にインストールされることは決してありません。

パッケージをインストールせずにフックはどう実行されますか?Copy Anchor Link

apothem install はフックディスパッチャーとコンフォーミティゲートをハーネスルートの下 （Claude Code の場合: ~/.claude/.apothem/support/hooks/ と ~/.claude/.apothem/support/conformity/）に マテリアライズし、レンダリングされたフックエントリがそれらのスクリプトを絶対パスで呼び出します。 どちらも標準ライブラリのみのスタンドアロンスクリプトなので、フックは pip install を一度も 見たことのないマシンでも動作します。

完全にアンインストールするにはどうすればよいですか?Copy Anchor Link

インストール済みのハーネスごとに apothem uninstall --harness <name> を実行し、インストール チャネルに応じてエンジンを削除し、残留物をゼロにしたい場合は ~/.apothem/（バックアップ）と ~/.config/apothem/（プロファイル）を削除します。アンインストールガイドが 各チャネルを案内します。

エコシステムのライセンスは何ですか?Copy Anchor Link

MIT です — LICENSE を参照してください。