個人でこんなゲームを作っているひしょうです！
AIを活用する場面としてコード書いているときにチャットで
「この部分のエラーを修正して」とか「ここの挙動をこういう風に直して」など
大部分を自分で作って一部を修正してもらうような活用しかできていませんでした。
そこで大部分をAIに開発してもらうために、どのAIにどんな資料をどんなふうに読み込ませてどうやって開発するのがいいのかを考えます。

設計手法

AIと相談しながら以下のように資料を読み込ませ開発する手法でいくことにしました。
①AIが読み込める資料を以下の通りに作成していく
テキストベースのほうがAIが読み込めないと思うのでどんなツール使ってどういう形式で読み込ませるかを考えてもらいました。
また、設計するのも時間がかかるので開発規模に応じて適切な労力で作れるように優先度も入れています。

✅ AI活用のための資料一覧（優先度付き）

資料名	内容・目的	読み込み形式（推奨）	作成方法・ツール例	優先度
README	プロジェクト概要・目的	Markdown (.md)	VS Code, GitHub	🟥 高
機能仕様書	どんな機能を実装するか（ユーザー視点）	Markdown (.md) / JSON	Notion, Excel, VS Code	🟥 高
クラス図	クラス構造・責務・関係性の整理	Mermaid (.mmd) / PlantUML / Markdown表	StarUML（UI）→ PlantUML出力 or Mermaid手書き	🟧 中
開発ルール集	命名規則・ディレクトリ構成	Markdown (.md)	Notion, Obsidian, VS Code	🟧 中
シーケンス図	イベントや処理の流れ	Mermaid (.mmd) / PlantUML	StarUML（UI）→ PlantUML出力 or Mermaid手書き	🟧 中
画面仕様書	UI構成・レイアウト・文言	Markdown (.md) / JSON / Figma構造	Figma → JSON出力（ClaudeでMermaid化）	🟧 中
テスト仕様書	動作確認の手順・受入条件	Markdown (.md) / Excel	Excel, Notion	🟨 低
画面遷移図	画面間のナビゲーション構造	Mermaid (.mmd)	Figma → JSON出力（ClaudeでMermaid化）	🟧 中
用語集	特殊用語や略語の定義	Markdown (.md) / JSON	Notion, VS Code	🟨 低
データモデル（ER図）	データ構造とリレーション	Mermaid-ER記法 / Markdown表	dbdiagram.io（UI）→ コード出力 / Mermaid	🟧 中
ユースケース一覧	ユーザーの視点で見た操作目的	Markdown (.md) / 表	Excel, Notion	🟨 低
更新履歴（Changelog）	設計や仕様の変更ログ	Markdown (.md)	Gitログ, 手書き記録	🟨 低

②Claudeに読み込ませて資料をレビュー&補完してもらう
2025/6/1現在、Claudeが長文を読み込むの得意らしいです。
GitHubに挙げてリンクを渡してあげるかzipファイルにして直接読み込ませてあげます。
GitHubに上げるなら以下構成で上げるのがいいみたいです。

your-project/
├── docs/                  ← 設計資料はここにまとめる
│   ├── README.md
│   ├── feature-spec.md
│   ├── class-diagram.mmd
│   └── ...
├── src/                   ← ソースコード
│   └── ...
├── build/                 ← ビルド成果物（gitignore対象）
├── .gitignore             ← build/, *.log など除外設定
├── README.md              ← プロジェクト全体の概要
└── LICENSE

③CursorでClaudeを選択しクラスを一つずつ実装していく
全部作ってという指示だと途中で失敗する可能性が高いので一つずつ作ってもらいます。

実例

ここに実例を載せていく
個人開発向けのタスク管理ツールを作ってみた！