AI開発における作業記録の新常識：セッションログからIssue/Plan/Progressへの移行
本記事は、AIを活用した開発プロセスにおいて、従来の「セッションログ（会話履歴）」の公開から、「Issue / Plan / Progress」という構造化されたドキュメントによる運用へと手法が変化した経緯を解説している。筆者は当初、AIが何を見て判断したか不明瞭な点に不安を感じたため、全ての開発セッションログを公開していた。しかし、AIの進化により作業効率が高まるにつれ、「会話全体」よりも「作業の構造化された記録」が必要だと考えるようになった。
この変化のきっかけは、AIが即座にコード修正に進むスピード感であった。筆者はそこで「まずコードを変更しないでください。先に実装計画を作成してください」と指示を出す運用を取り入れ、自然と以下の3つのファイル（issue.md, plan.md, progress.md）をタスクごとに残す形になった。このプロセスにより、AIの役割を単なる「実装者」から「作業整理役」へと切り替えることができた。
具体的には、まず`issue.md`で「何を解決したいか（ゴール、成功条件、制約など）」を明確化し、次に`plan.md`で「どう調査し、どう実装するか（調査手順、リスク、確認方法など）」という計画を立てさせる。この段階では人間がレビューを行い、作業範囲の妥当性を確認する。その後、AIに実際に作業を進めさせると、その過程や結果は`progress.md`に記録される。これにより、セッションログ全体を読む必要がなくなり、「何をしたか」「どのファイルを変えたか」「何が未確認か」といった必要な情報だけを抽出して引き継ぎが可能となる。
筆者はこの運用が、単なるAI開発のテクニックではなく、「人に仕事を依頼する際の基本的な手順（目的設定→計画策定→進捗報告）」に極めて近いものであり、AI時代におけるプロフェッショナルな仕事の進め方であると結論づけている。
背景
近年、大規模言語モデル（LLM）を活用したAI開発が急速に進展し、コード生成や修正の速度が飛躍的に向上した。しかし、その過程で「ブラックボックス化」する懸念が生じ、開発プロセスにおける透明性の確保が課題となっていた。本記事は、この技術的な進歩に伴う運用上の課題解決策を提示している。
重要用語解説
- セッションログ: AIとの対話履歴全体のこと。これまでは作業の根拠として全て公開されていたが、情報量が多すぎるため、現在は構造化された記録に置き換えられつつある。
- Issue / Plan / Progress: 開発タスク管理における標準的な三段階プロセス。①課題定義（Issue）、②実行計画策定（Plan）、③進捗・結果報告（Progress）の各フェーズをファイルとして分離し、作業の透明性を高めるための構造化された運用手法。
- バイブコーディング: 特定の正式な手順を踏まずに、AIとの会話の流れや勢いに任せて試作やプロトタイプを素早く作成する開発スタイル。アイデア検証には速いが、大規模な本番コードには適さないとされる。
今後の影響
このIssue/Plan/Progressの運用モデルは、AIによる開発作業における「信頼性」と「再現性」を飛躍的に向上させる。これにより、単なる技術的な効率化に留まらず、チームメンバー間での知識共有や後進への引き継ぎが容易になり、より高度なプロジェクト管理手法として定着することが予想される。