| id | plangate-rule-promotion |
| name | PlanGate ルール昇格判定 |
| description | 運用で発見されたレビューパターン (findings / retrospective) を分析し、新 skill への昇格候補 / 既存 skill 更新候補 / 人間判断が必要な項目に分類する |
| version | 0.1.0 |
| category | upstream |
| phase | upstream |
| applyTo | ["**/review-self.md","**/review-external.md","**/retrospective.md","**/decision-log.md"] |
| tags | ["plangate","rule-promotion","governance","skill-registry","upstream"] |
| severity | info |
| inputContext | ["fullFile","repoConfig"] |
| outputKind | ["summary","findings","actions","questions"] |
| modelHint | balanced |
Pattern declaration
Primary pattern: Reviewer
Secondary patterns: Inversion
Why: 運用上蓄積された review findings / retrospective を観察し、再発頻度・severity・自動化可能性の観点で skill 昇格候補を抽出する分類型レビューであり、同時に「候補が既存 skill と重複する場合は昇格しない」という停止条件(Inversion)を持つ。
Goal / 目的
- 運用で繰り返し検出されたレビューパターン(recurring findings / retrospective lesson / guardrail)を集約し、新 skill への昇格候補・既存 skill 更新候補・人間判断を要する項目に分類する。
docs/development/improvement-flow.md の 8 ステップのうち「classify(Step 2)」を自動化し、PdM/運用者が Step 3 以降(ドラフト作成・PR 化)に集中できるようにする。
- 昇格閾値を明示することで「単発の失敗に対する過剰形式化」を抑制し、skill registry の肥大化を防ぐ。
Non-goals / 扱わないこと
- 実際の skill SKILL.md をドラフトする責務(Step 3 のドラフト作成は人間または別 skill の責務)。
- 昇格候補のビジネス優先度付け(effort ヒントは出すが、意思決定は PdM の責務)。
- 単一 finding の severity 再評価(各 skill の severity 付与ロジックに委ねる)。
- retrospective に書かれた個々の incident の根本原因分析(
improvement-flow.md Step 1 の責務)。
Pre-execution Gate / 実行前ゲート
このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。
ゲート不成立時の出力: NO_REVIEW: plangate-rule-promotion — 昇格判定に必要な findings プールまたは retrospective 入力が不足
Gate と抑制条件の違い:
- Gate = 昇格判定の母集団(findings プールまたは human-attested retrospective)が無ければ判定自体が成立しないので実行しない。
- 抑制条件 = 実行した上で、個別候補の指摘を却下する(例: 既存 skill が既にカバー済み)。
False-positive guards / 抑制条件
- 既存
skills/*/SKILL.md の name / description / tags にカバー済みと判定される候補は昇格提案しない(skill-gap: <既存 skill id> として却下理由付きで [q] 出力する)。
- 単発(1 件のみ)の finding で retrospective / decision-log のいずれにも言及がない候補は昇格しない(
improvement-flow.md アンチパターン「1 回しか起きていない incident」を踏襲)。
- "ビジネス判断" / "事業価値判断" / "個別顧客合意" といった広範な業務判断を要するパターンは自動化困難として却下する(
[q] 出力)。
retrospective.md 内で "WONTFIX" / "不採用" / "見送り" と明記された項目は候補から除外する。