factory-queue

factory-queue

このスキルの機能

factory-queue は、ソフトウェアファクトリーの取り込み、トリアージ、計画の境界を管理します。トラッカーに依存しない統合レイヤー（factory-mission/references/tracker-integration.md）を使用し、唯一の信頼できる情報源である外部イシュートラッカー（Queue）を直接操作します。

主に次の2つのコントロールプレーン操作を実行します。

1. アドバイザリートリアージと取り込み（デフォルトの triage モード）：未トリアージの候補ブリーフを取得し、ステートレスな AI トリアージスコアリングを実行して、Intent Gate を人間に提示し、ゲート制御／ディスパッチラベルを設定します。
2. プロダクト計画（plan モード）：承認済みのプロダクト／アーキテクチャ上の決定と PRD／AD を読み込み、マイルストーン（完了条件）とエピックを生成して、構造化され、ラベルが付いたイシューとして Q に登録します。

---

使用する場面

• プロダクトの受付時に候補ブリーフをトリアージし、実行を承認する場合。
• プロダクト／アーキテクトのライフサイクルが収束した後、仕様を優先順位付けされたトラッカーイシューに分解する場合。
• 自動ラベル遷移ゲートを備えたアドバイザリー専用の Intent Gate を実行する場合。

使用しない場面：

• 機能のインナーループ実行（代わりに factory-mission を使用してください）。
• 単独の Markdown ジェネレーターとしての使用（イシュートラッカーへの接続が必要です）。

---

動作モード

1. 取り込みとトリアージモード（デフォルト）

候補イシュー（intent ラベル付き）またはローカルのドラフトブリーフを処理します。

1. 候補ブリーフの取得：アクティブなトラッカープロバイダーを特定し、ステータスが intent のイシューを取得します（factory-mission/references/tracker-integration.md）。
2. AI トリアージスコアリング：次の3つの観点から、ステートレスなアドバイザリースコアを算出します。
   • リスク：影響範囲、データの機密性、アーキテクチャへの影響（Low／Medium／High）。
   • 複雑さ：スコープとサービス間の依存関係（Low／Medium／High）。
   • エージェントの信頼度：エンドツーエンドの実行成功率の推定（0～100％、High／Medium／Low の区分）。
3. Intent Gate の提示：候補ブリーフとアドバイザリースコアを人間に提示します。無人で実行する場合（アクティブな人間のターミナルがない場合）、候補イシューにマーカー `` を付けた構造化コメントとして Intent Gate の内容と AI スコアを公開します。キューの実行は一時停止します。人間が提案を確認し、「approve」とコメントするか、ラベルを spec-gated に変更して承認します。再開後、キューはコメント／ラベルの状態を読み取り、処理を続行します。Human Intent Gate は必須です。ブリーフが自動で承認または却下されることはありません。
4. ラベルの設定：
   • 承認時：ライフサイクルラベル intent ──► spec-gated に遷移します。自動化ゲート（agent-can-execute または human-required）とディスパッチ（autonomous | supervised | interactive）のラベルを設定します。
   • 却下時：intent ──► cancelled に遷移します（またはドラフトを削除します）。
   • 保留時：バックログに移動します。

2. 計画モード

ライフサイクルの収束後に動作し、バックログを作成します。

1. 成果物の読み込み：承認済みの PDR と ADR、および生成された docs/adlc/product/PRD.md / docs/adlc/architect/AD.md を読み込みます。セッション開始時にチームのレコードクラスインデックスが注入されていない場合は、docs/adlc/memory/ からバインディングレコードを直接読み込み（読み込み順：まず docs/adlc/memory、次にレガシーの .adlc/memory にフォールバック）、そのフォールバックについて1行で明記します。
2. マイルストーンとエピックの生成：順序、要件のグループ分け、「完了の定義」を抽出し、優先順位付きのエピックとマイルストーンにまとめます。**ゲート／タスクのイシューは、factory-mission の正規テンプレートである references/mission-brief-template.md に従い、ミッションブリーフ形式（Goal / Constraints / Non-Goals / Success Criteria。各基準には測定方法を記載）を必ず使用します。**マイルストーンの説明には、デモの文と完了の定義を記載します（マイルストーンはグループ化のコンテナであり、実行単位ではありません）。イシューのタイトルには短い作業項目名を使います。[Gx] / Mx: の接頭辞は禁止です（グループ化はマイルストーンへの割り当てで行い、参照情報は説明に記載します）。
3. 重複チェック：既存のイシューを取得してタスクの概要を照合し、重複を防ぎます。
4. Q へのプッシュ：MCP を介して、エピックとマイルストーンのイシューをトラッカーにプッシュします。AI トリアージに基づき、各生成イシューに適切な自動化ゲート用ラベルとディスパッチラベルを付与します。
5. 出力：ローカルの仕様要素と新たに作成した外部トラッカーのイシューを結び付ける、バージョン管理された docs/adlc/product/roadmap.md を作成します。

---

不変条件と安全上の制約

1. ステートレス：プラットフォームは独自のキュー状態を保持しません。すべてのクエリと変更は、トラッカーの MCP／CLI コネクターを介してリアルタイムに実行されます。
2. ドライランによるゲート：**ドライランの確認なしに、トラッカーへの書き込みを行ってはなりません。**スキルは、すべてのイシュー、コメント、ラベル変更の詳細なプレビューを出力し、実行前にユーザーから明示的な確認を得る必要があります。
3. 参考情報としてのスコア：スコアは参考用のメタデータであり、人間によるゲートを決して迂回しません。