独立した複数リポジトリでエージェント運用の一貫性を保つ — マルチリポ・ガバナンス設計の実装メモ

ops/                          # 運用専用の正本置き場（どのサイトのリポでもない）
├── canonical/
│   ├── AGENTS.base.md        # 全リポジトリ共通の規約（第1層）
│   ├── gates/
│   │   ├── article_gate.py   # 品質ゲート（正本）
│   │   └── frontmatter_integrity.py
│   └── manifest.json         # 配布先リポジトリと配置パスの定義
└── scripts/
    ├── distribute.sh         # 正本を各リポへ配布
    └── audit-drift.sh        # 配布物と正本の差分を監査

{
  "repos": [
    { "name": "site-a", "path": "/home/ops/repos/site-a" },
    { "name": "site-b", "path": "/home/ops/repos/site-b" },
    { "name": "site-c", "path": "/home/ops/repos/site-c" },
    { "name": "site-d", "path": "/home/ops/repos/site-d" }
  ],
  "artifacts": [
    { "src": "canonical/gates/article_gate.py",        "dest": "_gates/article_gate.py" },
    { "src": "canonical/gates/frontmatter_integrity.py", "dest": "_gates/frontmatter_integrity.py" }
  ],
  "agents_md": {
    "base": "canonical/AGENTS.base.md",
    "site_overlay": "AGENTS.site.md",
    "dest": "AGENTS.md"
  }
}

#!/usr/bin/env bash
# distribute.sh — 正本を manifest に従って各リポジトリへ配布する
set -euo pipefail
 
OPS_DIR="$(cd "$(dirname "$0")/.." && pwd)"
MANIFEST="$OPS_DIR/canonical/manifest.json"
 
repo_count=$(jq '.repos | length' "$MANIFEST")
 
for i in $(seq 0 $((repo_count - 1))); do
  repo_path=$(jq -r ".repos[$i].path" "$MANIFEST")
  repo_name=$(jq -r ".repos[$i].name" "$MANIFEST")
  [ -d "$repo_path/.git" ] || { echo "skip (no repo): $repo_name"; continue; }
 
  # 1) 単純コピーする配布物
  art_count=$(jq '.artifacts | length' "$MANIFEST")
  for j in $(seq 0 $((art_count - 1))); do
    src=$(jq -r ".artifacts[$j].src"  "$MANIFEST")
    dest=$(jq -r ".artifacts[$j].dest" "$MANIFEST")
    mkdir -p "$repo_path/$(dirname "$dest")"
    cp "$OPS_DIR/$src" "$repo_path/$dest"
  done
 
  # 2) AGENTS.md を base + site overlay で合成
  base=$(jq -r '.agents_md.base'         "$MANIFEST")
  overlay=$(jq -r '.agents_md.site_overlay' "$MANIFEST")
  dest=$(jq -r '.agents_md.dest'         "$MANIFEST")
  {
    echo "<!-- GENERATED FILE — DO NOT EDIT. Edit the canonical source in ops/canonical/ -->"
    echo ""
    cat "$OPS_DIR/$base"
    if [ -f "$repo_path/$overlay" ]; then
      echo ""
      echo "<!-- ===== site-specific overlay ($repo_name) ===== -->"
      echo ""
      cat "$repo_path/$overlay"
    fi
  } > "$repo_path/$dest"
 
  echo "distributed -> $repo_name"
done

#!/usr/bin/env bash
# audit-drift.sh — 各リポの配布物が正本と一致しているか検査する
set -euo pipefail
 
OPS_DIR="$(cd "$(dirname "$0")/.." && pwd)"
MANIFEST="$OPS_DIR/canonical/manifest.json"
drift=0
 
hash_of() { sha256sum "$1" | awk '{print $1}'; }
 
repo_count=$(jq '.repos | length' "$MANIFEST")
art_count=$(jq '.artifacts | length' "$MANIFEST")
 
for i in $(seq 0 $((repo_count - 1))); do
  repo_path=$(jq -r ".repos[$i].path" "$MANIFEST")
  repo_name=$(jq -r ".repos[$i].name" "$MANIFEST")
  [ -d "$repo_path/.git" ] || continue
 
  for j in $(seq 0 $((art_count - 1))); do
    src=$(jq -r ".artifacts[$j].src"  "$MANIFEST")
    dest=$(jq -r ".artifacts[$j].dest" "$MANIFEST")
    deployed="$repo_path/$dest"
    if [ ! -f "$deployed" ]; then
      echo "MISSING  $repo_name:$dest"; drift=1; continue
    fi
    if [ "$(hash_of "$OPS_DIR/$src")" != "$(hash_of "$deployed")" ]; then
      echo "DRIFT    $repo_name:$dest が正本と一致しません"; drift=1
    fi
  done
done
 
if [ "$drift" -ne 0 ]; then
  echo "❌ ドリフトを検出しました。distribute.sh を再実行して揃えてください。"
  exit 1
fi
echo "✅ 全リポジトリの配布物が正本と一致しています。"

## このリポジトリの規約ファイルについて
 
- `AGENTS.md` と `_gates/` 配下は**生成物・配布物**です。直接編集しないでください。
- 規約を変更したい場合は、変更の意図だけを述べてください。
  正本は別の運用リポジトリ（ops/canonical/）にあり、そこで一元管理されます。
- push 前には必ず `audit-drift.sh` 相当のチェックが走ります。
  配布物を書き換えるとこのチェックで停止します。