※はじめに、レガシー現場ではそもそもAIを使えないという問題については本記事では触れない
レガシー現場におけるドキュメント運用の現実
AIは、Markdownなどのテキストファイルとの相性が良い。
そのため、NotionやConfluenceといったMarkdownでドキュメント管理するサービスを使って運用することが望ましい。または、GitHubにリポジトリで管理するといった方法もある。
しかし、システム開発の現場では、Office系(Excel,Word,PowerPointなど）ファイルを中心にドキュメント管理しているのが実情である。
人間と親和性の高いOfficeファイル運用をやめて、テキストドキュメント運用に移行することは容易ではない。
そのため、人間はOfficeファイルで管理を行い、テキストファイルに変換してAIに引き渡すといった運用の手間が生じていた。
この余計なプロセスが開発のスループットを低下させる要因でもあった。
その中で最近リリースされたClaude Coworkがこの人間とAIのコミュニケーション問題を解決する救世主となってくれたのである。
Officeファイルを扱える人間と親和性の高いCowork
Claude Coworkは、既存のOfficeファイル参照して編集することができる。
他のAIサービスでも参照や作成まではできたが、編集はできなかったと思われる。
（Claude CodeでもOfficeファイルの取り扱いが可能だが、非エンジニアにとって決して親和性の高いツールとはいえないため、普段コーディングを行わない上流工程中心のSEにとってClaudeCodeを使った運用は現実的とはいえない）
編集ができるとなぜ良いかというと・・
例えば、
「設計書(Excel)をレビューする」
「指摘管理表(Excel)に記載された指摘事項を設計書を修正する」
といった作業手順は以下のようになる。
-
設計書を読み取り、レビュー結果を指摘管理表に書き込む
-
指摘内容を確認して対応すべき指摘を判断して選定する
-
選定した指摘を指摘管理表から読み取り、設計書を修正する
-
指摘管理表のステータスを「修正済み」に更新する
-
設計書の修正を確認してステータスを「確認済み＝完了」に更新する
Coworkであれば、この手順を続けて実現することができる。
（2,5 は人が介在した方が良い）
しかし、１点問題がある。
CoworkはPCのローカルファイルやGoogleDriveなどのクラウド上で管理しているファイルに直接アクセスできるが、ネットワークドライブにアクセスできないという制約である。
ネットワークドライブに直接アクセスできない問題は、バグとしてIssueに上がっている。
[BUG] Cowork: Folder does not support UNC under Windows #45297
https://github.com/anthropics/claude-code/issues/45297
レガシーな現場、セキュリティに厳しいプロジェクトでは、クラウド上でファイル管理することが許されず、ファイルサーバで管理しなければならないためこのバグが解消されることを期待したい。
また、私が今検討している工程ごとの使い分けだ。
Officeファイルを中心とした設計作業：Cowork
・要件定義レビュー
・機能設計、設計レビュー
・テストケース作成、テストケースレビュー
・テスト実行（E2E）
プログラムコードを中心とした開発作業：Claude Code, Github Copilot
・実装（プログラミング）
・コードレビュー、修正
・テスト実行（ユニットテスト/統合テスト）
開発へのドキュメント引渡し自動化の検討
コーディングエージェントが実装を行う際に、Officeファイルを横断的参照するのはコストが高く、時間もかかる。
実装時は参照頻度が高いため、Markdown運用にしたい。
とはいえ、Office→Markdownの変換作業を都度人が行うことだけは絶対避けたい。
設計が一旦完了して実装フェーズに移行しても、実装中に設計バグが見つかったり、顧客からの要件追加や仕様変更等により設計書を修正することが発生するため、繰り返し自動変換できる仕組み化を検討する必要がある。
まだ実現ができていないが、以下の方法は１つの案である。
Excel変更時のMaekdown自動変換プロセス
このプロセスによってマウントしたドライブフォルダにMarkdownとして自動出力できるため、コーディングエージェントは変換されたMarkdownを参照することができる。
これにより、AIを気にかけることなく人間はこれまで通りの運用を継続することができるのではないかと考えた。
ここ半年は、モデルだけでなく搭載機能（Claude /loopや/ultrareviewなど）や周辺のエコシステムの進化もかなり速いため、自動化ツールの構築と運用を不要とするような機能追加を期待したい。