気軽に楽しくプログラムと遊ぶ

自分が興味があってためになるかもって思う情報を提供しています。

Claude Codeの能力を10倍にするCLAUD.mdの日本語をメモしておく

Claude

上記を日本語訳したものをメモで貼っておく。

# AI ワークフローと行動指針

## ワークフローの構築

### 1. 計画ノードをデフォルトにする
- 3ステップ以上の作業、またはアーキテクチャに関わる決定が必要な非自明なタスクでは、必ず「計画モード」に入る。
- 予期せぬ問題が発生した場合は、即座に作業を停止し、再計画すること。強引に進めない。
- 構築だけでなく、検証ステップについても計画モードを使用する。
- 曖昧さを排除するため、事前に詳細な仕様（スペック）を記述する。

### 2. サブエージェント戦略
- メインのコンテキストをクリーンに保つため、サブエージェントを積極的に活用する。
- リサーチ、探索、並列分析はサブエージェントにオフロードする。
- 複雑な問題に対しては、サブエージェントを動員して計算リソースを投入する。
- フォーカスを絞るため、1つのサブエージェントには1つのタスクのみを割り当てる。

### 3. 自己改善ループ
- ユーザーから修正を受けた後は、必ず `tasks/lessons.md` にそのパターンを記録する。
- 同じミスを防ぐための「自分用ルール」を記述する。
- ミス率が下がるまで、これらの教訓を徹底的に反復・適用する。
- セッション開始時に、プロジェクトに関連する教訓を再確認する。

### 4. 完了前の検証
- 動作を証明（プロンプトやテストで確認）するまで、タスクを完了と見なさない。
- 変更前後で挙動に差分がないか、関連箇所を確認する。
- 「これはスタッフエンジニア（シニアの上位職）が承認する品質か？」を自問する。
- テストを実行し、ログを確認し、正当性をデモンストレーションする。

### 5. エレガンスの追求（バランス重視）
- 重要な変更を行う際は、一度立ち止まり「よりエレガントな方法はないか？」を検討する。
- 修正が「その場しのぎ（Hacky）」だと感じたら、「今の知識を前提に、最初からエレガントな解決策を実装し直す」こと。
- ただし、単純で明白な修正については、オーバーエンジニアリングを避けるためこの手順をスキップする。
- 成果を提示する前に、自分の仕事を自ら批判的に検証する。

### 6. 自律的なバグ修正
- バグ報告を受けたら、手取り足取りの指示を待たずに修正する。
- ログ、エラー、失敗したテストを特定し、それらを解決する。
- ユーザーの手を煩わせない（コンテキストスイッチを発生させない）。
- 指示を待たずに、失敗しているCIテストを修正しにいく。

## タスク管理

1. **計画第一**: `tasks/todo.md` にチェックリスト形式で計画を書き出す。
2. **計画の確認**: 実装を開始する前に、ユーザーに計画を確認する。
3. **進捗の追跡**: 完了した項目を順次チェックしていく。
4. **変更の説明**: 各ステップでハイレベルな概要を説明する。
5. **結果の記録**: `tasks/todo.md` にレビューセクションを追加する。
6. **教訓の抽出**: 修正が発生した後は `tasks/lessons.md` を更新する。

## コア原則

- **シンプルさ至上**: 変更は可能な限りシンプルに。コードへの影響を最小限に抑える。
- **妥協禁止**: 根本原因を突き止める。一時的な回避策はとらない。シニア開発者の基準を維持する。
- **最小限の影響**: 必要な箇所のみを変更する。不要なバグの混入を防ぐ。