Epic プロジェクト管理ガイドライン

背景

Epicは、戦略的テーマを共有する Issue とサブ Epic のセットを組織化し管理する方法を提供します。論理的なグルーピングに加えて、Epic はプロジェクトマネージャーがより高レベルの計画を実行し、視覚的なステータス追跡を伴うロードマップを構築することを可能にします。

Epic はグループレベルで定義されます。
Epic はコンフィデンシャルにできます。
Epic は子として Issue と Epic の両方を含むことができます。
Epic は Issue リストや Issue ボードのフィルタとして使用できます。
Epic は子 Epic、Issue ステータス、ロードマップタイムライン（ガントチャート）への可視性を提供します。
Epic は開始日または期日が含まれている場合、ロードマップビューに表示されます - すべてのマーケティングロードマップはこちら。
子 Epic も、開始日または期日がある場合、親の下にネストされた状態でロードマップビューに表示されます。
ロードマップビューは、Epic にリンクされた Issue の Issue 重みの集計完了に基づいて、Epic とその完了ステータスのタイムラインを提供します。
ロードマップビューは、個別の Epic とグループページの Epics > Roadmap で利用可能です。グループページのビューでは、追加のフィルタリング、ソート順、表示用のタイムライン単位を提供します。
Issue は単一の Epic の子にしかなれません。
Epic は、合計で 7 レベルの深さまで複数の子 Epic を持つことができます。

Epic はテンプレートから作成できません（Issue）。ただし、3 つの回避策があります。
1. 第一 - Epic は Epic に昇格された Issue から作成できます（この場合、Issue テンプレートが Epic テンプレートの代替となる可能性があります）。
2. 第二 - Epic に関連する Issue の組み合わせは、スプレッドシートでテンプレート化し、所与の Epic に関連する Issue を生成するためにアップロードできます。このEpic テンプレート概要を参照 - 複数の GitLab プロジェクト/チームにまたがる協働 Epic の場合、注意: このプロセスでは、Issue がまたがるプロジェクト/チームの総数だけ、プロジェクト/チームごとに分けてスプレッドシートのアップロードを完了する必要があります。
3. 第三 - 関連するハンドブックページに Epic のコードを含めて、issuable テンプレートのハイパーリンク付きでコピペできるようにします。例としてこのハンドブックページを参照。
Epic にはアサイニーがいません。
Epic はプロジェクト内では作成できません（Issue）。
Epic はクローンできません（Issue）。
Epic は親グループより上の Issue を含むことができません（Epic）。
機能リクエスト: カレンダービュー（Issue）。

ロードマップビューは、唯一の信頼できる情報源として、また、チームが取り組んでいる戦略的テーマ、OKR、マーケティングプロジェクト、キャンペーンを効果的に理解する高レベルな概要として役立ちます。

親 Epic への単一のリンク、または（任意で）フィルタリングされたグループのロードマップページへのリンクを、リーダーシップの可視性のために使用できます。

その後、マイルストーンと Issue ボードを使用して、個別のタスクステータスをより詳細に把握するために詳細を掘り下げることができます。

OKR Epic または戦略的テーマ Epic に関連するすべての Epic は、ロードマップ上で適切に整合させるために、それらの1 つだけを最終的な祖先として示すべきです。

ロードマップビューが表示され、有意義な視覚的タイムライン情報を提供するためには、計画プロセス中に Epic に開始日と期日を明示的に追加してください。

戦略的テーマや OKR の一部であるすべての Epic には、関連するエグゼクティブラベルを付けて、ロードマップビューでフィルタできるようにしてください。任意で、承認されたグループレベルラベルを 1 つ以上付けることもできます。

完了ステータスを追跡するための追加情報として、ロードマップは、すべての直接の子孫 Issue の合計 Issue 重みに対して、完了した子 Issue の重みに基づいた完了率を提供します。

ロードマップビューで Epic の完了状況を追跡しレポートできるように、すべての子 Issue に相対 Issue 重みを設定することが推奨されます。

ステータスレビュー前に、注意が必要な、またはリスクのある可能性のある Issue を強調することは良いプラクティスです。この情報はロードマップビューに表示できます。これが機能するには、個別の Issue にヘルスステータスを割り当てます。

UI でヘルスステータスを設定するか、/health_status および /clear_health_status のクイックアクションで設定できます。