とは言え、まだ通常プランでは使うことが出来ないので...

最近の僕の仕事では AI を用いた開発について調査・確立しようと様々トライしています。

例えば Claude 3.5 Project を用いて次の様なイテレーション開発プロセスを試してみました。

Custom Instruction

###あなたの役割:"""
あなたは Web アプリケーション・SaaS を要件定義から設計・実装まで一貫して開発できる AI です。
"""

###絶対遵守のルール:"""
- チャットでのやり取りは日本語で行ってください。
- 私が事前に要求仕様書はファイルで Project knowledge にアップロードします。
- あなたが絶対に生成しなければならない成果物は以下の通りです。
  - 要件定義書
  - 画面フロー図 (mermaid)
  - ソースコード
- ソースコードは常に完全なコードを生成して下さい。ソースコード更新において一部分だけを生成するのは禁止です。
- 生成したソースコードは必ずパス・ファイル名を書いてください。
- 200行を越える大きなサイズのソースコードは、ファイルを分割してください
"""

###Web アプリケーションコードの技術要件:"""
- Node.js, v20.16.0
- Next.js
  - Next.jsは最新の ”App Router” です。古い “Pages Router” ではありません。間違えないで下さい
- Tailwind CSS
- Prisma ORM
- Supabase
- shadcn/ui
"""

(1) 初回のみプロセス

初期の真っ白な Next.js Project を構築します。

(2) 小さなイテレーションの繰り返し

npm run dev で動かし、画面をみながらいちゃもんをつけていくプロセスです笑

オレンジ色付箋の設計書のくだりは、コード量が少ないうちは正しいですが、多くなってくると AI が生成する結果の精度は低くなっていきます。そのため別途、プロジェクトの断片を与える方法が必要になってきます。

イテレーションの最後に、更新された Github のコードを１枚のテキストに dump して、次回のイテレーションのインプット（ゼロ・スタート地点）としています。

ソースコードを１枚１枚アップロードするのは大変なので、後述のツールで１ファイルに出力しています。
また、プロジェクト構造も意識的に教えてあげる必要があります。

本題の github repo を dump するツール

Claude for Enterprise が使えるようになるまでは「Project knowledge」にファイルでプロジェクト構造を渡してやる必要があります。この際に情報として重要なのは次の２点です。

プロジェクトの構造（ツリー）
ソースコードファイルの内容

そこで以下のツールを作りました。

次のコマンドで実行できます。Github Project のルートに移動して行います。

npx dumprepo

下記例の様に、(1)プロジェクト構造に続いて、(2)各ファイルの内容が標準出力されます。

//////////////// Project Structure ////////////////

{list of files with directory structure}

//////////////// FILE: {filename} ////////////////

{file content}

...

本ツールは簡易的に plain text で出力していますが、こちらの Claude のリファレンスに従うなら XML 形式の方が効果ありそうです。

実際には出力対象としたいファイル、そうでないファイルはプロジェクトによって多岐にわたります。このコマンドが初回実行された際に以下の dumprepo.json 設定ファイルが出力されます。

{
  "projectStructure": {
    "include": ["**/*"],
    "exclude": ["node_modules/**", "dumprepo.json"]
  },
  "textFiles": {
    "include": ["**/*"],
    "exclude": ["node_modules/**", "dumprepo.json", "*.svg", "package-lock.json"]
  },
  "dot": false
}

projectStructure は、(1)プロジェクト構造に出力するファイルの対象・対象外を指定できます。

textFiles は、(2)各ファイルの内容に出力するファイルの対象・対象外を指定できます。

dot は、↑のファイル捜査を glob で実行していますが、標準では .git/ の様なドット始まりのファイルは無視されます。これを無視したくない場合は true にします。