team-levelup

team-levelup

このスキルの機能

セッション終了時のCDRライフサイクルです。完了したセッションから再利用可能なパターンを抽出し、信頼度を評価して一括レビュー用に提示し、承認されたCDRをteam-ai-directivesへのドラフトPRとして公開します。

従来のlevelup-specify、levelup-clarify、levelup-publishスキルを、1つの合理化されたワークフローに置き換えます。

N件のCDRを検索し、K件が一致しました。 0件が一致した場合は、セクション見出しと検索結果の行のみを出力し、表は出力しません。0行の表ヘッダーはレンダリングされない1行のMarkdownに折りたたまれるため、決して出力しないでください。

現在の作業ディレクトリにローカルのコンテキストモジュールの記録がなく、ディレクトリがワークスペース内にある場合（親ディレクトリの.gitmodulesマーカーで検出）、ワークスペースルートの記録を読み取ります。

使用するタイミング

該当するタスクの開始時に、ToDoリストの計画や実装に着手する前に呼び出してください。CDRのコンテキストが計画に反映されます。 セッション終了時まで呼び出しを先延ばしにしないでください。

• セッション終了時（自動）：.events.jsonでsession_endがこのスキルに対応付けられている場合
• 手動で呼び出す場合：作業完了後に/team-levelup
• ブランチを閉じる前：チーム全体で活用できる学びを抽出します

使用しないタイミング

• ブラウンフィールドの調査：既存のコードをスキャンするには/team-initを使用します
• ADR/PDR/ChDRの記録：それぞれのclarifyスキル（architect-clarify、product-clarify、change-clarify）を使用します

保存先

CDRドラフトは、team-ai-directivesの孤立ブランチadlcに保存されます。

team-ai-directives (adlc branch, orphan)
├── drafts/cdr/
│   ├── CDR-001.md        # Pending CDR
│   └── cdr.md            # Draft index
└── reports/
    ├── sessions/<user>/<YYYY-MM>.md
    ├── projects/<project>.json
    └── confidence-scores.json

mainブランチにはドラフトディレクトリはなく、context_modules/内に承認済みのCDRのみがあります。

プロセス

フェーズ0：環境のセットアップ

セットアップスクリプトを実行します。

scripts/bash/team-levelup.sh --setup

JSONを解析して、REPO_ROOT、TEAM_AI_DIRECTIVES、NEXT_CDR、ADLC_BRANCH_EXISTSを取得します。

TEAM_AI_DIRECTIVESが設定されていない場合は、/team-setupを実行するようメッセージを表示して終了します。

フェーズ1：セッションからCDRを抽出

現在のセッションを確認し、再利用可能なパターンを特定します。

1. ユーザーは何を依頼しましたか？
2. エージェントは何をしましたか？（ファイルの変更、重要な判断、アプローチ）
3. どのような再利用可能なパターンが見つかりましたか？
4. どのファイルが作成・変更されましたか？（git diff --stat、git log --oneline -10）

各パターンについて、共有テンプレートskills/team/templates/cdr-draft-template.mdを使ってCDRドラフトを作成します。

セッションのトレースをadlcブランチに書き込みます：reports/sessions/<user>/<YYYY-MM>.md。

フェーズ2：信頼度を評価

抽出したCDRごとに、信頼度を計算します。

タイプ別の基本スコア：

• ルール：0.60
• ペルソナ：0.50
• 例：0.50
• 憲章：0.70

加点：

• 対応する評価が存在する場合は+0.20
• エビデンスにファイルパスやコミットが含まれる場合は+0.10
• 複数のプロジェクトで同じパターンが参照されている場合は+0.10

使用状況の乗数（reports/confidence-scores.jsonから取得）：

• success_rate > 0.8：×1.2
• success_rate 0.5-0.8：×1.0
• success_rate < 0.5：×0.8

しきい値：

• ≥ 0.8：高 — 一括レビューを行い、レビュー後に自動承認
• 0.5-0.79：中 — 一括レビューが必要
• < 0.5：低 — ドラフトとして保持

フェーズ3：一括レビュー

従来のteam-learnのロジックと同様に、CDRを1件ずつ提示します。

## CDR-{ID}: {Title}

**Context Type**: {type}
**Confidence**: {score} ({HIGH/MEDIUM/LOW})
**Current Status**: {status}

### Current Content
...

### Choose Action

| Option | Action |
|---|---|
| A | Accept — Approve for implementation |
| B | Reject — Decline with reason |
| C | Defer — Skip for now, keep pending |
| D | Accept all remaining — Accept this and all pending CDRs |
| P | Promote to check (mechanical rules only) |

Reply with your choice (A/B/C/D/P).

続行する前にユーザーの入力を待ちます。判断のたびにCDRファイルを更新します。

コンテキストがない場合

このセッションでteam-bootによるチームコンテキストの注入がなかった場合（最初のユーザーメッセージにTeam Context & Decisionsセクションがない場合。プロジェクトが未設定、またはフックの失敗）、その旨を1行で伝え、Team Context & Decisionsの行を維持したうえで、ソース行に0 CDRs matched (no team context injected — run /team-setup)を記載し、直接読み取ったCDRモジュールを使ってタスクを続行します。注入がないことを、記録が空であることとして扱わないでください。復旧するには/team-diagnoseを実行します。

フェーズ4：公開

承認されたCDRについて、team-ai-directivesのmainブランチにドラフトPRを作成します。

1. adlcブランチのワークツリーに切り替えます
2. drafts/cdr/から承認済みのCDRを読み取ります
3. 信頼度のフロントマターを付けてOKF v0.2形式に変換します
4. mainブランチのcontext_modules/に書き込みます
5. ブランチを作成し、コミットしてプッシュし、ドラフトPRを作成します

フェーズ 5：使用状況データの書き込み

adlc ブランチに書き込みます。

• reports/sessions/<user>/<YYYY-MM>.md — プライバシーに配慮して情報を削除したセッションの概要
• reports/projects/<project>.json — CDR の一致／適用件数
• reports/confidence-scores.json を更新

フェーズ 6：通知

レポートを .adlc/team-levelup-report.md に書き込みます（ローカルのみ。コミットしません）。

## Team-Levelup Report

**Date**: {date}
**CDRs Extracted**: N
**CDRs Accepted**: N
**CDRs Rejected**: N
**CDRs Deferred**: N
**PR**: {URL or "none — no accepted CDRs"}

### Next Steps
1. Review PR (if created)
2. Run `/team-repair --update-confidence` after merge

競合の解決

2 つのプロジェクトが同じパターンのドラフトを作成した場合：

1. 最初のドラフトで、project: project-a を含む CDR-001 が作成されます
2. 2 つ目のドラフトは、一致する記述子を持つ既存の CDR を検出して統合します。
   • project: フィールドに project-b を追加します
   • エビデンスのセクションを追記します
   • 信頼度を上げます（複数プロジェクトによる検証）

チームコンテキストと意思決定

team-levelup は、team-boot が管理する Team Context & Decisions と連携します。 セッション中に検出された CDR クラスの意思決定は、記録候補として提示されます（/team-levelup を実行してドラフトを書き込みます。boot が書き込むことはありません）。 また、 同じセクションの表の行として追跡されます。各 CDR クラスの意思決定をタスクリストの todo としても反映してください（記録を提案 → セッション終了時に /team-levelup）。コードを変更するタスクの後には、Team Context & Decisions を確認するための todo を追加し、未記録：保留 0 件 · 未明確化：ドラフト 0 件 になるまで確認してください（ドラフトが「未明確化」から外れるのは、専用の明確化スキルを使った場合、またはユーザーが明示的に、名前を指定した明確化スキルもしくは実行スキルに引き継いだ場合のみです）。セッションの終了時に、未記録の意思決定ごとに（ID + 記録スキル）、記録済みドラフトごとに（ID + 明確化スキル）を明記して、明確化を促してください。ユーザーが明確化を先送りする場合は、該当する行を引き継ぎ済みとしてマークしてください。実際にセッション中に生じた意思決定のみを記録し、表の行を捏造しないでください。

検証

• CDR が adlc ブランチの drafts/cdr/ に書き込まれている
• セッションの概要が adlc ブランチの reports/sessions/ に書き込まれている
• 使用状況の件数が adlc ブランチの reports/projects/ に書き込まれている
• 受理された CDR が、main ブランチへのドラフト PR として公開されている
• team-levelup-report.md がローカルに書き込まれている
• main ブランチにドラフトがない