SKILL.md
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/main4. コンフリクトしたら
自分の判断で解決してよいのは、次の場合だけ。
| 状況 | 解決 |
|---|---|
| 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 にだけ置く。