掲載済み (2026-09-12号)
036 148文字 • 1分

Git の main ブランチを汚さない AI 振り返り台帳管理

日本語

掲載情報

概要

GitのOrphanブランチを活用し、AIエージェントの試行錯誤を記録する「振り返り台帳」をメイン履歴から分離・共有するアーキテクチャの提案。

詳細内容

AIによる開発(ハーネスエンジニアリング)を効率化するための「振り返り台帳」の管理設計を紹介しています。従来のセッションごとの振り返りでは、コンテキストの肥大化や、デバイス間(ローカルとクラウド)での台帳共有の欠如が課題となっていました。この解決策として、GitのOrphanブランチを2層構造で使用する手法を提案しています。追記専用でコンフリクトを回避する `harness/journal` ブランチと、情報を集約・管理する `harness/ledger` ブランチに分離することで、mainブランチのコミットログを汚さずにデータの整合性と共有性を確保します。また、LLMがGit操作を容易かつ低コストに行えるよう、操作を抽象化したシェルスクリプトを介在させる運用の実用性についても言及しています。