レビュー・テスト・再リサーチループ プロジェクト管理ツール設定例
作成者: Manus AI
対象ツール: Notion、GitHub Projects、Jira、Linear、Asana、Trello、ClickUp、Google Sheets、Markdown/Git運用
1. この文書の目的
この文書は、レビュー・テスト・再リサーチループの進捗管理とタスク割り当てテンプレートを、実際のプロジェクト管理ツールへどう設定するかを示す実装ガイドである。目的は、テンプレートを文書として終わらせず、毎日の進捗、レビュー、テスト、再リサーチ、再提案、ゲート判定へ組み込むことである。
プロジェクト管理ツールに設定すべき中心概念は、要件ID、根拠ID、テストID、リスクID、レビューID、再リサーチID、再提案ID、ゲート判定である。ツールの種類は異なっても、このID接続が保たれていれば、素人が出した要望から実装、検証、改善までの追跡性を維持できる。
ツール選定より重要なのは、すべての作業が要件・根拠・テスト・リスク・レビュー・再提案に接続されていることである。
2. 共通データモデル
どのツールでも、まず以下のフィールドを共通項目として設定する。ツールがカスタムフィールドに対応していない場合は、カード本文またはMarkdownテンプレート内に同じ項目を持たせる。
| フィールド名 |
型 |
入力例 |
用途 |
| Item ID |
テキスト |
T-014 |
タスク、要件、レビューなどの一意ID |
| Item Type |
選択 |
Requirement / Test / Risk / Review / Research / Proposal / Gate / Task |
管理対象の種類を分類する |
| Phase |
選択 |
P1 Intent / P2 Research / P3 Requirement / P4 Harness / P5 Test / P6 Review / P7 Re-Proposal / P8 Release |
ループ内の位置を示す |
| Status |
選択 |
Backlog / Ready / In Progress / Review / Blocked / Done / Archived |
作業状態を示す |
| RYG |
選択 |
Green / Yellow / Red |
進行可否とリスク状態を示す |
| Priority |
選択 |
Must / Should / Could / Won't |
優先度を示す |
| Owner |
人 |
Harness Owner |
主担当を示す |
| Reviewer |
人 |
Codex Reviewer / Opus Reviewer |
レビュー担当を示す |
| Due Date |
日付 |
YYYY-MM-DD |
期限を示す |
| Source ID |
テキスト |
E-001 |
根拠や発生源を接続する |
| Requirement ID |
テキスト |
R-003 |
要件との接続を示す |
| Test ID |
テキスト |
TC-005 |
テストとの接続を示す |
| Risk ID |
テキスト |
RK-002 |
リスクとの接続を示す |
| Gate ID |
テキスト |
G-004 |
ゲート判定との接続を示す |
| Blocker |
テキスト |
公式規約確認待ち |
停滞理由を示す |
| Exit Criteria |
テキスト |
TC-005成功、OR-002解消 |
完了条件を示す |
3. 推奨ステータス設計
ステータスは、単なる作業進行ではなく、レビューと再リサーチへ戻れるように設計する。
| ステータス |
意味 |
次に進める条件 |
| Backlog |
まだ着手しない候補 |
優先度、担当、期限が決まる |
| Ready |
着手可能 |
根拠または前提が最低限揃っている |
| In Progress |
作業中 |
途中成果物がある |
| Review |
CodexまたはOpusレビュー待ち |
レビュー依頼文と対象IDが揃っている |
| Re-Research |
根拠不足または矛盾により再調査中 |
RR-IDと調査問いがある |
| Re-Proposal |
変更提案を作成中 |
RP-IDと影響範囲がある |
| Blocked |
外部要因または重大リスクで停止 |
解除条件と担当が明確 |
| Gate Decision |
Green/Yellow/Red判定待ち |
判定材料が揃っている |
| Done |
完了 |
完了条件と接続IDが満たされている |
| Archived |
対象外または終了 |
却下理由・履歴が残っている |
4. Notion 設定例
Notionでは、データベースを複数に分けるよりも、最初は単一の「Project Control Hub」を作り、ビューで切り替える構成がよい。小規模チームや非エンジニア中心のプロジェクトでは、Notionは説明文、テンプレート、レビュー履歴を同じ場所に置けるため導入しやすい。
| 設定項目 |
推奨設定 |
| データベース名 |
Project Control Hub |
| 主要ビュー |
Phase Board、RYG Risk View、Owner View、Gate View、Re-Research View、Release Readiness View |
| 必須プロパティ |
Item ID、Item Type、Phase、Status、RYG、Priority、Owner、Due Date、Requirement ID、Test ID、Risk ID、Exit Criteria |
| テンプレートボタン |
Requirement、Test Case、Risk、Codex Review、Opus Review、Re-Research、Re-Proposal、Gate Decision |
| 非エンジニア向けビュー |
Today、My Decisions、Red/Yellow Only、Needs Human Decision |
Notionカード本文テンプレート
# {{Item ID}} {{Title}}
## 目的
この項目は何を達成するためのものか。
## 関連ID
- Requirement ID:
- Evidence ID:
- Test ID:
- Risk ID:
- Gate ID:
## 現在の判定
- RYG:
- 判定理由:
- 解除条件:
## 作業内容
## レビュー依頼
- Codexに確認してほしいこと:
- Opusに確認してほしいこと:
## 完了条件
## 変更履歴
| Notionで成功させるポイント |
説明 |
| ビューを増やしすぎない |
最初は5ビュー程度で十分である |
| 非エンジニア用ビューを別に作る |
技術タスクの詳細より、判断が必要な項目だけ見せる |
| Yellow放置を防ぐ |
Yellow専用ビューと期限を必須化する |
| テンプレートボタンを使う |
毎回ゼロから書かない状態にする |
5. GitHub Projects 設定例
GitHub Projectsは、コード、Issue、Pull Request、CI結果との接続が強い。実装、テスト、レビュー、CIゲートを中心に運用する場合に適している。
| 設定項目 |
推奨設定 |
| Project名 |
Review-Test-ReResearch Loop |
| Issue Label |
requirement、test、risk、codex-review、opus-review、re-research、re-proposal、gate、red、yellow、green |
| Milestone |
P1 Intent、P2 Research、P3 Requirements、P4 Harness、P5 Tests、P6 Review、P7 Re-Proposal、P8 Release |
| Custom Fields |
Phase、RYG、Priority、Owner Role、Requirement ID、Test ID、Risk ID、Gate ID |
| Board Views |
Sprint Board、Gate Board、Red/Yellow Board、Review Queue、Release Readiness |
GitHub Issueテンプレート: 要件
## Requirement ID
R-XXX
## 要件文
## 根拠
- Evidence ID:
- Source:
## 受入基準
Given:
When:
Then:
## 関連テスト
- TC-XXX
## 関連リスク
- RK-XXX
## RYG判定
- 判定:
- 理由:
- 解除条件:
Pull Requestチェックリスト
## 関連ID
- Requirement ID:
- Test ID:
- Risk ID:
- Gate ID:
## 実装確認
- [ ] Must要件に対応している
- [ ] 受入基準を満たしている
- [ ] 破壊的変更がない、またはrollback手順がある
- [ ] dry-runまたはsandboxで検証した
- [ ] 監査ログがある
- [ ] CIが成功している
## Codexレビュー依頼
この差分について、実装破綻、CI不安定、テスト不足、破壊的変更、セキュリティ上の問題をレビューしてください。
## Opusレビュー依頼
この変更が目的、要件、運用、規約、リスク許容に照らして進めてよいかレビューしてください。
| GitHub Projectsで成功させるポイント |
説明 |
| PRと要件IDを必ず接続する |
コードだけ進む状態を防ぐ |
| CI失敗は自動的にYellowまたはRed扱いにする |
感覚的な「大丈夫」を排除する |
| Issueテンプレートを必須化する |
レビュー時に情報不足で止まることを防ぐ |
| Release前にGate Boardを見る |
本番前のYellow/Red残りを可視化する |
6. Jira 設定例
Jiraは、比較的大きなチーム、スプリント運用、承認フロー、権限分離が必要なプロジェクトに向いている。レビュー・テスト・再リサーチループでは、Issue Typeを分け、WorkflowにGate判定を組み込む。
| 設定項目 |
推奨設定 |
| Issue Type |
Epic、Story、Task、Bug、Risk、Research、Review、Gate、Change Proposal |
| Workflow |
Backlog → Ready → In Progress → Review → Re-Research/Re-Proposal → Gate Decision → Done |
| Custom Fields |
RYG、Requirement ID、Evidence ID、Test ID、Risk ID、Gate ID、Exit Criteria、Reviewer Role |
| Components |
Intent、Research、Requirements、Harness、Testing、Codex Review、Opus Review、Release |
| Automation |
Red作成時に責任者通知、期限超過Yellow通知、Gate Decision未完了でRelease禁止 |
Jira Story記入例
| フィールド |
設定例 |
| Summary |
R-001 ファイル一括アップロード |
| Description |
ユーザーは最大10件のファイルを一括アップロードできる |
| Acceptance Criteria |
Given/When/Then形式で記載 |
| RYG |
Yellow |
| Evidence ID |
E-001 |
| Test ID |
TC-001, TC-002 |
| Risk ID |
RK-001 |
| Exit Criteria |
TC-001成功、RK-001対策完了、G-003 Green |
| Jiraで成功させるポイント |
説明 |
| Issue Typeを分ける |
要件、リスク、再調査、レビューを混ぜない |
| Workflowに戻り経路を入れる |
ReviewからRe-Researchへ戻せるようにする |
| Release条件にGateを入れる |
Yellow/Redが残ったままリリースしない |
| Dashboardを作る |
Red件数、期限超過、未レビュー、未テストを常時表示する |
7. Linear 設定例
Linearは、軽量な開発タスク管理に向いている。スピードを重視しつつも、ラベルとプロジェクトを使ってループの接続を維持する。
| 設定項目 |
推奨設定 |
| Team |
Product、Engineering、Review |
| Project |
Review-Test-ReResearch Loop |
| Labels |
requirement、test、risk、research、proposal、codex、opus、gate、red、yellow、green |
| Cycles |
1週間または2週間 |
| Templates |
Requirement、Test、Review、Re-Research、Gate |
Linear Issue本文テンプレート
## Type
Requirement / Test / Risk / Review / Research / Proposal / Gate
## Related IDs
R:
E:
TC:
RK:
G:
## Context
## Task
## RYG
- Status:
- Reason:
- Exit Criteria:
## Review Notes
## Done Definition
| Linearで成功させるポイント |
説明 |
| ラベルを厳密に運用する |
軽量ツールではラベルが分類の中心になる |
| Cycleの終わりにGate確認を入れる |
スプリント終了時にYellow/Redを棚卸しする |
| ResearchとProposalをIssue化する |
調査・再提案が口頭で消えることを防ぐ |
8. Asana 設定例
Asanaは、非エンジニア、ビジネス側、外部協力者との共同作業に向いている。進捗、担当、期限、承認、フォーム入力を中心に使う。
| 設定項目 |
推奨設定 |
| Project |
Review-Test-ReResearch Program |
| Sections |
Intent、Research、Requirements、Harness、Testing、Review、Re-Research、Re-Proposal、Gate、Done |
| Custom Fields |
RYG、Item Type、Priority、Requirement ID、Test ID、Risk ID、Gate ID |
| Forms |
新規要望受付フォーム、再リサーチ起票フォーム、リスク報告フォーム |
| Rules |
RedならOwnerへ通知、Due Date超過ならBlockedへ移動、Gate未完ならRelease不可 |
Asanaフォーム項目例
| フォーム |
必須項目 |
| 新規要望受付 |
やりたいこと、目的、対象者、成功条件、不安な点、希望期限 |
| 再リサーチ起票 |
発生源ID、調査問い、調査範囲、判断基準、反映先 |
| リスク報告 |
リスク内容、影響範囲、発生可能性、重大度、希望対応 |
| Asanaで成功させるポイント |
説明 |
| フォームを入口にする |
素人の要望を構造化して受け取れる |
| 承認タスクをGateに使う |
非エンジニアが判断すべき箇所を明確にする |
| Sectionでループ全体を見せる |
今どのフェーズにいるかが分かりやすい |
9. Trello 設定例
Trelloは、小規模プロジェクトやPoCで、軽く始める場合に向いている。列設計とカードテンプレートを適切に作れば、最小構成のループ運用ができる。
| 設定項目 |
推奨設定 |
| Board |
Review-Test-ReResearch Loop |
| Lists |
Inbox、Ready、In Progress、Review、Re-Research、Re-Proposal、Gate、Done、Blocked |
| Labels |
Must、Should、Risk、Test、Codex、Opus、Red、Yellow、Green |
| Custom Fields |
Item ID、Requirement ID、Test ID、Risk ID、Due Date、Owner |
| Power-Up |
Custom Fields、Calendar、GitHub連携があれば有効化 |
Trelloカードテンプレート
## Item Type
## Related IDs
- R:
- E:
- TC:
- RK:
- G:
## Description
## Checklist
- [ ] 根拠がある
- [ ] 受入基準がある
- [ ] テストIDがある
- [ ] リスクIDがある
- [ ] レビュー済み
- [ ] Gate判定済み
## RYG
## Exit Criteria
| Trelloで成功させるポイント |
説明 |
| カードを巨大化させない |
詳細資料はリンクし、カードは進捗管理に絞る |
| Red/Yellowラベルを目立たせる |
リスクの見落としを防ぐ |
| Gate列を必ず置く |
Doneへ直接移動させない |
10. ClickUp 設定例
ClickUpは、多機能で、ドキュメント、タスク、ダッシュボード、自動化を一体管理しやすい。テンプレート体系を本格運用する場合に適している。
| 設定項目 |
推奨設定 |
| Space |
Product Development Safety Loop |
| Folders |
Intake、Research、Requirements、Engineering、Testing、Review、Release |
| Lists |
Intent、Evidence、Requirements、Harness、Test Cases、Reviews、Risks、Re-Research、Re-Proposals、Gates |
| Custom Fields |
RYG、Item Type、Priority、Phase、Requirement ID、Test ID、Risk ID、Gate ID、Exit Criteria |
| Dashboards |
Red/Yellow、Release Readiness、Review Queue、Test Coverage、Research Debt |
| ClickUpで成功させるポイント |
説明 |
| Listを用途別に分ける |
大量項目でも見通しが良くなる |
| Dashboardを経営・PM用にする |
進捗よりリスクと未判定を見せる |
| DocsとTasksを接続する |
テンプレート文書と実行タスクが分離しない |
11. Google Sheets 設定例
Google Sheetsは、導入コストが低く、非エンジニアでも扱いやすい。最初の導入、プロジェクト横断の台帳、レビュー記録には非常に使いやすい。
| シート名 |
内容 |
| 00_Dashboard |
Red/Yellow件数、未レビュー、未テスト、期限超過を集計 |
| 01_Intent |
要望、目的、対象、成功条件、不明点 |
| 02_Evidence |
根拠ID、出典、信頼度、関連要件 |
| 03_Requirements |
要件ID、優先度、受入基準、テストID、RYG |
| 04_Risks |
リスクID、重大度、対策、残リスク |
| 05_Harness |
sandbox、dry-run、rollback、ログ、権限 |
| 06_Tests |
テストID、対象要件、手順、期待結果、結果 |
| 07_Reviews |
Codex/Opusレビュー、指摘、判定 |
| 08_ReResearch |
再調査ID、問い、結果、反映先 |
| 09_ReProposal |
再提案ID、変更内容、影響範囲、採否 |
| 10_Gates |
ゲートID、判定、解除条件、承認者 |
| 11_Tasks |
タスクID、担当、期限、依存、状態 |
Google Sheets列設計例: Requirements
| 列名 |
入力例 |
| Requirement ID |
R-001 |
| Requirement Text |
ユーザーは最大10件のファイルを一括アップロードできる |
| Priority |
Must |
| Evidence ID |
E-001 |
| Acceptance Criteria |
Given/When/Then |
| Test ID |
TC-001 |
| Risk ID |
RK-001 |
| Owner |
Product Owner |
| Status |
Review |
| RYG |
Yellow |
| Exit Criteria |
TC-001成功、RK-001対策完了 |
| Google Sheetsで成功させるポイント |
説明 |
| 入力規則を使う |
RYGやStatusの表記ゆれを防ぐ |
| 条件付き書式を使う |
Redと期限超過を自動で目立たせる |
| Dashboardを作る |
素人でも全体状態を把握できる |
| ID列を固定する |
要件・テスト・リスクの接続を壊さない |
12. Markdown/Git 運用設定例
Markdown/Git運用は、エンジニア中心のチーム、ドキュメントをコードと同じようにレビューしたいチームに向いている。
| ディレクトリ |
内容 |
| docs/intent/ |
Intent Sheet |
| docs/evidence/ |
Evidence Matrix |
| docs/requirements/ |
Requirement Register |
| docs/technical/ |
Technical Requirements |
| docs/harness/ |
Harness Plan |
| docs/tests/ |
Test Plan |
| docs/reviews/codex/ |
Codex Review Reports |
| docs/reviews/opus/ |
Opus Review Reports |
| docs/risk/ |
Risk Register |
| docs/research/ |
Re-Research Logs |
| docs/proposals/ |
Re-Proposals |
| docs/gates/ |
Gate Logs |
Pull Request運用
| 変更内容 |
必須レビュー |
| 要件変更 |
Product Owner、Opus Review |
| 技術方式変更 |
Tech Lead、Codex Review |
| ハーネス変更 |
Harness Owner、Codex Review |
| テスト変更 |
QA Owner、Codex Review |
| リスク変更 |
Risk Owner、Opus Review |
| リリース判定 |
Gate Owner、Product Owner |
| Markdown/Gitで成功させるポイント |
説明 |
| ドキュメント変更もPRにする |
仕様だけ勝手に変わることを防ぐ |
| CODEOWNERSを設定する |
重要文書の承認者を固定する |
| CIでリンク切れやID重複を検査する |
トレーサビリティ崩壊を防ぐ |
13. ツール別おすすめ選定
| 状況 |
推奨ツール |
理由 |
| 非エンジニア中心、小規模 |
Notion、Google Sheets、Trello |
入力と閲覧が簡単 |
| コード開発中心 |
GitHub Projects、Markdown/Git |
PR、CI、レビューと接続しやすい |
| 中〜大規模チーム |
Jira、ClickUp |
権限、ワークフロー、ダッシュボードが強い |
| スピード重視の開発チーム |
Linear |
軽量でIssue駆動にしやすい |
| 外部協力者が多い |
Asana、Notion |
依頼、承認、フォーム運用に向く |
14. 最小構成で始める場合
最初から全ツール設定を完璧に作る必要はない。最小構成では、以下の4つだけを設定する。
| 最小構成 |
内容 |
| 1. Intake |
やりたいこと、目的、成功条件、不明点を受け取る |
| 2. Requirement/Test/Risk台帳 |
R-ID、TC-ID、RK-IDを接続する |
| 3. Review Queue |
Codex/Opusレビュー待ちを管理する |
| 4. Gate Board |
Green/Yellow/Redと解除条件を管理する |
15. 運用ルール
| ルール |
内容 |
| ルール1 |
Must要件はEvidence IDとTest IDがない限りReadyにしない |
| ルール2 |
Redは作業失敗ではなく、早期発見成功として扱う |
| ルール3 |
Yellowは期限、担当、解除条件がない限り放置禁止にする |
| ルール4 |
PR、タスク、レビューには必ず関連IDを書く |
| ルール5 |
レビュー指摘は修正タスクではなく、必要に応じてRe-ResearchまたはRe-Proposalへ変換する |
| ルール6 |
Doneにする前にGate Decisionを必ず通す |
16. ダッシュボード設計
| 指標 |
意味 |
望ましい状態 |
| Red件数 |
重大リスク・停止条件の数 |
0または明確な解除計画あり |
| Yellow件数 |
条件付き進行項目の数 |
期限付きで管理されている |
| Must要件テスト接続率 |
Must要件のうちTest IDがある割合 |
100% |
| 未レビューPR/Issue数 |
Codex/Opusレビュー待ち |
スプリント内で解消 |
| 再リサーチ未解決数 |
RR-IDで未完了の項目数 |
重要項目はGate前に0 |
| Gate未判定数 |
リリース前に判定されていない項目 |
リリース前に0 |
| 期限超過Yellow |
放置されている条件付き項目 |
0 |
17. 導入時の注意点
ツール設定で最も多い失敗は、フィールドを増やしすぎて誰も更新しなくなることである。最初は共通ID、Status、RYG、Owner、Due Date、Exit Criteriaに絞り、プロジェクトが成熟してからEvidence ID、Risk ID、Gate IDなどを厳密化する。
| 失敗パターン |
対策 |
| 入力項目が多すぎる |
必須項目を最小化し、詳細はテンプレート本文に書く |
| Redが嫌われる |
Redは責任追及ではなく安全発見と定義する |
| レビュー指摘が口頭で消える |
指摘を必ずIssueまたはカード化する |
| 再リサーチが進まない |
RR-IDに担当、期限、判断基準を付ける |
| Doneが曖昧 |
Done DefinitionとGate Decisionを分ける |
18. 結論
レビュー・テスト・再リサーチループをプロジェクト管理ツールに導入する際の本質は、ツールを高度に使うことではない。重要なのは、素人の要望から、根拠、要件、仕様、ハーネス、テスト、レビュー、再リサーチ、再提案、ゲート判定までが一つの流れとして追跡できる状態を作ることである。
Notionでも、GitHub Projectsでも、Jiraでも、Google Sheetsでも、共通IDとRYGゲートが崩れなければ運用できる。最初は小さく始め、YellowとRedを確実に管理し、レビュー指摘を必ず再リサーチまたは再提案へ戻すことで、開発破綻リスクを継続的に下げられる。