mainブランチの変更をkagブランチにも適用する。「kagにも反映して」「kag環境にも適用して」と言われたらこのスキルを使う。mainとkagは別環境なのでマージではなくチェリーピックで適用する。
公開版 marp-agent の変更を、KAG社内版 marp-agent-kag(ローカル ../marp-agent-kag)へ
git merge で流す。方向は公開版 → KAG版の一方向だけ。
公開版を本番へデプロイしたら、その場で実行する。 deploy-prod の完了条件に入っている。
みのるんは「本番側を触らせたときに自動で発動すればいい」と明示しているので、
聞かずに実行する。「KAGにも反映しますか?」と確認しない。
デプロイを伴わないコード変更でも、公開版の main へ push したなら実行してよい。
KAG版は公開版から280コミット以上先行している(版設定の抽象化、GHE対応、社内テーマ)。
必要なものを1つずつ拾う方式は破綻するので、git merge だけを使う。
両リポジトリの .githooks/prepare-commit-msg がチェリーピックを機械的に拒否する。
2026-08-20 に「ディレクトリ構成が食い違うので同期そのものを停止」していたが、
2026-08-22 のリアーキテクチャで構成が揃い、停止は解除された。
実測では agent/ 配下は自動マージで通り、コンフリクトしたのは
両側で別々に育てたドキュメント1件だけだった。
git -C ~/git/minorun365/marp-agent status --short
git -C ~/git/minorun365/marp-agent log --oneline @{u}..HEAD
未pushのコミットがあれば先にpushする(マージはリモートの upstream/main を見るため)。
git -C ~/git/minorun365/marp-agent-kag status --short
git -C ~/git/minorun365/marp-agent-kag branch --show-current
未コミットの変更があったら、そこで止めてみのるんへ報告する。
みのるんは20本以上の並行セッションを回しており、別のセッションがKAG版で作業中の可能性がある。
勝手に stash したりコミットしたりしない。ブランチが main でない場合も同じく止める。
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
自分の判断で解決してよいのは、次の場合だけ。
| 状況 | 解決 |
|---|---|
| KAG版固有の設定(ドメイン・モデル・テーマ・デプロイ手順) | KAG版側を採る |
| 公開版で直したロジック・バグ修正 | 公開版側を採る |
| 両側で別々に書き足したドキュメント | 両方を残す(並べて統合する) |
判断がつかないものが1つでもあれば、git merge --abort してみのるんへ聞く。
中途半端に解決してpushしない。
.gitattributes で merge=ours を指定しているファイル(cdk.json AGENTS.md CLAUDE.md
README.md LICENSE)は、そもそもコンフリクトせずKAG版の内容が残る。
新しくそういうファイルが増えたら .gitattributes へ足す。
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 だけでよい)。
マージしただけでは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版には社内固有のテーマ・ドメイン・移行元リソースIDが入っており、 逆方向のマージは公開リポジトリへ社内情報が流れる経路になる。 公開版にも当てはまる知見は、公開版側で書き直してコミットする。
そのため、共通のドキュメント(docs/knowledge/ など)は公開版で書き、マージで流すのが正しい向き。
KAG固有の記述はKAG版の docs/knowledge/kag-specific.md と docs/kag-migration.md にだけ置く。