Claude Code

手順: Claude Code 初期設定（リポ）

1. リポで claude を起動（または curl -fsSL https://claude.ai/install.sh | bash でインストール）
2. /init → CLAUDE.md の下書きを生成 → 20〜40 行に削る
3. tasks/todo.md を置く（共通 Plan）
4. （任意）.claude/skills/<name>/SKILL.md — 再利用ワークフロー
5. （任意）.claude/agents/<name>.md — 専用ツール・モデルを持つカスタム Subagent
6. （任意）Hooks — .claude/settings.json で Stop 時にテスト自動実行

project/
├── CLAUDE.md              # ★ 短い Rules
├── tasks/todo.md
├── docs/
└── .claude/
    ├── skills/phase4-tdd/SKILL.md
    ├── agents/security-reviewer.md   # カスタム subagent（任意）
    └── settings.json      # hooks（任意）

# CLAUDE.md（例・短く）

## 毎回
- 着手前: tasks/todo.md の終わりの条件（Done when）を読む
- 仕様: docs/ のみ（ここに API 詳細を書かない）

## 検証
- テスト: docker compose exec app bundle exec rspec <path>

## 禁止
- git push / commit はユーザー許可後のみ

手順: 典型ワークフロー（Claude Code）

出典: best-practices

A. Explore → Plan → Implement

1. Plan モード（または最初のプロンプトで「まず調査のみ」）
2. 調査結果を tasks/todo.md にチェックリスト化
3. 実装モードへ切替 → ファイルパスと検証コマンドを明示
4. テスト green → commit（許可後）

Phase3 設計のみ。コード変更なし。
docs/invoice-export/01_requirements.md を読み、不明点を質問リストに。

（Plan 確定後）
02_design.md に沿って InvoiceExportService を実装。
Done when: bundle exec rspec spec/services/invoice_export_spec.rb

B. セッション再開・チェックポイント

# 直近セッションを続ける
claude --continue

# セッション一覧から選ぶ
claude --resume

# 任意の時点へ巻き戻し（会話・コード・両方）
/rewind

長い transcript はコスト増 — 新規 + tasks/todo.md を優先（引き継ぎ）。/rewind はプロンプト送信ごとに自動スナップショット — 失敗した実装はいつでも戻せる。

C. 完了条件を設定して自律実行

# Done when 条件を登録 → ターンごとに評価 subagent が再チェック
/goal "rspec spec/services/ が all green"

# CI 系の長時間ループは permission-mode auto で承認プロンプトを省略
claude --permission-mode auto -p "fix all lint errors"

D. Skill を明示的に呼ぶ

/phase4-domain-tdd
spec/domain/invoice_export_spec.rb の在庫不足ケース 1 サイクルだけ

公式対応と配置

公式 BP → 本リポの対応（一覧）

公式 BP	本リポでの対応
検証手段を渡す（/goal · Stop hook）	プロンプトに rspec / make test · /goal "条件" · 完了前検証
CLAUDE.md は短く・/init で生成	初期設定 · Phase1 テンプレ
Subagents で調査をコンテキスト分離	.claude/agents/ 定義 · 調査の任せ方
副作用ある手順は disable-model-invocation	disable-model-invocation: true（Skill 設定）
失敗したら /rewind でチェックポイント復元	/rewind · git との組み合わせ（ワークフロー B）
lessons	tasks/lessons.md → 再発時 CLAUDE.md 1 行

手順: セッション引き継ぎ

1. 新規セッションを開く
2. tasks/todo.md を最初に渡す（パスまたは貼り付け）
3. 前回の続きが必要なら /resume（1 セッションに絞る）
4. チーム共有は docs/ を更新（チャット全文はコピペしない）

配置ツリー（Claude Code）

project/
├── CLAUDE.md                              # ★ 短い Rules（/init で生成）
├── CLAUDE.local.md                        # 個人上書き（.gitignore に追加）
├── tasks/{todo,lessons}.md
├── docs/
└── .claude/
    ├── settings.json                      # hooks・permissions
    ├── skills/phase3-design-doc/SKILL.md  # 再利用ワークフロー
    └── agents/security-reviewer.md        # カスタム subagent（任意）

CLAUDE.md はモノレポで packages/api/CLAUDE.md のように入れ子も可。親→子の順で自動マージされる。