Status: v1 Review cadence: Monthly Owner: Governance / Maintainer Related: EPIC #193 / pages/guides/governance/documentation-management.md
PlanGate の Issue 運用 (Issue 必須セクション / Label taxonomy / Milestone mapping) を正本化する。
ドキュメント配置・更新ルールは pages/guides/governance/documentation-management.md が正本。本ドキュメントは Issue / Label / Milestone 側 を扱う。
すべての PlanGate roadmap issue は以下のセクションを持つ。
| Section | Purpose |
|---|---|
| Why | この Issue が必要な背景・問題・コスト |
| What | scope / out-of-scope / suggested files / suggested outputs |
| Acceptance Criteria | チェック可能な完了条件（チェックボックス箇条書き） |
| Non-goals | 明示的にやらないこと、誤解防止 |
| Labels | 付与するラベル一覧 |
| Milestone | 紐付ける milestone |
| Parent EPIC / Roadmap | 親 EPIC / ロードマップ doc / 関連 PR の引用 |
軽微な bug / typo は bug_report.yml / feature_request.yml テンプレートで OK。Roadmap PBI は plangate-roadmap-task.yml を使う。
PlanGate ラベルは 4 軸で分類する。複数軸を組み合わせて付与する。
| Label | 用途 |
|---|---|
enhancement |
新規機能追加・改善 |
bug |
不具合修正 |
documentation |
ドキュメント変更が主体 |
governance |
運用ルール・ガバナンス変更 |
refactor |
振る舞いを変えないリファクタリング |
security |
セキュリティ関連 |
| Label | 用途 |
|---|---|
area:cli |
bin/plangate 関連 |
area:hooks |
scripts/hooks/ 関連 |
area:eval |
eval-runner / eval-cases 関連 |
area:schema |
schemas/ 関連 |
area:workflow |
docs/workflows/ 関連 |
area:metrics |
metrics 関連 |
area:docs |
公開 docs / pages 関連 |
| Label | 用途 |
|---|---|
priority:P0 |
直近 milestone の必須項目 |
priority:P1 |
次 milestone 候補 |
priority:P2 |
中期計画 |
priority:P3 |
着手未定 |
| Label | 用途 |
|---|---|
status:blocked |
他 Issue / 外部要因で着手不可 |
status:in-progress |
着手中 |
status:needs-review |
レビュー待ち |
status:wontfix |
対応しない判断 |
note: 既存 Issue にこれらのラベルが未付与でも、新規 Issue 作成時から徹底する。一括 backfill は scope 外（Non-goals）。
vMAJOR.MINOR.PATCH の semver。次期予定 milestone は EPIC で先に作成する。
milestone をまたいで移動する場合（次期へ繰越など）は、Issue コメントに 理由 + 移動日 を残す。
新しい roadmap PBI を作成するときに通すチェックリスト。
- [ ] Title が `PBI-HI-NNN: <短い説明>` などロードマップ規約に沿っている
- [ ] Why / What / Acceptance Criteria / Non-goals が揃っている
- [ ] Suggested files / outputs が記載されている
- [ ] Parent EPIC / Roadmap doc / Related PR が冒頭で引用されている
- [ ] Labels (kind + priority、必要なら area) が付与されている
- [ ] Milestone が EPIC の表に従って付与されている
- [ ] 該当 milestone が GitHub 上に存在する（なければ先に作成）
- [ ] Acceptance Criteria は AI / human が機械的に検証できる粒度になっている
- [ ] EPIC の child policy / scope と矛盾していない
- [ ] documentation-management.md の Directory policy と矛盾していない
GitHub Issue テンプレートは .github/ISSUE_TEMPLATE/ 配下に置く。
| Template | 用途 |
|---|---|
bug_report.yml |
バグ報告 |
feature_request.yml |
軽量な機能要望 |
plangate-roadmap-task.yml |
EPIC #193 等の roadmap PBI |
config.yml |
テンプレート選択画面の設定 |
plangate-roadmap-task.yml は Section 2 / 5 を強制するために事前にスキャフォールドを提供する（Why / What / AC / Non-goals / Labels / Milestone を必須入力）。
EPIC issue は以下を満たす。
このガバナンスは新規 Issue 作成時から適用する。既存 Issue について：
closes #N / fixes #N / resolves #N のいずれかを書く（自動 close 対象）documentation ラベルを付ければ issue-link チェックを skip 可能（PR <!-- skip-issue-link-check --> でも可）