44:I[83861,["/_next/static/chunks/0dbhjjzl8qfwv.js","/_next/static/chunks/07etdht~j~kj-.js"],"default"] 45:T926,

AIと一緒に開発していると、さまざまな種類のファイルを目にする。最初によく登場するのがMarkdownファイル（.md）。# で見出し、- で箇条書き、というシンプルな記法で書く文書形式だ。CLAUDE.md も、README.md も、この形式。プログラムではなく「人が読む文書」のための言葉。

データを扱うとき、特によく見るのがJSON（.json）。{ "key": "value" } のように中括弧で囲んでデータを表現する。package.json（プロジェクトの設定）、API のレスポンス（Webがデータを返すとき）など、ありとあらゆる場所に使われている。

似たような用途だが歴史が長いXML（.xml）もある。タグで囲んで構造を表す形式で、HTMLに見た目が近い。古くからシステム間のデータ交換に使われてきた。Claude Codeに渡す長い指示の中に XML タグが含まれることもある。

絶対に外に漏らしてはいけない情報の置き場所が.envファイル。APIキーやパスワードを KEY=VALUE の形式で書いておく。GitHubにはアップロードしないのが鉄則。Cloudflareにデプロイするときは、ダッシュボードの「Secrets」に直接入力する。

設定ファイルでよく見るのがYAML（.yaml）。インデントで階層を表す形式で、JSONより人が読みやすい。GitHub ActionsやCloudflareの設定によく登場する。ただしインデントがずれるとエラーになる、少し繊細な形式でもある。

表形式のデータにはCSV（.csv）が便利。列をカンマで区切り、行で1件のデータを表す。ExcelやGoogleスプレッドシートがそのまま開けるので、データをAIに渡したりエクスポートして確認したりするのに使いやすい。

形式の数は多く見えるが、それぞれが「何のため」に使われるかを知っておくと、AIが「このファイルを編集します」と言ったときに何が変わろうとしているかが分かるようになる。

ファイルとデータ形式