workflow-compliance-supervisor

ワークフロー準拠スーパーバイザー

このスキルは、ジャーニー主導型 UI／UX プロジェクトのガバナンス層です。システムが約束したことを実行したか、ステージを省略した場合に正当な理由があるか、ユーザーに誠実な理由と次のアクションを提示しているかを確認します。

デザイン／構築タスクは実行せず、senior-ui-ux-orchestrator の動作を上書きすることもありません。

動作モード

• gate：続行またはフェーズを終了する前に、現在のプロジェクトを確認します。
• review：既存のタスク計画、進捗状況、進捗画面、証拠一式を監査します。
• log：workflow-log.jsonl のイベントを追記または検証します。
• fixture-test：遅延スキップと偽の証拠のフィクスチャを実行します。
• explain：ステージが保留、スキップ、手戻り、またはブロックになった理由をユーザーに説明します。

必須ワークフロー

1. references/decision-framework.md を読みます。
2. references/evidence-and-log-rules.md を読みます。
3. 技術に詳しくないユーザーに出力を提示する場合は、references/user-messaging.md を読みます。
4. 正式なプロジェクトの TASK-PLAN.md を見つけます。
5. 宣言されたジャーニーレジストリを見つけます。デフォルトのローカルレジストリは $UIUX_SKILL_SYSTEM_ROOT/data/journey-registry.json です。
6. 宣言されたジャーニーのステージを、タスク計画の記述、進捗状況、レポート、スクリーンショット、ログと照合します。
7. 影響を受ける各ステージについて、continue、pause_for_user、return_to_rework、skip_with_reason、block のいずれかを決定します。
8. すべてのスキップについて、許容される理由コード、影響、次のアクションを必須とします。
9. done／Ran のすべての主張について、実際の証拠を必須とします。
10. ユーザーが実行または検証を依頼した場合に限り、サニタイズ済みのレポート／ログを書き込みまたは更新します。

判断状態

• continue：証拠が十分であるか、逸脱による重大な影響がありません。
• pause_for_user：ユーザーデータ、承認、予算、認証情報、または本番環境での確認が不足しています。
• return_to_rework：完了したという主張に証拠がないか、ジャーニーの契約に違反しています。
• skip_with_reason：許容される理由と明示された影響を伴って、ステージが意図的にスキップされています。
• block：続行すると、品質、プライバシー、合法性、本番環境の安全性、またはジャーニーの整合性が損なわれます。

厳守事項

• model_convenience、implicit_assumption、planned_counted_as_ran、tool_not_called_but_marked_done は受け入れないでください。
• 実行予定のコマンドを実行済みとして扱わないでください。
• デモの一部しか実行していない場合に、ジャーニー全体が完了したと主張しないでください。
• シークレット、トークン、Cookie、.env、リカバリーコード、非公開のスクリーンショット、生のプロバイダーペイロードを保存しないでください。
• 任意の外部ツール、クロール、アップロード、有料 API、本番環境へのデプロイ、分析、広告、アカウントの変更には、明示的な承認が必要です。

ローカル検証コマンド

python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_compliance.py" --fixtures
python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_log.py" --fixtures
python3 "$UIUX_SKILL_SYSTEM_ROOT/scripts/validate_workflow_compliance.py" --project "$PROJECT_ROOT" --journey new-premium-site --out "$PROJECT_ROOT/reports/workflow-compliance-report.md" --log "$PROJECT_ROOT/workflow-log.jsonl"

スキルパッケージのチェック：

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/workflow-compliance-supervisor
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/workflow-compliance-supervisor

引き継ぎ形式

Declared journey:
Checked artifacts:
Decision:
Reason code:
Evidence:
User-visible message:
Next action:
Can continue:
Must rework:
Skipped with accepted reason:
Blocked: