🤖 AI運用ルール

Claude_開発依頼書テンプレート

最終更新 2026年05月01日 / 22_AI運用ルール/Claude_開発依頼書テンプレート.md

Claude 開発依頼書 標準テンプレート

大串が「このクオリティを標準にしたい」と認定したフォーマット(2026-04-28認定)

新規システム・機能開発を Claude(または別セッション)に依頼するときに使う標準テンプレ。
これに沿って書けば、前提共有不要で、依頼文を渡すだけで Claude が動ける。


依頼を出す前に必読

依頼書を書く前に、必ず 31_システム開発部/_AI開発依頼の原則 を読む。

6原則:① 初期依頼の質 / ② 超具体的指示 / ③ まとめて修正 / ④ 動作チェック必須 / ⑤ 設計想定 / ⑥ 選択肢比較

開発時間の 80% は最初の依頼で決まる。


なぜこの形式が標準か

  • 依存関係が一発でわかる(読むべき書類リスト)
  • 環境情報が完備(パス・URL・DB・スタック)
  • ゴールが明確(ユーザー目線の目的+評価軸)
  • 守るべき制約が明文化(退化禁止・命名・コミット・デプロイルール)
  • 実装順序が Phased(Phase 1 から動ける)
  • 完了報告フローまで内蔵(Slack報告先・スクリプトパス)

→ Claude は「何から読めばいい?」「どこにデプロイ?」を聞き返さずに着手できる。


テンプレ全文(コピペ用)

[システム名]([新規 or 既存改修]・[1行説明])の開発を進めます。

【依頼書】
[依頼書のフルパス(Vault内)]

【新規リポジトリ作成パス(推奨)】
[/Users/oogushiyuuki/株式会社SCALE/プロジェクト名/]

【公開URL(予定)】
[https://xxx.pages.dev/]
(独自ドメイン: [候補ドメイン] 検討中)

【データベース】
[Supabase / Cloudflare KV / D1 / 不要]
- [テーブル名] [用途]

【作業前に読むべきもの】
1. この依頼書全文
2. [関連依頼書1]
3. [関連依頼書2]
4. CLAUDE.md (~/Obsidian/SCALE-Brain/CLAUDE.md)
5. [関連ナレッジ・競合分析など]

【ゴール】
[1〜3行で「誰の・何の問題を・どう解決するか」]
[品質基準があれば併記]

【評価軸/機能リスト】
[カテゴリ別 or 機能別に明示。点数制があれば点数も]
1. ...
2. ...

【超厳しい/譲れないポイント】
[ある場合は具体的に。プロンプト全文や評価基準まで含めてOK]

【守るべきこと】
- [品質基準を妥協しない]
- [既存システム(具体名)と API 連携]
- [スタック指定: Cloudflare Workers + Pages Functions など]
- [コスト/パフォーマンス制約]
- 編集前に git commit、変更後は npm run build && npx wrangler pages deploy
- 関数を消さない・退化禁止(実装ルール準拠)

【実装順序】
依頼書「N. 実装順序」に従って Phase 1 から進める:
- Phase 1(X営業日・最小動作): [機能ID列挙]
- Phase 2(追加X営業日): [機能ID列挙]
- Phase 3(追加X営業日): [機能ID列挙]

完了したら、依頼書の「N. 完了状況」をチェックし、Slackで報告してください。
slack_post.sh は /Users/oogushiyuuki/株式会社SCALE/scale-company/slack_post.sh にあります。
(司令名義: ./slack_post.sh shirei "メッセージ")

依頼書本体(リンク先MD)の必須セクション

依頼文だけでなく、参照先のMD依頼書本体にも以下のセクションを揃える:

# セクション 内容
1 概要 プロジェクト名・目的・1行サマリ
2 スコープ 含む機能 / 含まない機能
3 アーキテクチャ スタック・依存関係・データフロー図
4 データベース設計 全テーブルのカラム定義・インデックス
5 API仕様 全エンドポイント・I/O・認証
6 UI/画面設計 全画面のワイヤー・遷移図
7 実装順序 Phase 1〜3 ごとの機能ID列挙
8 機能一覧(IDマップ) A1, A2, B1... の機能リスト
9 評価基準 / 受け入れ条件 「動いた」と言える定量条件
10 完了状況 チェックリスト(Phase別)
11 特殊要件・プロンプト等 必要なら全文掲載

ハマりがちなNG例

NG 原因 直す
「いい感じに作って」 スコープ・評価軸不在 ゴール・評価軸を書く
「過去の実装参考に」+ パスなし 依存先不明 全パスを明記
「終わったら教えて」だけ 報告経路不明 Slack投稿コマンド明示
「APIで連携」 連携先のURL/認証不明 連携相手のシステム名・URL・認証方式まで書く
Phase分けなし 一気に作って事故 必ず最小動作 Phase 1 を切る

良い実例

  • TERASU Lens 開発依頼: 40_新規事業/TERASU/TERASU_Lens_開発依頼書.md
  • 全11セクション完備・評価10カテゴリ × 各100点・3視点プロンプト全文掲載・Phase 1〜3 明示

運用ルール

  • このテンプレに従わない依頼が来たら、Claude側から「テンプレに沿って書き直すと精度上がります」と提案してOK
  • 「【】見出し + 箇条書き」の構造を必ず維持(パース性のため)
  • 既存システム改修の場合は 31_システム開発部/_SCALE_全システム配置マップ.md のリンク を必ず読むべきものに含める
  • 退化リスクのある改修は _SCALE_全システム実装ルール.md も必読リストに入れる

最終更新: 2026-04-28