CLAUDE.mdテンプレート集｜コピペ例と失敗しない書き方

# Project instructions

## Purpose
- このプロジェクトは、顧客向けFAQサイトです。

## Working area
- 主な実装は `app/` にあります。
- 生成物の `dist/` は直接編集しないでください。

## Commands
- テスト: `bun test`
- 型チェック: `bun run typecheck`
- ビルド: `bun run build`

## Completion criteria
- 既存仕様を変えず、対象Issueを満たすこと。
- 変更に関係するテスト、型チェック、ビルドを実行すること。
- 最後に変更内容、検証結果、未確認事項を報告すること。

## Safety
- `.env`、秘密鍵、顧客データを読まない・出力しないこと。
- 削除、公開、本番変更は明示的な承認なしに実行しないこと。

# Web application

## Architecture
- React Router + TypeScriptで構成されています。
- ルートは`app/routes.ts`、画面は`app/routes/`にあります。
- 共通UIは既存コンポーネントを優先してください。

## Change policy
- 依頼に関係しないリファクタリングを含めないでください。
- 既存のレスポンシブ表示とキーボード操作を維持してください。
- 新しい依存関係は、必要性を説明してから追加してください。

## Verification
1. 変更箇所のテスト
2. `bun run typecheck`
3. `bun run build`
4. 対象画面のPC・モバイル確認

## Report
- 変更ファイル、ユーザーへの影響、検証結果を報告してください。
- 実行できなかった検証は理由と手順を残してください。

# Data processing workspace

## Goal
- `input/`のCSVから集計結果と検算レポートを作成します。

## Data rules
- `input/`の元ファイルを変更・上書きしないでください。
- 出力は`output/`へ新規作成してください。
- 欠損、重複、文字コード、日付・金額型を処理前に確認してください。

## Privacy
- 個人情報や顧客識別子を結果・ログへ出力しないでください。
- 想定外の機密項目を見つけた場合は処理を止めて報告してください。

## Verification
- 入力行数、除外行数、出力行数を記録してください。
- 合計値を別計算で照合し、差分があれば完了にしないでください。
- 仮定と未確認事項を`output/REPORT.md`に残してください。

# Content workspace

## Purpose
- 公式資料を基に、社内レビュー用の下書きを作成します。

## Source policy
- `sources/`にある資料だけを事実の根拠にしてください。
- 推測は「仮説」、確認できない内容は「要確認」と明記してください。
- 数字、日付、固有名詞には根拠ファイルを付けてください。

## Writing rules
- 読者、目的、次の行動を冒頭で明確にしてください。
- 根拠のない最上級表現や成果保証を書かないでください。
- 既存文の長い転載を避け、自分の言葉で要約してください。

## Completion criteria
- 主張と根拠の対応表を作ること。
- 人が確認すべき箇所を最後に一覧化すること。

# Team development rules

## Scope
- Issueに記載された範囲だけを変更してください。
- 既存のユーザー変更と競合した場合は上書きせず報告してください。

## Git
- 作業前後に`git status`と`git diff`を確認してください。
- 依頼なしにpush、merge、rebase、履歴改変をしないでください。
- 生成物、秘密情報、大容量ファイルをコミットしないでください。

## Quality gates
- 既存パターンを優先し、変更理由を差分で説明してください。
- テスト、型チェック、lint、ビルドのうち関連するものを実行してください。
- 失敗を隠さず、再現コマンドと影響を報告してください。

## Review handoff
- 何を変えたか
- なぜこの設計にしたか
- 何を検証したか
- 残るリスクと次に確認すること