AI駆動型・双方向同期プロセスの確立

2026年現在のAIエージェント（Antigravity等）とGitHubを連携させた、効率的な開発プロセスについての決定ログ。

課題

ローカル環境の要件とGitHub Issues/Projectsを、AIエージェントの支援を受けて高度に同期させるプロセスを確立したい。

解決策: AI駆動型双方向同期

GitHubを「正解（Single Source of Truth）」とし、Antigravityをその編集エージェントとして活用するプロセスを採用する。

1. 準備

Antigravityに「権限」と「文脈」を付与する。

• 認証: export GITHUB_TOKEN=$(gh auth token)
• コンテキスト: .clinerules に gh コマンドの使用を明記。

2. 実行プロセス

ステップ1：既存Issueの解析

ローカル要件とGitHub Issueを突き合わせる。

指示例: "Issue #12の内容をローカルの要件と比較して、不足タスクをリストアップして"

ステップ2：実装計画の策定

AIが生成した計画をGitHub Issueに永続化する。

指示例: "最新の実装計画をIssue #12の本文に反映して"

ステップ3：GitHub Projectsへの連動

タスクを可視化し、進捗を管理する。

指示例: "Issue #12をProjectに追加し、ステータスを'In Progress'にして"

ステップ4：実装と自動進捗更新

実装完了ごとにIssueとProjectを更新する。

指示例: "タスク完了に伴い、Issueのチェックボックスを埋めてProjectステータスを更新して"

3. 運用のコツ

• 構造化テンプレート: Issue本文に ## Tasks 等の見出しを設ける。
• エイリアス活用: 複雑な gh project コマンドはスクリプト化してAIに教える。
• 双方向同期: Artifactsを作ったら必ずGitHubに反映させる。