ドキュメント / はじめに
GenPM の仕組み
GenPM のパッケージは、1 つのコミットに固定されて一緒に届く 3 つのレイヤーでできています。
| レイヤー | 内容 | 配置先 |
|---|---|---|
| コード | モジュールのソースコード | d(例: src/lib/auth/) |
| コンテキスト | AI エージェント向けのルール(x) |
<d>/AGENTS.md と、スコープ付きの IDE ルールファイル |
| コネクション | モジュールが必要とする MCP サーバー(m) |
.mcp.json、.cursor/mcp.json など。同意した場合のみ |
レジストリはメタデータだけを保存
レジストリはマニフェストをインデックス化し、Git を指し示します。インストール時、CLI はGit ホストから直接正確なコミット(c)のコードをダウンロードして検証します。git rev-parse HEAD が c と一致し、すべてのファイルがコミットのツリーと一致しなければなりません。
実行前に計画
plan() はプロジェクトに一切書き込みません。依存関係を解決し、グローバルキャッシュにダウンロードし、ファイルをスキャンします。apply() はジャーナル経由で書き込み、途中で失敗すればすべて元に戻します。
スクリプトは一切なし
GenPM にはライフサイクルスクリプトがありません。パッケージのものがあなたのマシンで実行されることはありません。他のツールが自動実行するファイル(postinstall、.npmrc、.envrc、.vscode/tasks.json など)は拒否されます。