注目★★★★★Lobsters
Markdownを/srcへ、LLM時代の新しい仕様管理
30秒で把握
- 1Carson Gross が Markdown を文書からソースコードへ位置付けた
- 2生成コードの意図を /src/md に保存しコードとテストを導出
- 3プロンプト依存を減らし人間管理の仕様をコードの隣に配置
要約
Carson Gross は、LLMが生成するコードの意図を保持するため、Markdownを文書ではなくソースコードとして扱うべきだと論じた。開発中のプロンプトは一時的で、コードの根拠や設計判断が失われたり、Wikiやチケットに分散したりするため、生成コードの隣にMarkdownをチェックインする。提案する構成は /src/md で、README、TODO、概要、機能、データモデル、API、インフラの説明を置く。Markdownを仕様に近い人間向けの情報源とし、コードとテストはそこから導出する一方、テストは自動的な正しさの確認に分担させる。/src/md は主に人間が作成・管理し、生成コードとの同期を保つ必要がある。
あなたへの影響
LLMを使う開発チームは、プロンプト履歴に依存せず、設計意図をMarkdownとしてリポジトリに残す運用を次のスプリントで検証するとよい。
推奨：Markdownを仕様、テストを自動検証として分離すると、生成コードの変更理由を追跡しやすくなる可能性がある。