workflow-status

ワークフローステータス（オーケストレーターのセンサー）

読み取り専用の処理を1回実行し、固定のJSONエンベロープで次の内容をまとめて回答します。何が存在するか、何が何によってブロックされているか、今すぐ開始できる作業は何か、推奨される次のコマンドは何か。 スクリプトが決定論的な生成元です：scripts/workflow-status.mjs は公開済みの SENSOR_CORE シーケンス（6aを含むステップ1～9）を実行して、エンベロープを出力します。このスキルはスクリプトを実行し、JSONを読み取り、以下のリファレンスに照らして解釈し、人間向けのレポートを出力します。エンベロープを手作業で組み立てることはありません。

ターンの契約 — ターンを終了する前に確認する

✓ The script was RUN — `bun scripts/workflow-status.mjs [--json-only]
  [--last-envelope <json|path>] [--compact]` (node is the fallback when bun is
  absent, per the repository's runtime convention); the envelope is the script's
  stdout, never assembled by the model
✓ Nothing was edited, committed, pushed, or created — read-only, always
✓ `next.recommended` is non-bare (carries the unit's slug/NN, never a bare
  `/unit-lane`) AND the script computed it from the unit's resolved status:
  `idea`/`defined` → `/unit-lane <slug>` (or `/unit-lane --fix <n>` for a fix);
  `planned`/`in-progress` → `/execute-phase <NN>` (its triage block is the
  authority; no separate plan-receipt currency check, step 6a)
✓ `detail.crash_recovery` carries a verdict from the decision table and the
  envelope `state` matches it (CLEAN→OK, RESUMABLE→CONTINUE,
  AMBIGUOUS→NEEDS_INPUT)
✓ Every `detail.design_candidates[].next` begins with `/unit-lane `
✓ Every degraded dimension is named in `detail.degradations` as
  `unavailable-<source>-<cause>` — and, when `--last-envelope` was supplied, the
  no-progress guard's `workflow_observations` note is present (never a silently
  repeated bland recommendation)
✓ The envelope is emitted on **every** invocation, including a same-session
  natural-language follow-up about state — never replaced by prose
✓ The human-readable summary is printed, then the machine envelope (the script's
  JSON) is the ABSOLUTE last output

--json-only を指定した場合は、人間向けの要約を省略し、エンベロープのみを出力します。

コンパクトモード — --compact

--compact は同じエンベロープを出力しますが、リポジトリの履歴を省略します（成熟したリポジトリでは約半分のバイト数になります）。保持・除外する項目の正確な一覧はエンベロープのフィールドを参照してください。

使用する場面

• オーケストレーションのステップ間：外部ドライバーが実行し、文章を解析せずに次のコマンドとモデルのティアを決定します。
• 作業を手動で選ぶ前：「今すぐ開始できる作業は何か？」
• 品質の判定（review-change／audit-pr）やプロダクトの健全性の判定（product-audit）には使用しないでください — このスキルは状態を報告するだけで、判定は行いません。

ステップ0 — プロジェクトを検出する（必ず最初に実行）

エージェントガイドのワークフローの規約およびドキュメントマップに従います。スクリプトは、このスキルに必要なファイル（docs/features/ROADMAP.md、修正インデックス docs/fix/README.md、進行中の各機能フォルダーにある TASKS.md、progress.md、review-findings.md、および docs/workflow/REPOSITORY_STATE.md）を読み取ります。スクリプトが出力したフィールドを解釈する場合に限り、自分でそれらを読んでください。

段階的な読み込み — 固定されたセンサーの参照経路

参照を許可するリストは、以下にリンクされた7つのパスだけです。ほかの references/ パスを勝手に作成したり、読み込んだりしないでください。このスキルは読み取り専用のセンサーです。

1. センサーコア — スクリプトが実行するシーケンス
2. クラッシュリカバリー
3. エンベロープコア
4. エンベロープのフィールド
5. 実行前のエビデンス
6. ガードレール

ユニット、イシュー、調査結果、または推奨事項が存在する場合に限り、センサーシグナルを追加します。プロジェクトが空の場合、このファイルはスキップしますが、エンベロープのフィールドで定義された空の形式は引き続き出力します。プラットフォームに名前付きのプリミティブが実際にない場合に限り、移植性を追加します。--json-only を指定しても、基本ファイルはスキップしません。

移植性

このセンサーはリポジトリとForgeのコマンドのみを使用します。名前付きのエージェント機能が利用できない場合は、JSONの契約を変更せずに移植性に従ってください。

ほかのスキルとの関係

• advance のコンダクターに対するセンサー版です。外部のオーケストレーター（または advance 自身）が workflow-status を呼び出し、エンベロープに基づいてルーティングし、unit-lane／execute-phase／review-change／audit-pr／triage-issue を直接起動します。各ステップのモデルはそこで選択します。エージェント内の自動操縦を使わずに、同じループを実行します。
• audit-docs（一貫性を判定し、修正も可能）および product-audit（健全性を判定）の読み取り専用の姉妹スキルです。このスキルは状態を報告するだけです。
• スキーマの管理者：orchestration-envelope（内部用）。

完了条件

• スクリプトが実行され、レポート内のすべての主張がエンベロープに基づいています。記憶から推測した内容も、手作業で組み立てた内容もありません。
• detail.design_candidates、detail.features、detail.fixes、 detail.startable_now、detail.blocked_units、detail.open_prs、 detail.untriaged_issues、detail.urgent、detail.degradations、および detail.crash_recovery がエンベロープから読み取られ、エンベロープの state がクラッシュリカバリーの判定と一致しています。
• --last-envelope が指定された場合：進捗停止ガードが実行されます。停滞した /unit-lane のヒントは、何事もなかったかのように同じ内容を繰り返すのではなく、workflow_observations の注記として表示され、新たな書き込み経路は追加されません。
• 人間向けの要約（--json-only を指定した場合を除く）とエンベロープが出力され、エンベロープが最後に表示されます。
• どこにも変更が加えられていません。
• エンベロープに next.continuation が含まれる場合、次のコマンドのエコーでは、コマンドのトークンを正確に記述するのではなく、出力された next.continuation を引用します（表示用に rendering）。以下の人間向けの文章である → Next: ブロックはそのまま残します。

→ Next: エンベロープの next.recommended コマンドです。実際の状態に基づいて計算されるため、これが推奨コマンドです · 人間向けの概要を見る → 出力された表を読みます · プログラムからオーケストレーションする → スクリプトの JSON を解析します