Chapter 24: AI でコードを読む

cd /path/to/unknown-project
claude

このプロジェクトの概要を教えてください。
- 何をするシステムか
- 使われている技術スタック
- ディレクトリ構造の説明
- エントリーポイントはどこか

@workspace このプロジェクトはどのような構造になっていますか？
主要なモジュールとその役割を教えてください。

// 例: 読んでいてよくわからない関数がある場合
function processTransactions(
  transactions: Transaction[],
  config: ProcessConfig
): ProcessResult {
  const grouped = transactions.reduce((acc, tx) => {
    const key = `${tx.userId}-${tx.type}`;
    if (!acc[key]) acc[key] = [];
    acc[key].push(tx);
    return acc;
  }, {} as Record<string, Transaction[]>);

  // ... 複雑な処理が続く
}

この processTransactions 関数が何をしているか、
ステップバイステップで日本語で説明してください。
特に grouped の作り方と、その後どう使われるかを中心に。

processTransactions 関数について教えてください。
1. この関数が何をするか
2. 引数の型 ProcessConfig はどのように定義されているか
3. この関数はどこから呼ばれているか
4. 想定されるユースケースは何か

# Claude Code への質問例
UserService クラスの依存関係を教えてください。
- このクラスが使っているサービス・リポジトリ
- このクラスを使っているファイル
- 循環依存はないか

ユーザーが注文を確定してから、注文データが
データベースに保存されるまでの処理の流れを
順番に説明してください。
関連するすべてのファイル・関数を含めてください。

src/services/AuthService.ts のログインフローを
Mermaid のシーケンス図で表現してください。
正常系とエラー系（パスワード不一致、アカウントロックなど）
を含めてください。

```mermaid
sequenceDiagram
    participant User
    participant AuthService
    participant UserRepo
    participant TokenService

    User->>AuthService: login(email, password)
    AuthService->>UserRepo: findByEmail(email)
    alt ユーザーが存在しない
        UserRepo-->>AuthService: null
        AuthService-->>User: AuthError("ユーザーが見つかりません")
    else ユーザーが存在する
        UserRepo-->>AuthService: User
        AuthService->>AuthService: verifyPassword(password, hash)
        alt パスワード不一致
            AuthService-->>User: AuthError("パスワードが違います")
        else 認証成功
            AuthService->>TokenService: generateTokens(user)
            TokenService-->>AuthService: { access, refresh }
            AuthService-->>User: { token, refreshToken }
        end
    end
```

注文の状態管理（pending → confirmed → shipped → delivered）を
Mermaid の状態遷移図で表現してください。

// ドキュメントがない関数
function calculateShippingCost(
  weight: number,
  distance: number,
  expedited: boolean
): number {
  const base = weight * 0.5 + distance * 0.1;
  return expedited ? base * 1.5 : base;
}

この calculateShippingCost 関数に JSDoc コメントを追加してください。
パラメータ・戻り値・使用例を含めてください。

/**
 * 配送コストを計算する。
 *
 * 基本コストは重量と距離から計算され、
 * 速達オプションが有効な場合は 1.5 倍になる。
 *
 * @param weight - 荷物の重量（kg）
 * @param distance - 配送距離（km）
 * @param expedited - 速達オプション（true の場合 1.5 倍）
 * @returns 配送コスト（円）
 *
 * @example
 * // 10kg の荷物を 100km 先に通常配送
 * calculateShippingCost(10, 100, false); // → 15
 *
 * // 10kg の荷物を 100km 先に速達配送
 * calculateShippingCost(10, 100, true); // → 22.5
 */
function calculateShippingCost(
  weight: number,
  distance: number,
  expedited: boolean
): number {
  const base = weight * 0.5 + distance * 0.1;
  return expedited ? base * 1.5 : base;
}

このプロジェクトの README.md を生成してください。
以下を含めてください：
- プロジェクトの概要
- セットアップ手順
- よく使うコマンド
- API の概要（主要なエンドポイント）