team-diagnose

team-diagnose

概要

adlc-team-skills の配線不具合を、証拠を優先して診断します。このチェーンは正確に5つのリンクで構成されており、それぞれ1つのコマンドで確認できます。コマンド出力のない診断は推測にすぎず、その推測がバグ報告に貼り付けられてしまいます。

対象範囲： このリポジトリが管理するのは .events.json とブートスクリプトの出力です。注入側（ディスパッチャー、エージェントごとに生成されるプラグイン）は adlc-cli が管理します。adlc-team-skills リポジトリの docs/event-hook-contract.md ファイルで境界を定めています。そこまでは診断し、その後は適切なリポジトリに報告してください。

使用するタイミング

• セッション開始時にチームコンテキストがない場合（Team Context & Decisions セクションがない）。
• 読み込まれるはずのルールが読み込まれなかった場合。
• アップデート後、インストールが予期しない動作をする場合。

使用しない場合： チームコンテキストのチェーンに関係のないアプリケーションのバグや、スキルの振る舞いに関する議論の場合（それは goldset／評価の問題です）。

基本的な手順

チェックは順番に実行し、最初に失敗した時点で停止して修正し、再実行してください。

#	症状の領域	チェック（実行するコマンド）	成功の条件
1	未設定	cat .adlc/init-options.json	実在する team_ai_directives のパスがある
2	ツールがない	command -v jq	PATH 上に jq がある（スキルレジストリで必要）
3	ハンドラーの不具合	プロジェクトのルートから bash .agents/skills/team-boot/scripts/bash/boot.sh	EXTREMELY_IMPORTANT で囲まれたディレクティブインデックスが標準出力に表示される
4	インストールが古い	（スキルリポジトリで）pytest tests/unit/test_generated_artifacts_sync.py -q を実行するか、skills/**/SKILL.md と .agents/skills/ の名前を比較する	ミラーがソースと一致する
5	注入側	エージェント用の生成済みプラグインが存在し、読み込まれているか？	1〜4が成功しているのにセッションにコンテキストがない場合 → adlc-cli の担当範囲 — 1〜4のチェック結果を添えて、そちらに報告する

「ルールが読み込まれなかった」場合は、まずセッション開始時にインデックスがあったことを確認し（チェック3の内容）、次にタスクがそのルールのディスクリプターに実際に一致したかを確認してください。オンデマンドの取得は一致に基づくものであり、心を読むわけではありません。

一連の処理全体のチェック： scripts/acceptance-test.sh は一時インストールを行い、チェーン全体をエンドツーエンドで検証します（実際のエージェントセッションを使うには --live を追加してください）。

報告形式

バグ報告には、失敗したチェック番号、コマンド、その出力（そのまま）、エージェント名／バージョン、リポジトリのインストール方法（npx skills add と adlc-cli のどちらか）を含めてください。要約や伏せ字にした説明ではなく、生の出力を記載してください。

注意すべき兆候

• コマンドを実行せずに結論を出す — 各チェックは1つのコマンドで実行できます。
• チェック3の出力を確認する前に「すべてを再インストールする」。
• チェック1〜3に失敗したのに、スキルの内容を原因として疑う（問題はスキルではなく設定です）。
• 注入側のバグを adlc-team-skills に報告する（チェック5で適切な報告先がわかります）。

このような兆候があれば、チェックを実行してから報告してください。

検証

以下を満たせば、診断は完了です。

• チェック1〜4をそれぞれ実行し、出力を記録した（または、証拠を添えて5の担当先に報告した）
• 失敗したリンクを、そのコマンド出力とともに特定した
• 担当するリポジトリに報告した