世界最高基準リサーチ駆動・安全実装テンプレートパック README
作成者: Manus AI
1. パックの目的
このテンプレートパックは、非エンジニアが「やりたいこと」を自然言語で伝えるだけで、世界最高基準のリサーチ、要件定義、仕様書、技術要件、アーキテクチャ、ハーネス設計、テスト計画、CI品質ゲート、リスク対策、Codexレビュー、Opus再分析、再リサーチ、再提案までを一貫して進めるための実用文書群である。
重要なのは、単に文書を作ることではない。作った文書をレビューし、テストし、リスクを検出し、検出結果を再リサーチと再提案へ戻すことで、開発破綻、破壊的操作、規約違反、テスト不能、運用不能を事前に防ぐことである。
2. 主要成果物
| 区分 | ファイル | 用途 |
|---|---|---|
| 全体設計 | /home/ubuntu/world_class_template_system_blueprint.md |
テンプレート体系の思想、全体構造、判定方式を説明する設計書 |
| 運用ガイド | /home/ubuntu/world_class_template_operating_guide_and_prompt_library.md |
実際にAIへ投げるマスタープロンプト、Codex/Opusプロンプト、チェックリスト |
| ループ制度 | /home/ubuntu/world_class_review_test_rersearch_loop_protocol.md |
レビュー、テスト、リスク対策、再リサーチを循環させるプロトコル |
| リサーチ根拠 | /home/ubuntu/review_test_loop_research_basis.md |
NIST、OWASP、SRE、Anthropic、GitHub Actions等の根拠整理 |
| 既存強化レポート | /home/ubuntu/enhanced_development_failure_risk_loop_report.md |
Codex/Opus分担と発見から再提案へ戻す強化版レポート |
| 棚卸し | /home/ubuntu/template_system_inventory.md |
既存成果物と不足箇所の整理 |
| 生成スクリプト | /home/ubuntu/create_world_class_template_pack.py |
Markdownテンプレート一式を生成するスクリプト |
3. 18種類の実用テンプレート
生成されたテンプレート一式は、自然言語の希望から安全な開発準備へ進むための順序で使う。
| No | テンプレート | 役割 |
|---|---|---|
| 01 | Intent Intake | 素人のやりたいことを目的、制約、失敗回避へ変換する |
| 02 | Research Plan | 公式、論文、規約、コミュニティ、実装例を調査する計画を作る |
| 03 | Evidence Matrix | 判断と根拠を接続する |
| 04 | PRD | プロダクトの目的、成功指標、対象者を定義する |
| 05 | Requirements Definition | Must/Should/Later/Rejectと受入基準を定義する |
| 06 | Functional Specification | 機能、画面、状態、例外を定義する |
| 07 | Technical Requirements | 技術制約、非機能要件、セキュリティ要件を定義する |
| 08 | Architecture Design | 全体構成、依存関係、データフローを設計する |
| 09 | Software Design Document | モジュール、API、DB、処理詳細を設計する |
| 10 | Harness Design | mock、fixture、dry-run、sandbox、kill switchを設計する |
| 11 | Test Plan | Unit、Integration、E2E、Acceptance等を計画する |
| 12 | CI Quality Gate | lint、test、build、secret scan、coverageをゲート化する |
| 13 | Risk Register | 破壊的リスク、規約リスク、運用リスクを台帳化する |
| 14 | External API & Terms Check | 外部API、規約、自動化制限、Rate Limitを確認する |
| 15 | Codex Review Request | 実装、テスト、CI、ハーネス破綻を検出するレビュー依頼 |
| 16 | Opus Re-Analysis Request | 採否、MVP、運用、事業リスクを再分析する依頼 |
| 17 | Discovery & Reproposal Log | 発見事項を再リサーチと再提案へ戻す台帳 |
| 18 | Red/Yellow/Green Gate | 非エンジニアが進行可否を判断する最終ゲート |
4. 推奨利用順序
まず、ユーザーは自然言語で「やりたいこと」を書くだけでよい。AIはそれをIntent Intakeへ変換し、Research PlanとEvidence Matrixを作成する。次に、PRD、Requirements、Specification、Technical Requirements、Architecture、SDDを作る。その後、Harness、Test Plan、CI Gate、Risk Register、External API Checkを作成し、最後にCodexレビューとOpus再分析を通して、発見事項をDiscovery & Reproposal Logへ戻す。
5. 絶対ルール
| ルール | 理由 |
|---|---|
| 根拠なしMustを禁止する | 見た目だけ整った危険な要件を防ぐため |
| Must要件にはAC、Test、Riskを接続する | 作れる、試せる、止められる状態にするため |
| 本番書き込みはdry-runなしで進めない | 破壊的操作を防ぐため |
| 規約未確認の外部API自動化はNO-GOにする | アカウント停止や法的リスクを防ぐため |
| CodexとOpusを同じレビューにしない | 実装破綻と採否判断を分離するため |
| Redは失敗ではなく安全検出として扱う | 壊れる前に止める文化を作るため |
6. 次に見るべきファイル
実務で使う場合は、最初に /home/ubuntu/world_class_template_operating_guide_and_prompt_library.md を開き、マスタープロンプトをそのまま利用する。全体設計を理解したい場合は /home/ubuntu/world_class_template_system_blueprint.md を読む。レビューと再リサーチループを運用する場合は /home/ubuntu/world_class_review_test_rersearch_loop_protocol.md を読む。