| name | sync-to-kag |
| model | sonnet |
| description | 一般公開版（marp-agent）の変更を、KAG社内版（marp-agent-kag）へマージで取り込む。公開版を本番へデプロイしたら必ず実行する。「kagにも反映して」「kag環境にも適用して」「同期して」で起動。 |
| allowed-tools | Bash |
KAG社内版へ取り込む（マージ方式）
公開版 marp-agent の変更を、KAG社内版 marp-agent-kag（ローカル ../marp-agent-kag）へ
git merge で流す。方向は公開版 → KAG版の一方向だけ。
いつ実行するか
公開版を本番へデプロイしたら、その場で実行する。 deploy-prod の完了条件に入っている。
みのるんは「本番側を触らせたときに自動で発動すればいい」と明示している（2026-08-22）ので、
聞かずに実行する。「KAGにも反映しますか？」と確認しない。
デプロイを伴わないコード変更でも、公開版の main へ push したなら実行してよい。
⚠️ チェリーピックは使わない
KAG版は公開版から280コミット以上先行している（版設定の抽象化、GHE対応、社内テーマ）。
必要なものを1つずつ拾う方式は破綻するので、git merge だけを使う。
両リポジトリの .githooks/prepare-commit-msg がチェリーピックを機械的に拒否する。
2026-08-20 に「ディレクトリ構成が食い違うので同期そのものを停止」していたが、
2026-08-22 のリアーキテクチャで構成が揃い、停止は解除された。
実測では agent/ 配下は自動マージで通り、コンフリクトしたのは
両側で別々に育てたドキュメント1件だけだった。
手順
1. 公開版がpush済みか確かめる
git -C ~/git/minorun365/marp-agent status --short
git -C ~/git/minorun365/marp-agent log --oneline @{u}..HEAD
未pushのコミットがあれば先にpushする（マージはリモートの upstream/main を見るため）。
2. KAG版の作業ツリーが空いているか確かめる
git -C ~/git/minorun365/marp-agent-kag status --short
git -C ~/git/minorun365/marp-agent-kag branch --show-current
⚠️ 未コミットの変更があったら、そこで止めてみのるんへ報告する。
みのるんは20本以上の並行セッションを回しており、別のセッションがKAG版で作業中の可能性がある。
勝手に stash したりコミットしたりしない。ブランチが main でない場合も同じく止める。
3. 取り込む
git -C ~/git/minorun365/marp-agent-kag fetch upstream
git -C ~/git/minorun365/marp-agent-kag log --oneline main..upstream/main
差分が無ければ「取り込むものはありません」と報告して終わる。あれば：
git -C ~/git/minorun365/marp-agent-kag merge upstream/main
4. コンフリクトしたら
自分の判断で解決してよいのは、次の場合だけ。
| 状況 | 解決 |
|---|
| KAG版固有の設定（ドメイン・モデル・テーマ・デプロイ手順） | KAG版側を採る |
| 公開版で直したロジック・バグ修正 | 公開版側を採る |
| 両側で別々に書き足したドキュメント | 両方を残す（並べて統合する） |
判断がつかないものが1つでもあれば、git merge --abort してみのるんへ聞く。
中途半端に解決してpushしない。
.gitattributes で merge=ours を指定しているファイル（cdk.json AGENTS.md CLAUDE.md
README.md LICENSE）は、そもそもコンフリクトせずKAG版の内容が残る。
新しくそういうファイルが増えたら .gitattributes へ足す。
5. テストを通してからpush
cd ~/git/minorun365/marp-agent-kag/agent && uv run --with pytest python -m pytest ../tests/ -q
cd ~/git/minorun365/marp-agent-kag && npm run lint && npm run test
落ちたら push しない。 マージで壊れたということなので、原因を直すか git merge --abort する。
通ったら push する。KAG版は github（GitHub.com・プライベート）と origin（GHE）の
2つのリモートを持つので、現在のブランチが追跡している側へ push する（git push だけでよい）。
6. 本番へ反映するかは別の判断
マージしただけではKAG版の本番は変わらない。 取り込んだ内容がエージェントの挙動や
画面に影響するなら、KAG版のデプロイが要る:
cd ~/git/minorun365/marp-agent-kag && npm run infra:diff
cd ~/git/minorun365/marp-agent-kag && npm run infra:deploy
cd ~/git/minorun365/marp-agent-kag && npm run prod:verify
cd ~/git/minorun365/marp-agent-kag && npm run prod:smoke
ドキュメントだけの取り込みならデプロイは不要。判断して、やるなら実行し、報告に書く。
KAG版で得た知見を公開版へ戻したいとき
この経路では戻さない。 KAG版には社内固有のテーマ・ドメイン・移行元リソースIDが入っており、
逆方向のマージは公開リポジトリへ社内情報が流れる経路になる。
公開版にも当てはまる知見は、公開版側で書き直してコミットする。
そのため、共通のドキュメント（docs/knowledge/ など）は公開版で書き、マージで流すのが正しい向き。
KAG固有の記述はKAG版の docs/knowledge/kag-specific.md と docs/kag-migration.md にだけ置く。
