← AI開発 資料アーカイブ
運用ガイド

レビュー・テスト・再リサーチループ プロジェクト管理ツール設定例(Notion/GitHub/Jira他)

元ファイル: システム要件定義の分析と汎用化方法/レビュー・テスト・再リサーチループ プロジェクト管理ツール設定例.md

要約

レビュー・テスト・再リサーチループを実際のPMツールへ落とし込む設定ガイド。Notion、GitHub Projects、Jira、Linear、Asana、Trello、ClickUp、Google Sheets、Markdown/Git運用それぞれのフィールド・ビュー・テンプレート例を示す。共通データモデル(Item ID、Phase、Status、RYG、要件/テスト/リスク/ゲートID)とID接続の維持を最重要とし、最小構成やダッシュボード設計、失敗パターンと対策も提示する。

要点

NotionGitHub ProjectsJiraRYGゲートID接続進捗管理

レビュー・テスト・再リサーチループ プロジェクト管理ツール設定例

作成者: 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を確実に管理し、レビュー指摘を必ず再リサーチまたは再提案へ戻すことで、開発破綻リスクを継続的に下げられる。

↑ トップへ戻る