ARCHITECTURE.md

何？

AIエージェントにリポジトリ構造を理解させるためのテンプレート。全部英語だけどプロンプトに組み込むのに良さそう

テンプレート？翻訳して使おうかしら。

こんなのあるんだ

なるほど。フォルダの構成や意味を書いておくもの，と。AI用でもあるし，人間用でもある。リポジトリなどに限らず，職場のフォルダにこれを置いておけば，新人さんにも理解しやすい。更新はローカルLLMにでも

自分の環境ではREADMEやCLAUDE.mdでシステムの構造を説明していたので、こういう形で整理すると、人にもAIにもわかりやすくなるかも。

AIエージェントにリポジトリの全体像を効率良くインプットするためのmd。こういった内向きのGEOって大事。

この手のやつってAIにプロジェクトルール考えてって言えば作ってくれるし、それを標準化してといえばいい感じにやってくれるのでわざわざコレを引っ張ってくる価値は無い気がする。

AIがソースを読めばわかるものはドキュメントとして保存しない、が基本だと思っていますけど

これが必要になる5W1Hが分からない。ADR、OpenAPI、GitHub Actions Workflows、Terraformと重複する内容ばかり。

ARCHITECTURE.md などという主語デカなドメイン取ってこんな特定技術依存のテンプレート公開するとか、感心しないというかヤな感じというか、どんだけ自信あるんだよ。 https://github.com/timajwilliams/architecture

見りゃわかるじゃん？更新に使うトークンのがもったいないね

ディレクトリツリーや技術スタックの一覧は、エージェントならリポジトリやpackage.jsonを読めば分かる情報なので、書く価値が低い割にすぐ古くなる。こんなの使わず、whyを数行、AGENTS.mdに書けば済むだろうよ。