Skip to content

リポジトリ構造

TakashiSasaki/templates の policy ブランチは、他の長期ブランチである main、site、webapp と共通祖先を持たないorphan historyです。policy には、規約ツールチェーンと初回導入用trust seedの両方を配置します。

bootstrap skillは別branchではなく skills/bootstrap-agent-policy/ にあります。共有historyを持ちますが、manifestがレビュー済みのfull commit SHAを固定するため、mutableなpolicy先端を実行しません。

`policy` ブランチ

以下は、policy でGitが追跡している完全なツリーを表示するためのplaceholderです。documentation publication時に同じcommitからpreview manifestを生成します。

ツリーを読み込んでいます…

主要ディレクトリの役割

パス	役割
`policy/`	共有規約の正本。各規則はYAML front matter付きMarkdownとして管理する。
`profiles/`	適用する規約ファイルの集合と順序を宣言する。artifact categoryではなくagent operationやrisk contextを分類する。
`schemas/`	製品リポジトリの `.agent-policy.yml` とadoption stateを検証するJSON Schema。toolchain repositoryは`TakashiSasaki/templates`。
`src/agent_policy/`	`init`、`adopt inspect/prepare/preview/finalize`、`validate`、`render`、`check` を実装するPython CLI。
`templates/`	`AGENTS.md`、製品固有規約、consumer workflowなどの生成template。
`skills/`	通常運用skillの正本と、`skills/bootstrap-agent-policy/`に統合された初回導入trust seed。
`tests/`	設定、adoption transaction、rendering、lock、path safety、repository identity、bootstrap trust boundaryを検査する。
`docs/`	導入方法、設計、ADR、PWA資産、repository preview UI。
`scripts/`	repository preview生成・検証など、branchの保守とpublicationを支援するscript。
`.github/workflows/`	`policy`向けCI。publicationやrepository hygieneはrepository設定とともに別途復旧する。

統合済みbootstrap skill

skills/bootstrap-agent-policy/
  SKILL.md
  README.md
  bootstrap-manifest.yml
  scripts/
    bootstrap.py
    install.py
    uninstall.py

パス	役割
`SKILL.md`	起動条件、inspection、`init`／`adopt`振り分け、安全制約、finalize分離を定義する。
`bootstrap-manifest.yml`	実行を許可する`TakashiSasaki/templates`のfull SHAとroute集合を固定する。finalize routeは含まない。
`scripts/bootstrap.py`	固定CLIを一時環境で取得し、read-only inspection、明示的なinitializationまたはadoption preparation、適用後検証を実行する。
`scripts/install.py`	レビュー済みcheckoutからskill directoryへ安全にコピーする。
`scripts/uninstall.py`	markerを確認して導入済みskillを削除する。
`tests/test_bootstrap_skill.py`	manifest、pin、route、安全制約、state parsing、post-apply commandを検査する。

導入前後の制御移行

導入前
  user environmentの bootstrap-agent-policy skill
      ↓ bootstrap-manifest.yml の repository + full SHA
  templates上の pinned agent-policy CLI
      ↓ adopt inspect
  ├─ unmanaged-empty
  │    └─ 明示的な init --apply
  │
  └─ unmanaged-existing
       └─ 明示的な adopt prepare --apply
            ↓ previewと意味レビュー
          別の明示指示による adopt finalize --apply

導入完了後
  製品リポジトリの .agent-policy.yml
  .agent-policy.lock
  生成されたエージェント指示と通常運用skill
  repository-local CI

導入前のtrust seedはbootstrap packageです。初期化完了後、またはadoption finalization完了後は、製品リポジトリに記録された設定、lock、生成物へ制御を引き渡します。