FAQ

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

apothem とは何ですか?

ポータブルでホスト非依存の設定であり、ホームディレクトリを、ハーネス主導の 開発のためのガバナンス・発想・自動化のフレームワークに変えます。振る舞いルール、創造的な基準、 スラッシュコマンド、永続的な委任ワーカー、フック、スキルを、1 つの一貫したサーフェスに 組み合わせます。

どのハーネス CLI で動作しますか?

Apothem はハーネス非依存です。src/apothem/harnesses/<harness>/ 配下のハーネスごとの アダプターが、共有プロファイルを各ツールのネイティブ設定ディレクトリへ投影します。正規の 一覧は site/content/docs/harnesses/ にあり、現在は以下のサポート対象 ハーネスを網羅しています。

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, and Zed

Claude Code アダプターは ~/.claude/ にマテリアライズします。そのフックディスパッチャーは ホスト中立で、エコシステムルートをまず $CLAUDE_PROJECT_DIR から解決し、次に $LLM_PROJECT_DIR、それから $HOME/.claude にフォールバックします。

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

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

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

正規のフロントマターを備えた独自のルールファイルを src/apothem/rules/<my-rule>.md の下に 追加します。ルールローダーは src/apothem/rules/*.md パターンに一致するすべてのファイルを 取り込みます。

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

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

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

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

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

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

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

コントリビューションを参照してください。手短に言うと、 CONTRIBUTING.md を読み、リポジトリをフォークし、正規の PR テンプレートを記入した PR を開き、 10 種類の CI チェッククラスが合格することを確認します。

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

• スイートごとのプラン状態は <project>/.apothem/plans/{suite}/ 配下に保存されます。
• プロジェクトごとのメモリは projects/{hash}/memory/ 配下に保存されます。
• プロジェクト横断のメモリは memory/ 配下に保存されます。
• セッションごとのスクラッチは <project>/.apothem/plans/{suite}/_inputs/ 配下に保存されます。

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

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

Apothem には pip が必要ですか?

いいえ — エンジン自体には不要です。エンジンは依存関係をベンダーとして同梱した自己完結型のソースツリーであり、 任意のチェックアウト、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 にインストールされることは決してありません。

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

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

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

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

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

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