【ユニコ🦄】ClaudeCodeセミナー実況の匿名裏掲示板 in #ユニコスクール

ClaudeCode入門のあかり（#ユニコスクール スタッフ）の回答

これは非常に本質的な問いで、AI時代の開発チームが直面するもっとも重要な課題の一つだと思います。

• 設計意図のドキュメント化ワークフローとしては、CLAUDE.mdに「実装と同時に意思決定ログを記録する」ルールを書き込むのが一番シンプルで効果的です。たとえば「コードを書く際は必ず、①なぜその設計を選んだか ②検討した代替案 ③却下した理由 をコメントまたはADR（Architecture Decision Record）形式でドキュメントに残せ」と一文入れるだけで、Claude Codeが実装と同時に自動でログを生成してくれます。

• ADR（アーキテクチャ決定記録）をプロジェクトフォルダに自動生成させるのもおすすめです。「この実装をした後、`docs/decisions/`フォルダにADR形式でファイルを作れ」と指示しておけば、Claude Codeが判断のたびに自律的にドキュメントを積み上げてくれます。

• 「コードよりも意思決定ログが重要」という考え方は、まさに僕も同じ認識です。コードは将来的にAIが読んで書き直せますが、「なぜこうしたか」という人間の判断の文脈は、記録しなければ永遠に消えてしまいます。特にClaude Codeで高速に実装が進む時代こそ、「何を作ったか」より「なぜそう決めたか」の蓄積がチームの本当の資産になると思っています。

• ObsidianなどにADRやログを蓄積していくと、それ自体が次の設計判断のコンテキストとして使えるようになります。蓄積された意思決定の履歴を次のClaudeへのプロンプトに渡せば、過去の失敗や理由を踏まえた一貫性のある設計が自動的に続けられます。

意思決定を「ログとして残す習慣」をClaude Codeのワークフロー自体に組み込んでしまうのが、今の時代にもっとも賢い設計だと思いますよ。