claude-task-worker 0.33.1 → 0.35.0

package/README.md

@@ -51,8 +51,12 @@ GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲す
 | `resolve-conflict` | `cc-resolve-conflict` (PR) | `/claude-task-worker:resolve-pr-conflict` | 1分 |
 | `check-dependabot` | `dependencies` (PR) | `/claude-task-worker:check-dependabot` | 1時間 |
 | `epic-issue` | `cc-epic-issue` (Issue, sub-issues が全て Close) | `/claude-task-worker:create-epic-pr` | 5分 |
+| `create-ui-design` | `cc-create-ui-design` (Issue) | `/claude-task-worker:create-ui-design` | 1分 |
+| `apply-ui-design` | `cc-ui-design-pr-created` (Issue) | `/claude-task-worker:apply-ui-design` | 1分 |
 
 > ℹ️ Issue 系ワーカーはすべて GitHub Issue Dependencies の `-is:blocked` 検索 qualifier でサーバ側絞り込みを行うため、未解決の blockedBy Issue を持つ Issue は対象外となる。
+>
+> ℹ️ `create-ui-design` / `apply-ui-design` は `claude-task-worker.json` の `uiDesign.enabled` が `true` のときだけ起動する（既定は `false`）。詳細は「[UIデザイン先行ワークフロー](#uiデザイン先行ワークフロー)」を参照。
 
 ### Epic（親Issue）連携
 
@@ -60,9 +64,63 @@ GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲す
 
 `epic-issue` ワーカーは、`cc-epic-issue` ラベル付きの親Issueに紐づくサブIssueがすべて Close されたタイミングで `/claude-task-worker:create-epic-pr` を起動し、エピックブランチからまとめてPRを作成する。
 
+### UIデザイン先行ワークフロー
+
+UI実装Issueについて、実装の前に Pencil（`.pen`）でデザインを作り、それを独立したPRとしてマージしてから実装へ進むフロー。デザインの見た目・構成を実装PRとは別に単体でレビュー・合意でき、合意済みデザインがリポジトリに永続化される。
+
+`claude-task-worker.json` の `uiDesign.enabled` によるオプトインで、既定（`false`）では2つのワーカーが起動しないため、Pencil を使っていないリポジトリの挙動は本機能の追加前と完全に一致する。
+
+```json
+{
+  "uiDesign": {
+    "enabled": true,
+    "designDir": "designs"
+  }
+}
+```
+
+| キー | 既定値 | 意味 |
+|---|---|---|
+| `uiDesign.enabled` | `false` | 本ワークフローの有効化。`false` の間は `triage-created-issue` がUI判定を行わず、2つのワーカーも起動しない |
+| `uiDesign.designDir` | `"designs"` | `.pen` とスナップショットの配置先（リポジトリルートからの相対パス） |
+
+フローは以下のとおり。
+
+```text
+cc-issue-created + triage-created-issue（ルーティング）
+  ├─ UI実装タスクでない → cc-exec-issue（従来どおり）
+  └─ UI実装タスク       → cc-create-ui-design
+        → create-ui-design ワーカー
+           ・.pen を作成/更新 + snapshots/ に PNG 出力
+           ・ブランチ cc-ui-design-<N> を push しデザインPRを作成（Refs #N。closing keyword は使わない）
+           ・PR に cc-triage-scope + cc-ui-design、Issue に cc-ui-design-pr-created を付与
+        → triage-pr / fix-review-point / resolve-conflict（既存フローでレビュー・マージ）
+        → apply-ui-design ワーカー
+           ・デザインPRが MERGED になるまで skip
+           ・Issue description に「## UIデザイン」セクションを追記
+           ・cc-ui-design-ready + cc-exec-issue を付与
+        → exec-issue（デザインを参照元として実装）
+```
+
+デザインPRは Epic PR ではないため `cc-release-ready` によるマージ保留の対象外で、`triage-pr` が通常どおりレビュー・マージする。`triage-pr` は `cc-ui-design` ラベル付きPRに対してコードレビューではなくデザイン向けの観点（差分が `.pen` とPNGに限定されているか、スナップショットとデザイン意図が読み取れるか、Issue要件を満たしているか）で評価する。
+
+デザインが不要と判明した場合は `create-ui-design` が理由をコメントして `cc-ui-design-ready` + `cc-exec-issue` を付与し、人手を介さず実装へ復帰する。Pencil が使えない環境やデザインPRが却下された場合は `cc-need-human-check` に落ちて停止する（共通除外ラベルのため無限リトライしない）。
+
 ### `--project` 指定時（ディスパッチャーモード）
 
-`--project` オプションを指定した場合、CLIは自身でワーカーを起動する代わりに [herdr](https://herdr.dev) 経由のディスパッチャーとして動作する。指定したプロジェクトごとにherdrのタブ（ペイン）を作成し、そのプロジェクトのディレクトリで（`--project` を除いた）同じコマンドを非同期実行させ、稼働状況をステータステーブルで監視する。詳細は「[`--project <name>` オプション](#--project-name-オプション)」を参照。
+`--project` オプションを指定した場合、CLIは自身でワーカーを起動する代わりに [herdr](https://herdr.dev) 経由のディスパッチャーとして動作する。指定したプロジェクトごとにherdrのワークスペースを作成し、そのルートペインで（`--project` を除いた）同じコマンドを実行させ、稼働状況をステータステーブルで監視する。詳細は「[`--project <name>` オプション](#--project-name-オプション)」を参照。
+
+### claude-task-worker プラグインの構成
+
+| ディレクトリ | 内容 |
+|---|---|
+| `plugin/skills/` | ワーカーが呼び出すスキル群と、対話セッションから使う補助スキル（`commit-push` / `create-pr` / `breakdown-issues` / `edit-pencil-design` など） |
+| `plugin/agents/` | サブエージェント定義（`explore-agent` / `frontend-implementer` / `general-purpose-assistant` / `lightweight-assistant` / `pencil-design-updater` / `requirement-todo-organizer`） |
+| `plugin/hooks/` | `SessionStart`（worktree セットアップ・`git fetch --prune`）と `UserPromptSubmit`（`codegraph prompt-hook`）のフック定義 |
+| `plugin/scripts/` | フックから呼ばれるスクリプト（`setup-worktree.sh` / `stop-servers.mjs`） |
+| `plugin/.mcp.json` | プラグインが提供する MCP サーバー定義（下記「[プラグインが利用する MCP サーバー](#プラグインが利用する-mcp-サーバー)」） |
+
+ワーカー起動スキルには `Stop` フック（`plugin/scripts/stop-servers.mjs`）が設定されており、スキル終了時に `docker compose down` と、worktree を作業ディレクトリに持つ残留プロセスの `SIGTERM` をベストエフォートで実行する。worktree はスキル完了直後に削除されるため、切り離されたサーバープロセスが残ると削除の妨げになるのを防ぐ。
 
 ## 必要なライブラリ
 
@@ -77,8 +135,10 @@ CLI 本体に npm の実行時依存パッケージはない（ビルド時に e
 | [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) | - | タスク実行エンジン。各ワーカーが Claude CLI プロセスとして起動する |
 | [Git (`git`)](https://git-scm.com/) | - | worktree の作成・ブランチ操作 |
 | [jq](https://jqlang.org/) | - | プラグインスキル内でのJSON加工（`check-dependabot` / `edit-pencil-design` スキルなどで使用） |
+| [CodeGraph (`codegraph`)](https://www.npmjs.com/package/@colbymchenry/codegraph) | - | コード探索用のインデックス。MCP サーバー（`codegraph serve --mcp`）としてプラグインから起動される。`install` / `update` / `init` が面倒を見る。未インストールでもワーカーは動作する（探索がテキスト検索に落ちるだけ） |
 | [Pencil CLI (`pencil`)](https://docs.pencil.dev/for-developers/pencil-cli) | - | `.pen` デザインファイルの編集・参照・コンフリクト解消（`edit-pencil-design` / `inspect-pencil-node` / `resolve-pencil-conflict` スキルで使用） |
-| [herdr](https://herdr.dev) | - | `--project` 使用時にのみ必要（通常ワーカー実行には不要）。複数プロジェクトへのディスパッチ・セッション監視・一括停止に使用 |
+| [herdr](https://herdr.dev) | - | `--project` 使用時と `mode: "herdr"` 使用時にのみ必要。複数プロジェクトへのディスパッチ・セッション監視・一括停止、タスクのTUI実行に使用 |
+| [Headroom (`headroom`)](https://github.com/headroom-ai/headroom) | - | `headroom: true` 使用時にのみ必要。タスクの claude をコンテキスト圧縮プロキシ経由で起動する |
 | `claude-task-worker` プラグイン | - | 各ワーカーが呼び出すスキル群（本リポジトリの `plugin/`） |
 
 Slack通知（任意）を使う場合は Slack Incoming Webhook URL が必要。Claude API使用状況の取得には、macOSでは `security` コマンド（Keychain）を使用し、それ以外の環境では `~/.claude/.credentials.json` にフォールバックする。
@@ -102,6 +162,7 @@ Slack通知（任意）を使う場合は Slack Incoming Webhook URL が必要
 
 | サーバー | 接続方法 | 用途 |
 |---|---|---|
+| `codegraph` | `codegraph serve --mcp`（stdio） | シンボルの定義元・参照元・呼び出し関係をたどるコード探索。ワーカー起動セッションは `--append-system-prompt` の指示により、`Grep`/`Glob` より優先してこの MCP を使う |
 | `context7` | HTTP（`https://mcp.context7.com/mcp`） | ライブラリの最新ドキュメント取得 |
 | `next-devtools` | `npx -y next-devtools-mcp@latest` | Next.js 開発支援 |
 | `shadcn` | `npx shadcn@latest mcp` | shadcn/ui コンポーネント情報の取得 |
@@ -114,7 +175,9 @@ Slack通知（任意）を使う場合は Slack Incoming Webhook URL が必要
 - [GitHub CLI (`gh`)](https://cli.github.com/) がインストール・認証済みであること
 - [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) がインストール済みであること
 - `claude-task-worker` プラグインがインストール済みであること（下記インストール手順を参照）
-- `--project` オプションを使う場合のみ、[herdr](https://herdr.dev) がインストール済みであること（通常のワーカー実行には不要）
+- `--project` オプション・`mode: "herdr"` を使う場合のみ、[herdr](https://herdr.dev) がインストール済みであること
+- `headroom: true` を使う場合のみ、[Headroom](https://github.com/headroom-ai/headroom) がインストール済みであること
+- CodeGraph はコード探索の精度向上のために推奨（`install` / `init` が導入・インデックス構築を行う）。未導入でもワーカーは動作する
 
 詳細は上記「[必要なライブラリ](#必要なライブラリ)」を参照。
 
@@ -122,7 +185,7 @@ Slack通知（任意）を使う場合は Slack Incoming Webhook URL が必要
 
 #### 推奨手順（一発セットアップ）
 
-以下のコマンド一発で、Claude Code マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストールをまとめて行える。
+以下のコマンド一発で、Claude Code マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストール・CodeGraph CLI のインストールをまとめて行える。
 
 ```bash
 npx claude-task-worker install
@@ -131,6 +194,7 @@ npx claude-task-worker install
 - `claude plugin marketplace add getty104/claude-task-worker` — マーケットプレイスの追加（追加済みの場合のエラーはログのみで無視して続行）
 - `claude plugin install claude-task-worker@claude-task-worker` — プラグインのインストール
 - `npm install -g claude-task-worker@latest` — CLI 本体のグローバルインストール（`npx` 実行時でも `claude-task-worker` コマンドを常設化する）
+- `npm install -g @colbymchenry/codegraph@latest` — CodeGraph CLI のインストール（MCP サーバーの登録はプラグインの `.mcp.json` が担うため、`codegraph install` は実行しない）
 
 インストール後、Claude Code のセッションを再起動するとプラグインが有効化される。
 
@@ -173,7 +237,7 @@ brew install herdr
 
 #### 更新
 
-CLI とプラグイン（マーケットプレイス）をまとめて更新する。
+CLI・プラグイン（マーケットプレイス）・CodeGraph CLI をまとめて更新する。
 
 ```bash
 claude-task-worker update
@@ -182,10 +246,11 @@ claude-task-worker update
 - `claude plugin marketplace update claude-task-worker` — マーケットプレイスの更新
 - `claude plugin update claude-task-worker@claude-task-worker` — プラグインの更新（反映にはセッション再起動が必要）
 - `npm install -g claude-task-worker@latest` — CLI 本体の更新
+- `codegraph upgrade` — CodeGraph CLI の更新（未インストール環境ではコマンドが無く失敗するため、`npm install -g @colbymchenry/codegraph@latest` へフォールバックする）
 
 ### 初期化
 
-対象リポジトリで実行すると、必要なGitHubラベル・Issueテンプレート・GitHub Actionsワークフロー・設定ファイルが作成される。既存ファイルは保護され、`--force` を指定すると上書きされる。
+対象リポジトリで実行すると、必要なGitHubラベル・Issueテンプレート・GitHub Actionsワークフロー・設定ファイルが作成され、CodeGraph のセットアップが行われる。既存ファイルは保護され、`--force` を指定すると上書きされる。
 
 ```bash
 claude-task-worker init           # 既存ファイルは保護
@@ -208,12 +273,21 @@ claude-task-worker init --force   # 既存ファイルを強制上書き
 | `cc-pr-created` | PR作成完了マーク |
 | `cc-epic-issue` | エピックマーク（Issueではサブ全Closeで `epic-issue` ワーカー起動、PRではリリースゲート対象を示すマーク） |
 | `cc-release-ready` | エピックPRがリリース可能（マージ問題なし）と判定されたマーク。実際のマージ（リリース）は人間が実施 |
+| `cc-create-ui-design` | UIデザイン作成トリガー（`create-ui-design` ワーカー。`uiDesign.enabled` が `true` の場合のみ機能する） |
+| `cc-ui-design-pr-created` | デザインPR作成済み・マージ待ちマーク（`apply-ui-design` ワーカーのトリガー） |
+| `cc-ui-design-ready` | デザイン反映済みマーク（再デザイン抑止。デザイン不要と判定された場合も付与される） |
+| `cc-ui-design` | デザインPRのマーカー（PR。`triage-pr` のレビュー観点切り替えに使う） |
 
 作成されるファイル:
 
 - `.github/ISSUE_TEMPLATE/cc-triage-scope.yml` — `cc-triage-scope` ラベル付きIssue作成用テンプレート
 - `.github/workflows/assign-creator-on-cc-triage-scope.yml` — Issue作成者を自動アサインするワークフロー
-- `claude-task-worker.json` — 設定ファイル（コマンド実行ディレクトリ直下。全ワーカーのデフォルト設定が書き込まれた状態で作成される）
+- `claude-task-worker.json` — 設定ファイル（コマンド実行ディレクトリ直下。全ワーカーのデフォルト設定と `uiDesign`（既定は無効）が書き込まれた状態で作成される）
+
+CodeGraph のセットアップ:
+
+- グローバル gitignore（`$XDG_CONFIG_HOME/git/ignore`、未設定なら `~/.config/git/ignore`）へ `.codegraph/` を追記する（冪等）。`.codegraph/` はプロジェクトごとのローカルインデックスでコミット対象ではないが、対象リポジトリの `.gitignore` を汚さないためグローバル側に入れる
+- `codegraph init` でインデックスを構築する。CodeGraph が未インストールでも `init` 全体は失敗せず、ログにエラーを出して続行する
 
 ## コマンド
 
@@ -282,9 +356,11 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 
 ディスパッチャーは以下の3つの機能を持つ。
 
-- **一斉起動**: 対象プロジェクトごとに `ctw:<プロジェクト名>` ラベルのherdrワークスペースを作成し、そのプロジェクトのディレクトリで（`--project` を除いた）同じコマンドを非同期実行する
+- **一斉起動**: 対象プロジェクトごとに `ctw:<プロジェクト名>` ラベルのherdrワークスペースを作成し、そのプロジェクトのディレクトリで（`--project` を除いた）同じコマンドを実行する。ペインのシェル初期化が終わるのを待ってからコマンドを送り、送信後はワーカープロセスが実際に起動したかを確認する（シェルのままなら再送し、それでも起動しなければそのプロジェクトは失敗としてタブを閉じる）
 - **稼働一覧**: 各セッションのプロジェクト名・ワークスペースID・ペインID・ステータス・稼働時間をステータステーブルとして定期的に画面へ描画し、対象プロセスが終了したセッションは自動的に一覧から除去する
-- **一括停止**: SIGTERM/SIGINTを受けると、稼働中の全セッションへ ctrl-c を送信して各プロジェクトのコマンドを終了させ、終了を待ってからherdrワークスペースを閉じる（`mode: "herdr"` でワーカーが作ったタスクタブもワークスペースごと片付く）
+- **一括停止**: SIGTERM/SIGINTを受けると、稼働中の全セッションへ ctrl-c を送信して各プロジェクトのコマンドを終了させ、終了を待ってからherdrワークスペースを閉じる（`mode: "herdr"` でワーカーが作ったタスクタブもワークスペースごと片付く）。もう一度シグナルを送ると強制終了する
+
+> ℹ️ herdr はワークスペースを閉じる際、閉じた対象がフォーカスされていなくても別のワークスペースへフォーカスを移す。ディスパッチャーはクローズ直前のフォーカス状態を控えて閉じた後に復元するため、無関係なワークスペースを見ていても表示は勝手に切り替わらない。
 
 ```bash
 claude-task-worker all --project all
@@ -312,9 +388,9 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 
 `mode: "herdr"` のときの1タスクの流れ:
 
-1. worktree を作成し、`ctw:<プロジェクト名>:#<Issue/PR番号>` ラベルのタブで claude を TUI 起動する
-2. herdr が持つ agent ステータスを監視し、`working` → `idle` の遷移をタスク完了とみなす
-3. 完了したらペインの内容を回収して通知に使い、タブを閉じてラベル・worktree を後片付けする
+1. worktree を作成し、`ctw:<プロジェクト名>:#<Issue/PR番号>` ラベルのタブで claude を TUI 起動する（タブを先に作ってからその中で起動するため、ユーザーが見ているタブにペインが割り込むことはない）
+2. herdr が持つ agent ステータスを監視し、`done`（未確認完了）または `working` → `idle` の遷移をタスク完了とみなす。ワーカーのタスクタブは誰も開かないため、完了したタスクは通常 `done` として観測される
+3. 完了したら claude のセッション transcript（`~/.claude/projects/*/<sessionId>.jsonl`）から最終レポートを回収して通知に使い、タブを閉じてラベル・worktree を後片付けする。transcript を引けない場合のみペインの内容にフォールバックする
 
 補足:
 
@@ -347,12 +423,14 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 | `headroom` | 実行されるコマンド |
 |-----------|------------------|
 | `false`（既定） | `claude <引数>` |
-| `true` | `headroom wrap claude -- <引数>` |
+| `true` | `headroom wrap claude --1m --memory --no-tokensave --no-serena -- <引数>` |
 
 補足:
 
 - `mode` とは独立して組み合わせられる（`mode: "herdr"` の TUI 起動も `headroom wrap claude` になる）
-- claude へ渡す引数はすべて `--` の後ろに置かれる。`headroom wrap claude` 自身も `--port` / `--memory` などのオプションを持ち、`-p` のように衝突しうるフラグは `--` の後ろでないと claude に届かないため
+- claude へ渡す引数はすべて `--` の後ろに置かれる。`headroom wrap claude` 自身も `--port` / `--memory` などのオプションを持ち、`-p` のように衝突しうるフラグは `--` の後ろでないと claude に届かないため。逆に headroom 自身へのオプションは `--` の前に置く
+- 1M コンテキストウィンドウは `--model` の値へ `[1m]` サフィックスを付けることで解放する（`--model 'sonnet[1m]'` のようになる）。headroom の `--1m` は `ANTHROPIC_MODEL` をセットするだけの実装で、CLI の `--model` が環境変数に勝つため、`--model` を明示するワーカー起動では単体では効かない
+- `--no-tokensave` / `--no-serena` で headroom が既定で登録するコードグラフ系 MCP を止める。コード探索はプラグインの codegraph MCP が担うため機能面の損失はなく、タスク起動のたびに走る再登録・再インデックスと、ユーザーのグローバル設定（`~/.claude.json`）の書き換えを避けられる
 - `headroom: true` で headroom コマンドが PATH に無い場合、ワーカーは起動時にエラー終了する（`mode: "herdr"` と同じく、サイレントに直接起動へフォールバックはしない）
 - `headroom wrap claude` は claude を起動する前に起動バナー（枠線・`ANTHROPIC_BASE_URL=...` など）を stdout へ出力し、これを抑止するオプションは無い。ワーカーは空振りセッション検知（exit 0 かつ無出力を失敗とみなす判定）の前にこのバナーを取り除くため、検知は `headroom: true` でも従来どおり機能する。ただし Slack 通知の本文にはバナーがそのまま含まれる
 
@@ -430,9 +508,30 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 - 完了後、親Issueに `cc-pr-created` ラベルを付与
 - 完了後、作成されたエピックPR（`cc-epic-<親Issue番号>` ブランチ）に `cc-epic-issue` と `cc-triage-scope` ラベルを付与し、triage-pr のリリースゲート判定に引き継ぐ
 
+### create-ui-design
+
+`cc-create-ui-design` ラベルが付いたIssueを定期取得し、`/claude-task-worker:create-ui-design` を起動して Pencil デザイン（`.pen` + スナップショットPNG）を作成し、デザインのみのPRを作成する。（デフォルト1分間隔）
+
+- `claude-task-worker.json` の `uiDesign.enabled` が `true` の場合のみ起動する（`false` なら1行ログを出して即終了）
+- `cc-ui-design-pr-created` / `cc-ui-design-ready` が付いているIssueは除外
+- デザインPRは `cc-ui-design-<Issue番号>` の固定名ブランチを head とする（後段の `apply-ui-design` が一意に特定するため）
+- 完了後、デザインPRの実在を確認できた場合のみ、PRに `cc-ui-design` と `cc-triage-scope`、Issueに `cc-ui-design-pr-created` を付与する
+- スキルが「デザイン不要」と判定した場合（`cc-ui-design-ready` 付与済み）は完了扱いとし、そのまま実装フェーズへ流す
+- PRの実在を確認できない場合は `cc-need-human-check` を付与してIssueにコメントを残す
+
+### apply-ui-design
+
+`cc-ui-design-pr-created` ラベルが付いたIssueを定期取得し、デザインPRのマージ後に `/claude-task-worker:apply-ui-design` を起動して Issue description へデザイン参照セクション（`## UIデザイン`）を書き戻す。（デフォルト1分間隔）
+
+- `claude-task-worker.json` の `uiDesign.enabled` が `true` の場合のみ起動する
+- `cc-ui-design-ready` / `cc-exec-issue` が付いているIssueは除外
+- preflight でデザインPR（`cc-ui-design-<Issue番号>` を head とするPR）の状態を確認し、`OPEN` の間はスキップしてマージを待つ
+- 未マージのままクローズされた場合・PRが見つからない場合は `cc-need-human-check` を付与してスキップする
+- 完了後、description に `## UIデザイン` セクションと `.pen` パスが載っていることを検証できた場合のみ `cc-ui-design-ready` と `cc-exec-issue` を付与する
+
 ### all
 
-通常ワーカー7つ（exec-issue, fix-review-point, create-issue, update-issue, answer-issue-questions, resolve-conflict, epic-issue）を同時にポーリングする。`--epic` / `--label` オプションでIssue系ワーカーの処理対象を絞り込み可能（どちらも複数指定可）。
+通常ワーカー9つ（exec-issue, fix-review-point, create-issue, update-issue, answer-issue-questions, resolve-conflict, epic-issue, create-ui-design, apply-ui-design）を同時にポーリングする。`--epic` / `--label` オプションでIssue系ワーカーの処理対象を絞り込み可能（どちらも複数指定可）。UIデザイン系2ワーカーは `uiDesign.enabled` が `false` なら起動しない。
 
 ### yolo
 
@@ -444,7 +543,7 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 
 ### install
 
-`claude-task-worker` マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストールを一括で行う。
+`claude-task-worker` マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストール・CodeGraph CLI のインストールを一括で行う。
 
 ```bash
 npx claude-task-worker install
@@ -453,12 +552,13 @@ npx claude-task-worker install
 - `claude plugin marketplace add getty104/claude-task-worker` — マーケットプレイスの追加（追加済みの場合のエラーはログのみで無視して続行）
 - `claude plugin install claude-task-worker@claude-task-worker` — プラグインのインストール
 - `npm install -g claude-task-worker@latest` — CLI 本体のグローバルインストール
+- `npm install -g @colbymchenry/codegraph@latest` — CodeGraph CLI のインストール
 
-いずれかのステップが失敗しても処理は継続し、`[install]` プレフィックス付きでエラー内容がログ出力される。
+いずれかのステップが失敗しても処理は継続し、`[install]` プレフィックス付きでエラー内容がログ出力される（失敗があった場合の終了コードは 1）。
 
 ### update
 
-`claude-task-worker` プラグイン/マーケットプレイスとCLI本体を更新する。
+`claude-task-worker` プラグイン/マーケットプレイス・CLI本体・CodeGraph CLI を更新する。
 
 ```bash
 claude-task-worker update
@@ -467,8 +567,9 @@ claude-task-worker update
 - `claude plugin marketplace update claude-task-worker` — マーケットプレイスの更新
 - `claude plugin update claude-task-worker@claude-task-worker` — プラグインの更新（反映にはセッション再起動が必要）
 - `npm install -g claude-task-worker@latest` — CLI 本体の更新
+- `codegraph upgrade` — CodeGraph CLI の更新（失敗時は `npm install -g @colbymchenry/codegraph@latest` へフォールバック）
 
-いずれかのステップが失敗しても処理は継続し、`[update]` プレフィックス付きでエラー内容がログ出力される。
+いずれかのステップが失敗しても処理は継続し、`[update]` プレフィックス付きでエラー内容がログ出力される（失敗があった場合の終了コードは 1）。
 
 ### version
 
@@ -480,7 +581,7 @@ claude-task-worker --version
 claude-task-worker -v
 ```
 
-`package.json` の `version` を出力する（例: `0.6.0`）。
+`package.json` の `version` を出力する（例: `0.34.0`）。
 
 ## 設定ファイル
 
@@ -489,6 +590,7 @@ claude-task-worker -v
 | キー | 型 | デフォルト | 説明 |
 |---|---|---|---|
 | `fixReviewPointCallbackCommentMessage` | string | - | fix-review-point 完了時にPRへ投稿するコメント（未設定の場合は投稿しない） |
+| `uiDesign` | object | `{ "enabled": false, "designDir": "designs" }` | UIデザイン先行ワークフローの設定（詳細は「[UIデザイン先行ワークフロー](#uiデザイン先行ワークフロー)」） |
 | `workers` | object | `{}` | ワーカーごとに Claude CLI に渡すスキル、`--model` / `--effort`、ポーリング間隔、クールダウン時間、最大同時実行数を上書きする設定（詳細は下記） |
 
 ### ワーカーごとの設定
@@ -507,6 +609,8 @@ claude-task-worker -v
 | `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `high` | 60 | 0 | 1 |
 | `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `high` | 3600 | 0 | 1 |
 | `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `high` | 300 | 0 | 1 |
+| `create-ui-design` | `/claude-task-worker:create-ui-design` | `sonnet` | `high` | 60 | 0 | 1 |
+| `apply-ui-design` | `/claude-task-worker:apply-ui-design` | `sonnet` | `high` | 60 | 0 | 1 |
 
 各フィールドの値:
 
@@ -543,13 +647,27 @@ claude-task-worker all
 
 通知にはClaude APIの使用状況（5時間/7日間の利用率とリセット時刻）も含まれる。未設定の場合、通知は送信されない。
 
+使用状況を組み立てる際、[RunCat Neo](https://kyome.io/runcat/) 用のスナップショットを `~/.claude/runcat-usage.json`（`RUNCAT_OUT_FILE` で変更可）へ一時ファイル + rename で原子的に書き出す。Webhook 未設定でも通知が no-op になるだけでスナップショットは更新される。使用状況の取得自体は `/tmp/claude-usage-cache.json` の360秒キャッシュを挟むため、値は最大6分古くなりうる。
+
 ## プロセス管理
 
 実行中のタスクはリアルタイムのステータステーブルで表示される。
 
 - タスクID・タイトル・ステータス（running/completed/failed）・開始時刻・経過時間を表示
+- `mode: "herdr"` では実行中の行に agent ステータスが併記される（`running:working` / `running:blocked` など）
 - 同一Issue/PRの重複実行を自動防止
-- SIGTERM/SIGINTで全子プロセスをgraceful shutdown
+- SIGTERM/SIGINTで全子プロセスをgraceful shutdown（もう一度送ると強制終了し、ラベル・worktree の後片付けを試みる）
+- 前回の異常終了で残った worktree はワーカー起動時に自動回収される（実行中タスク・対話セッションが掴んでいる worktree は保護される）
+
+### タスク実行のガード
+
+ワーカーは応答するユーザーがいない状態でスキルを起動するため、処理が未完のままセッションが終了してラベルだけ進む事故を防ぐガードを持つ。
+
+- **バックグラウンド実行の無効化**: `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1` を全タスクの環境変数として注入し、Bash の `run_in_background` やサブエージェントの自動バックグラウンド化を止める
+- **ツールの無効化**: `--disallowedTools` で `Monitor` / `ScheduleWakeup` / `AskUserQuestion` / `EnterPlanMode` / `Cron*` / `RemoteTrigger` / `EnterWorktree` を無効化する（後続ウェイクアップ前提のもの、応答者が必要なもの、ワーカーの worktree 管理と競合するもの）
+- **自律実行原則の注入**: `--append-system-prompt` で「ユーザーに質問しない・全ステップを完遂してから終了する・曖昧なら安全側を選ぶ・サブエージェントの完了報告を検証する」および CodeGraph 優先のコード探索方針を注入する
+- **完了検証**: exec-issue / epic-issue は PR の実在（または Issue のクローズ）を確認できるまで `cc-pr-created` を付けず、確認できない場合は `cc-need-human-check` を付けて Issue にコメントを残す
+- **空振り検知**: 正常終了しても出力が空のセッションは失敗として分類し、失敗通知（stderr の末尾を含む）を送る
 
 ## 開発
 
@@ -557,6 +675,7 @@ claude-task-worker all
 npm install
 npm run build         # 型チェック（tsc --noEmit）+ esbuild で dist/index.js にバンドル
 npm run dev           # 型チェックの watch モード
+npm test              # ユニットテスト（node --experimental-strip-types --test）
 npm run lint          # ESLint
 npm run lint:fix      # ESLint（自動修正）
 npm run format        # Prettier で整形

package/dist/index.js

@@ -164,6 +164,69 @@ var init_task_result = __esm({
   }
 });
 
+// src/transcript.ts
+import { existsSync, readFileSync as readFileSync3, readdirSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join3 } from "node:path";
+function transcriptRoot() {
+  return join3(homedir2(), ".claude", "projects");
+}
+function findTranscriptPath(sessionId, root = transcriptRoot()) {
+  if (sessionId === "") return null;
+  let entries;
+  try {
+    entries = readdirSync(root);
+  } catch {
+    return null;
+  }
+  for (const entry of entries) {
+    const candidate = join3(root, entry, `${sessionId}.jsonl`);
+    if (existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+function textOf(entry) {
+  const content = entry.message?.content;
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.filter(
+    (block) => typeof block === "object" && block !== null && block.type === "text" && typeof block.text === "string"
+  ).map((block) => block.text).join("\n").trim();
+}
+function extractFinalAssistantText(jsonl) {
+  const lines = jsonl.split("\n");
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i].trim();
+    if (line === "") continue;
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (entry.type !== "assistant" || entry.isSidechain === true) continue;
+    const text = textOf(entry);
+    if (text !== "") return text;
+  }
+  return "";
+}
+function readFinalReport(sessionId, root = transcriptRoot()) {
+  if (!sessionId) return "";
+  const path = findTranscriptPath(sessionId, root);
+  if (!path) return "";
+  try {
+    return extractFinalAssistantText(readFileSync3(path, "utf-8"));
+  } catch (err) {
+    console.error(`[transcript] failed to read ${path}: ${err}`);
+    return "";
+  }
+}
+var init_transcript = __esm({
+  "src/transcript.ts"() {
+    "use strict";
+  }
+});
+
 // src/herdr.ts
 var herdr_exports = {};
 __export(herdr_exports, {
@@ -171,15 +234,16 @@ __export(herdr_exports, {
   HerdrError: () => HerdrError,
   HerdrUnavailableError: () => HerdrUnavailableError,
   agentGet: () => agentGet,
-  agentStart: () => agentStart,
   checkHerdrAvailable: () => checkHerdrAvailable,
   getCurrentWorkspaceId: () => getCurrentWorkspaceId,
+  launchAgentInPane: () => launchAgentInPane,
   paneClose: () => paneClose,
   paneGet: () => paneGet,
   paneProcessInfo: () => paneProcessInfo,
   paneRead: () => paneRead,
   paneSendKeys: () => paneSendKeys,
   paneSendText: () => paneSendText,
+  shellQuoteArgv: () => shellQuoteArgv,
   tabClose: () => tabClose,
   tabCreate: () => tabCreate,
   tabList: () => tabList,
@@ -332,32 +396,12 @@ async function workspaceClose(workspaceId) {
 async function workspaceFocus(workspaceId) {
   await execHerdr(["workspace", "focus", workspaceId]);
 }
-async function agentStart({
-  name,
-  cwd,
-  argv,
-  workspaceId,
-  tabId: targetTabId,
-  env
-}) {
-  const result = await execHerdr([
-    "agent",
-    "start",
-    name,
-    ...workspaceId ? ["--workspace", workspaceId] : [],
-    ...targetTabId ? ["--tab", targetTabId] : [],
-    ...cwdArgs(cwd),
-    ...envArgs(env),
-    "--no-focus",
-    "--",
-    ...argv
-  ]);
-  const paneId = result?.agent?.pane_id;
-  const tabId = result?.agent?.tab_id;
-  if (!paneId || !tabId) {
-    throw new Error("Failed to start agent: invalid response structure from herdr");
-  }
-  return { paneId, tabId };
+function shellQuoteArgv(argv) {
+  return argv.map((arg) => `'${arg.replace(/'/g, `'\\''`)}'`).join(" ");
+}
+async function launchAgentInPane(paneId, argv) {
+  await paneSendText(paneId, shellQuoteArgv(argv));
+  await paneSendKeys(paneId, "enter");
 }
 function toAgentStatus(value) {
   return value === "working" || value === "idle" || value === "blocked" || value === "done" ? value : "unknown";
@@ -368,11 +412,14 @@ async function agentGet(target) {
   if (!agent?.pane_id) {
     throw new Error(`Failed to get agent info for ${target}: invalid response structure from herdr`);
   }
+  const session = agent.agent_session;
+  const sessionId = session?.kind === "id" && typeof session.value === "string" ? session.value : void 0;
   return {
     paneId: agent.pane_id,
     tabId: agent.tab_id ?? "",
     workspaceId: agent.workspace_id ?? "",
-    agentStatus: toAgentStatus(agent.agent_status)
+    agentStatus: toAgentStatus(agent.agent_status),
+    sessionId
   };
 }
 function getCurrentWorkspaceId() {
@@ -485,10 +532,14 @@ var init_herdr = __esm({
 // src/herdr-runner.ts
 var herdr_runner_exports = {};
 __export(herdr_runner_exports, {
+  AGENT_DETECT_POLL_INTERVAL_MS: () => AGENT_DETECT_POLL_INTERVAL_MS,
+  AGENT_DETECT_TIMEOUT_MS: () => AGENT_DETECT_TIMEOUT_MS,
   AGENT_POLL_INTERVAL_MS: () => AGENT_POLL_INTERVAL_MS,
   CLAUDE_EXIT_POLL_INTERVAL_MS: () => CLAUDE_EXIT_POLL_INTERVAL_MS,
   CLAUDE_EXIT_TIMEOUT_MS: () => CLAUDE_EXIT_TIMEOUT_MS,
   PANE_OUTPUT_LINES: () => PANE_OUTPUT_LINES,
+  PANE_READY_POLL_INTERVAL_MS: () => PANE_READY_POLL_INTERVAL_MS,
+  PANE_READY_TIMEOUT_MS: () => PANE_READY_TIMEOUT_MS,
   buildHerdrTaskResult: () => buildHerdrTaskResult,
   createCompletionTracker: () => createCompletionTracker,
   observeAgentStatus: () => observeAgentStatus,
@@ -523,6 +574,10 @@ function observeAgentStatus(tracker, status) {
   return { tracker, decision: "running" };
 }
 function buildHerdrTaskResult(paneOutput, options) {
+  const report = options?.report?.trim() ?? "";
+  if (report !== "") {
+    return { status: "completed", output: report };
+  }
   const meaningful = options?.headroom ? stripHeadroomBanner(paneOutput) : paneOutput;
   if (meaningful.trim() === "") {
     return {
@@ -538,39 +593,89 @@ async function startHerdrTask({
   argv,
   env,
   workspaceId,
-  herdr
+  herdr,
+  timing
 }) {
   const mod = herdr ?? await loadHerdr();
-  const { tabId, paneId: shellPaneId } = await mod.tabCreate({ label, cwd, workspaceId, env });
-  let paneId;
+  const { tabId, paneId } = await mod.tabCreate({ label, cwd, workspaceId, env });
   try {
-    ({ paneId } = await mod.agentStart({ name: label, cwd, argv, env, workspaceId, tabId }));
+    const ready = await waitForPaneReady(paneId, mod, {
+      timeoutMs: timing?.paneReadyTimeoutMs,
+      pollIntervalMs: timing?.paneReadyPollIntervalMs
+    });
+    if (!ready) {
+      console.warn(`[herdr-runner] pane ${paneId} produced no prompt before the timeout, launching anyway`);
+    }
+    await mod.launchAgentInPane(paneId, argv);
+    const detected = await waitForAgentDetected(paneId, mod, {
+      timeoutMs: timing?.agentDetectTimeoutMs,
+      pollIntervalMs: timing?.agentDetectPollIntervalMs
+    });
+    if (!detected) {
+      throw new Error(
+        `claude was not detected in pane ${paneId} after launch (it may have failed to start; e.g. a skill preamble command failed)`
+      );
+    }
   } catch (err) {
     await mod.tabClose(tabId).catch(() => {
     });
     throw err;
   }
-  await mod.paneClose(shellPaneId).catch((err) => {
-    console.error(`[herdr-runner] failed to close the placeholder shell pane ${shellPaneId}: ${err}`);
-  });
   return { paneId, tabId };
 }
+async function waitForPaneReady(paneId, mod, options) {
+  const timeoutMs = options?.timeoutMs ?? PANE_READY_TIMEOUT_MS;
+  const pollIntervalMs = options?.pollIntervalMs ?? PANE_READY_POLL_INTERVAL_MS;
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    let content = "";
+    try {
+      content = await mod.paneRead(paneId, { source: "visible" });
+    } catch (err) {
+      console.error(`[herdr-runner] failed to read pane ${paneId} while waiting for its prompt: ${err}`);
+    }
+    if (content.trim() !== "") return true;
+    if (Date.now() >= deadline) return false;
+    await sleep(pollIntervalMs);
+  }
+}
+async function waitForAgentDetected(paneId, mod, options) {
+  const timeoutMs = options?.timeoutMs ?? AGENT_DETECT_TIMEOUT_MS;
+  const pollIntervalMs = options?.pollIntervalMs ?? AGENT_DETECT_POLL_INTERVAL_MS;
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    try {
+      await mod.agentGet(paneId);
+      return true;
+    } catch (err) {
+      if (err instanceof mod.HerdrError && err.code === "pane_not_found") return false;
+      if (!(err instanceof mod.HerdrError && err.code === "agent_not_found")) {
+        console.error(`[herdr-runner] unexpected error while waiting for agent detection on pane ${paneId}: ${err}`);
+      }
+    }
+    if (Date.now() >= deadline) return false;
+    await sleep(pollIntervalMs);
+  }
+}
 async function waitForHerdrTask(paneId, options) {
   const mod = options?.herdr ?? await loadHerdr();
   const pollIntervalMs = options?.pollIntervalMs ?? AGENT_POLL_INTERVAL_MS;
   let tracker = createCompletionTracker();
+  let sessionId;
   for (; ; ) {
     if (options?.signal?.aborted) {
       return { status: "failed", output: "[worker] the worker is shutting down; the task was interrupted" };
     }
     let status;
     try {
-      status = (await mod.agentGet(paneId)).agentStatus;
+      const agent = await mod.agentGet(paneId);
+      status = agent.agentStatus;
+      if (agent.sessionId) sessionId = agent.sessionId;
     } catch (err) {
-      if (err instanceof mod.HerdrError && err.code === "pane_not_found") {
+      if (err instanceof mod.HerdrError && (err.code === "pane_not_found" || err.code === "agent_not_found")) {
         return {
           status: "failed",
-          output: "[worker] the claude pane disappeared before the task completed (claude died or the tab was closed)"
+          output: "[worker] the claude agent disappeared before the task completed (claude died or the tab was closed)"
         };
       }
       console.error(`[herdr-runner] failed to read agent status for pane ${paneId}: ${err}`);
@@ -582,7 +687,8 @@ async function waitForHerdrTask(paneId, options) {
     tracker = observed.tracker;
     if (observed.decision === "completed") {
       const output = await readPaneOutput(paneId, mod);
-      return buildHerdrTaskResult(output, { headroom: options?.headroom });
+      const report = (options?.readReport ?? readFinalReport)(sessionId);
+      return buildHerdrTaskResult(output, { headroom: options?.headroom, report });
     }
     if (observed.decision === "blocked-first-seen") {
       options?.onBlocked?.();
@@ -598,15 +704,17 @@ async function readPaneOutput(paneId, mod) {
     return "";
   }
 }
-async function waitForPaneGone(paneId, mod, options) {
+async function waitForAgentGone(paneId, mod, options) {
   const timeoutMs = options?.timeoutMs ?? CLAUDE_EXIT_TIMEOUT_MS;
   const pollIntervalMs = options?.pollIntervalMs ?? CLAUDE_EXIT_POLL_INTERVAL_MS;
   const deadline = Date.now() + timeoutMs;
   for (; ; ) {
     try {
-      await mod.paneGet(paneId);
+      await mod.agentGet(paneId);
     } catch (err) {
-      if (err instanceof mod.HerdrError && err.code === "pane_not_found") return true;
+      if (err instanceof mod.HerdrError && (err.code === "agent_not_found" || err.code === "pane_not_found")) {
+        return true;
+      }
     }
     if (Date.now() >= deadline) return false;
     await sleep(pollIntervalMs);
@@ -616,7 +724,7 @@ async function stopHerdrTask(task, herdr, options) {
   const mod = herdr ?? await loadHerdr();
   try {
     await mod.paneSendKeys(task.paneId, "ctrl+c", "ctrl+c");
-    const exited = await waitForPaneGone(task.paneId, mod, {
+    const exited = await waitForAgentGone(task.paneId, mod, {
       timeoutMs: options?.exitTimeoutMs,
       pollIntervalMs: options?.exitPollIntervalMs
     });
@@ -638,13 +746,18 @@ async function stopHerdrTask(task, herdr, options) {
 function sleep(ms) {
   return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
-var AGENT_POLL_INTERVAL_MS, PANE_OUTPUT_LINES, CLAUDE_EXIT_TIMEOUT_MS, CLAUDE_EXIT_POLL_INTERVAL_MS;
+var AGENT_POLL_INTERVAL_MS, PANE_OUTPUT_LINES, PANE_READY_TIMEOUT_MS, PANE_READY_POLL_INTERVAL_MS, AGENT_DETECT_TIMEOUT_MS, AGENT_DETECT_POLL_INTERVAL_MS, CLAUDE_EXIT_TIMEOUT_MS, CLAUDE_EXIT_POLL_INTERVAL_MS;
 var init_herdr_runner = __esm({
   "src/herdr-runner.ts"() {
     "use strict";
     init_task_result();
+    init_transcript();
     AGENT_POLL_INTERVAL_MS = 3 * 1e3;
     PANE_OUTPUT_LINES = 300;
+    PANE_READY_TIMEOUT_MS = 30 * 1e3;
+    PANE_READY_POLL_INTERVAL_MS = 200;
+    AGENT_DETECT_TIMEOUT_MS = 120 * 1e3;
+    AGENT_DETECT_POLL_INTERVAL_MS = 500;
     CLAUDE_EXIT_TIMEOUT_MS = 15 * 1e3;
     CLAUDE_EXIT_POLL_INTERVAL_MS = 200;
   }
@@ -697,8 +810,8 @@ var init_run_command = __esm({
 var dispatcher_exports = {};
 __export(dispatcher_exports, {
   LABEL_PREFIX: () => LABEL_PREFIX,
-  PANE_READY_POLL_INTERVAL_MS: () => PANE_READY_POLL_INTERVAL_MS,
-  PANE_READY_TIMEOUT_MS: () => PANE_READY_TIMEOUT_MS,
+  PANE_READY_POLL_INTERVAL_MS: () => PANE_READY_POLL_INTERVAL_MS2,
+  PANE_READY_TIMEOUT_MS: () => PANE_READY_TIMEOUT_MS2,
   POLL_INTERVAL_MS: () => POLL_INTERVAL_MS,
   SEND_MAX_ATTEMPTS: () => SEND_MAX_ATTEMPTS,
   SHUTDOWN_RETRY_TIMEOUT_MS: () => SHUTDOWN_RETRY_TIMEOUT_MS,
@@ -718,7 +831,7 @@ __export(dispatcher_exports, {
   runDispatcher: () => runDispatcher,
   shutdownDispatcher: () => shutdownDispatcher,
   startWorkerInPane: () => startWorkerInPane,
-  waitForPaneReady: () => waitForPaneReady,
+  waitForPaneReady: () => waitForPaneReady2,
   waitForWorkerStartup: () => waitForWorkerStartup,
   workspaceLabelFor: () => workspaceLabelFor
 });
@@ -759,9 +872,9 @@ function isWorkerProcess(process2) {
 function isShellProcess(process2) {
   return SHELL_NAME_PATTERN.test(process2.name ?? "") || SHELL_NAME_PATTERN.test(process2.cmdline ?? "");
 }
-async function waitForPaneReady(paneId, herdr, options) {
-  const timeoutMs = options?.timeoutMs ?? PANE_READY_TIMEOUT_MS;
-  const pollIntervalMs = options?.pollIntervalMs ?? PANE_READY_POLL_INTERVAL_MS;
+async function waitForPaneReady2(paneId, herdr, options) {
+  const timeoutMs = options?.timeoutMs ?? PANE_READY_TIMEOUT_MS2;
+  const pollIntervalMs = options?.pollIntervalMs ?? PANE_READY_POLL_INTERVAL_MS2;
   const deadline = Date.now() + timeoutMs;
   for (; ; ) {
     const content = await herdr.paneRead(paneId, { source: "visible" });
@@ -785,7 +898,7 @@ async function waitForWorkerStartup(paneId, herdr, options) {
 async function startWorkerInPane(paneId, forwardedCommand, herdr, options) {
   const maxAttempts = options?.sendMaxAttempts ?? SEND_MAX_ATTEMPTS;
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    const ready = await waitForPaneReady(paneId, herdr, {
+    const ready = await waitForPaneReady2(paneId, herdr, {
       timeoutMs: options?.paneReadyTimeoutMs,
       pollIntervalMs: options?.paneReadyPollIntervalMs
     });
@@ -1087,15 +1200,15 @@ function createDispatcherShutdownHandler(shutdown2) {
   };
   return { handle, isShuttingDown: () => shuttingDown2 };
 }
-var getDisplayWidth2, truncateToWidth2, padToWidth2, POLL_INTERVAL_MS, SHUTDOWN_TIMEOUT_MS, PANE_READY_TIMEOUT_MS, PANE_READY_POLL_INTERVAL_MS, WORKER_STARTUP_TIMEOUT_MS, WORKER_STARTUP_POLL_INTERVAL_MS, SEND_MAX_ATTEMPTS, LABEL_PREFIX, SHELL_NAME_PATTERN, SHUTDOWN_RETRY_TIMEOUT_MS, CTRL_C_KEY, shutdownPromise;
+var getDisplayWidth2, truncateToWidth2, padToWidth2, POLL_INTERVAL_MS, SHUTDOWN_TIMEOUT_MS, PANE_READY_TIMEOUT_MS2, PANE_READY_POLL_INTERVAL_MS2, WORKER_STARTUP_TIMEOUT_MS, WORKER_STARTUP_POLL_INTERVAL_MS, SEND_MAX_ATTEMPTS, LABEL_PREFIX, SHELL_NAME_PATTERN, SHUTDOWN_RETRY_TIMEOUT_MS, CTRL_C_KEY, shutdownPromise;
 var init_dispatcher = __esm({
   async "src/dispatcher.ts"() {
     "use strict";
     ({ getDisplayWidth: getDisplayWidth2, truncateToWidth: truncateToWidth2, padToWidth: padToWidth2 } = await loadTable());
     POLL_INTERVAL_MS = 7 * 1e3;
     SHUTDOWN_TIMEOUT_MS = 10 * 60 * 1e3;
-    PANE_READY_TIMEOUT_MS = 30 * 1e3;
-    PANE_READY_POLL_INTERVAL_MS = 200;
+    PANE_READY_TIMEOUT_MS2 = 30 * 1e3;
+    PANE_READY_POLL_INTERVAL_MS2 = 200;
     WORKER_STARTUP_TIMEOUT_MS = 30 * 1e3;
     WORKER_STARTUP_POLL_INTERVAL_MS = 500;
     SEND_MAX_ATTEMPTS = 3;
@@ -1216,6 +1329,28 @@ async function findPrNumberByHeadRef(headRefName, state = "open") {
   const prs = JSON.parse(output);
   return prs.length > 0 ? prs[0].number : null;
 }
+async function findPrStateByHeadRef(headRefName) {
+  const output = await execGh([
+    "pr",
+    "list",
+    "--state",
+    "all",
+    "--head",
+    headRefName,
+    "--json",
+    "number,state,mergedAt",
+    "--limit",
+    "1"
+  ]);
+  const prs = JSON.parse(output);
+  if (prs.length === 0) return null;
+  return { number: prs[0].number, state: prs[0].state, mergedAt: prs[0].mergedAt ?? null };
+}
+async function getIssueBody(issueNumber) {
+  const output = await execGh(["issue", "view", String(issueNumber), "--json", "body"]);
+  const parsed = JSON.parse(output);
+  return typeof parsed?.body === "string" ? parsed.body : "";
+}
 async function getIssueState(issueNumber) {
   const output = await execGh(["issue", "view", String(issueNumber), "--json", "state"]);
   const parsed = JSON.parse(output);
@@ -1456,7 +1591,11 @@ function buildClaudeEnv(mode) {
 
 // src/config.ts
 import { readFileSync } from "node:fs";
-import { join } from "node:path";
+import { isAbsolute, join, normalize, sep as SEP } from "node:path";
+var DEFAULT_UI_DESIGN_CONFIG = {
+  enabled: false,
+  designDir: "designs"
+};
 var DEFAULT_WORKER_CONFIG = {
   skill: "",
   model: "sonnet",
@@ -1545,10 +1684,27 @@ var WORKER_DEFAULTS = {
     pollingIntervalSeconds: 300,
     cooldownSeconds: 0,
     maxConcurrentTasks: 1
+  },
+  "create-ui-design": {
+    skill: "/claude-task-worker:create-ui-design",
+    model: "sonnet",
+    effort: "high",
+    pollingIntervalSeconds: 60,
+    cooldownSeconds: 0,
+    maxConcurrentTasks: 1
+  },
+  "apply-ui-design": {
+    skill: "/claude-task-worker:apply-ui-design",
+    model: "sonnet",
+    effort: "high",
+    pollingIntervalSeconds: 300,
+    cooldownSeconds: 0,
+    maxConcurrentTasks: 1
   }
 };
 var DEFAULT_CONFIG = {
   fixReviewPointCallbackCommentMessage: "",
+  uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG },
   workers: {}
 };
 var CONFIG_PATH = join(process.cwd(), "claude-task-worker.json");
@@ -1616,6 +1772,35 @@ function parseWorkerEntry(name, val) {
   }
   return result;
 }
+function parseUiDesignEntry(val) {
+  const result = { ...DEFAULT_UI_DESIGN_CONFIG };
+  if (typeof val !== "object" || val === null || Array.isArray(val)) {
+    console.warn(`[config] invalid uiDesign: expected object, using defaults`);
+    return result;
+  }
+  const entry = val;
+  if ("enabled" in entry) {
+    if (typeof entry.enabled === "boolean") {
+      result.enabled = entry.enabled;
+    } else {
+      console.warn(
+        `[config] invalid uiDesign.enabled: ${String(entry.enabled)}, using default ${DEFAULT_UI_DESIGN_CONFIG.enabled}`
+      );
+    }
+  }
+  if ("designDir" in entry) {
+    const normalized = typeof entry.designDir === "string" && entry.designDir.length > 0 ? normalize(entry.designDir) : null;
+    const isContained = normalized !== null && !isAbsolute(normalized) && normalized !== ".." && !normalized.startsWith(`..${SEP}`);
+    if (isContained) {
+      result.designDir = normalized;
+    } else {
+      console.warn(
+        `[config] invalid uiDesign.designDir: ${String(entry.designDir)}, using default ${DEFAULT_UI_DESIGN_CONFIG.designDir}`
+      );
+    }
+  }
+  return result;
+}
 function loadConfig() {
   const configPath = CONFIG_PATH;
   let raw;
@@ -1623,17 +1808,20 @@ function loadConfig() {
     raw = JSON.parse(readFileSync(configPath, "utf-8"));
   } catch (err) {
     if (err.code === "ENOENT") {
-      return { ...DEFAULT_CONFIG, workers: {} };
+      return { ...DEFAULT_CONFIG, uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG }, workers: {} };
     }
     throw err;
   }
-  const result = { ...DEFAULT_CONFIG, workers: {} };
+  const result = { ...DEFAULT_CONFIG, uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG }, workers: {} };
   if ("fixReviewPointCallbackCommentMessage" in raw) {
     const val = raw["fixReviewPointCallbackCommentMessage"];
     if (typeof val === "string") {
       result.fixReviewPointCallbackCommentMessage = val;
     }
   }
+  if ("uiDesign" in raw) {
+    result.uiDesign = parseUiDesignEntry(raw["uiDesign"]);
+  }
   if ("workers" in raw) {
     const workers = raw["workers"];
     if (typeof workers !== "object" || workers === null || Array.isArray(workers)) {
@@ -1651,6 +1839,14 @@ function getWorkerConfig(workerName) {
   const config = loadConfig();
   return config.workers[workerName] ?? { ...defaultsFor(workerName) };
 }
+function getUiDesignConfig() {
+  try {
+    return loadConfig().uiDesign;
+  } catch (err) {
+    console.warn(`[config] failed to load uiDesign config, using defaults: ${err}`);
+    return { ...DEFAULT_UI_DESIGN_CONFIG };
+  }
+}
 
 // src/git.ts
 import { execSync, execFile } from "node:child_process";
@@ -1704,7 +1900,7 @@ init_task_result();
 // src/user-config.ts
 import { readFileSync as readFileSync2, statSync } from "node:fs";
 import { homedir } from "node:os";
-import { isAbsolute, join as join2, resolve } from "node:path";
+import { isAbsolute as isAbsolute2, join as join2, resolve } from "node:path";
 var RESERVED_ALL = "all";
 var DEFAULT_RUN_MODE = "default";
 var DEFAULT_HEADROOM = false;
@@ -1801,7 +1997,7 @@ function loadUserConfig() {
     if (name === "__proto__") {
       throw new UserConfigError(`"__proto__" cannot be used as a key in "projects": ${path}`);
     }
-    if (typeof value !== "string" || !isAbsolute(value)) {
+    if (typeof value !== "string" || !isAbsolute2(value)) {
       console.warn(`[config] invalid projects.${name}: expected an absolute path, skipping`);
       continue;
     }
@@ -2352,16 +2548,16 @@ function isGeneratedWorktreeName(name) {
 
 // src/slack.ts
 import { exec } from "node:child_process";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { join as join5 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 
 // src/runcat.ts
 import { mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { dirname, join as join3 } from "node:path";
-var RUNCAT_OUT_FILE = process.env.RUNCAT_OUT_FILE ?? join3(process.env.HOME ?? homedir2(), ".claude", "runcat-usage.json");
+import { homedir as homedir3 } from "node:os";
+import { dirname, join as join4 } from "node:path";
+var RUNCAT_OUT_FILE = process.env.RUNCAT_OUT_FILE ?? join4(process.env.HOME ?? homedir3(), ".claude", "runcat-usage.json");
 var JST = "Asia/Tokyo";
 function formatG(value) {
   return String(Number(value.toPrecision(6)));
@@ -2425,7 +2621,7 @@ function buildRuncatSnapshot(usage, now = /* @__PURE__ */ new Date()) {
 function writeRuncatUsage(usage, outFile = RUNCAT_OUT_FILE) {
   const snapshot = buildRuncatSnapshot(usage);
   const dir = dirname(outFile);
-  const tmp = join3(dir, `.runcat-${process.pid}-${Date.now()}.json`);
+  const tmp = join4(dir, `.runcat-${process.pid}-${Date.now()}.json`);
   try {
     mkdirSync(dir, { recursive: true });
     writeFileSync(tmp, JSON.stringify(snapshot), "utf-8");
@@ -2462,13 +2658,13 @@ async function getOAuthToken() {
     const { stdout } = await execAsync('security find-generic-password -s "Claude Code-credentials" -w');
     return extractToken(JSON.parse(stdout.trim()));
   } catch {
-    const raw = readFileSync3(join4(homedir3(), ".claude", ".credentials.json"), "utf-8");
+    const raw = readFileSync4(join5(homedir4(), ".claude", ".credentials.json"), "utf-8");
     return extractToken(JSON.parse(raw));
   }
 }
 function readUsageCache() {
   try {
-    const raw = readFileSync3(USAGE_CACHE_PATH, "utf-8");
+    const raw = readFileSync4(USAGE_CACHE_PATH, "utf-8");
     const cached = JSON.parse(raw);
     if (Date.now() - cached.timestamp < USAGE_CACHE_TTL_SECONDS * 1e3) {
       return cached.data;
@@ -3156,22 +3352,247 @@ var epicIssueWorker = (opts = {}) => createIssuePollingWorker({
   }
 })();
 
+// src/workers/ui-design.ts
+var DESIGN_REFERENCE_HEADING = "## UI\u30C7\u30B6\u30A4\u30F3";
+function designBranchName(issueNumber) {
+  return `cc-ui-design-${issueNumber}`;
+}
+var DESIGN_REFERENCE_HEADING_LINE = /^## UIデザイン[ \t]*$/m;
+var DESIGN_FILE_LINE = /^-\s*デザインファイル:\s*`([^`]+)`/m;
+function extractDesignSection(body) {
+  const headingMatch = DESIGN_REFERENCE_HEADING_LINE.exec(body);
+  if (headingMatch === null) return null;
+  const rest = body.slice(headingMatch.index + headingMatch[0].length);
+  const nextHeadingMatch = /^## /m.exec(rest);
+  return nextHeadingMatch === null ? rest : rest.slice(0, nextHeadingMatch.index);
+}
+function extractDesignFilePath(body) {
+  const section = extractDesignSection(body);
+  if (section === null) return null;
+  const match = DESIGN_FILE_LINE.exec(section);
+  if (match === null) return null;
+  const path = match[1].trim();
+  if (path.length === 0 || path.includes("<") || path.includes(">") || !path.endsWith(".pen")) return null;
+  return path;
+}
+function classifyDesignPr(pr) {
+  if (pr === null) return "needs-human";
+  if (pr.state === "MERGED" || pr.mergedAt !== null) return "proceed";
+  if (pr.state === "OPEN") return "wait";
+  return "needs-human";
+}
+function designPrMissingComment(issueNumber) {
+  return [
+    "## \u30C7\u30B6\u30A4\u30F3PR\u3092\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\uFF08\u8981\u4EBA\u624B\u78BA\u8A8D\uFF09",
+    `apply-ui-design \u306F\u30C7\u30B6\u30A4\u30F3\u30D6\u30E9\u30F3\u30C1 \`${designBranchName(issueNumber)}\` \u3092 head \u3068\u3059\u308BPR\u3092\u5F85\u3063\u3066\u3044\u307E\u3059\u304C\u3001\u305D\u306EPR\u304C\u898B\u3064\u304B\u3089\u306A\u3044\u304B\u3001\u30DE\u30FC\u30B8\u3055\u308C\u305A\u30AF\u30ED\u30FC\u30BA\u3055\u308C\u3066\u3044\u307E\u3059\u3002`,
+    "",
+    "## \u72B6\u614B\u306E\u78BA\u8A8D",
+    `- \u30C7\u30B6\u30A4\u30F3PR\u304C\u5374\u4E0B\u3055\u308C\u305F\u5834\u5408: \u3053\u306EIssue\u3092\u30C7\u30B6\u30A4\u30F3\u306A\u3057\u3067\u9032\u3081\u308B\u304B\u3001\u30C7\u30B6\u30A4\u30F3\u3092\u3084\u308A\u76F4\u3059\u304B\u3092\u6C7A\u3081\u3066\u304F\u3060\u3055\u3044`,
+    `- \u30C7\u30B6\u30A4\u30F3PR\u304C\u305D\u3082\u305D\u3082\u4F5C\u3089\u308C\u3066\u3044\u306A\u3044\u5834\u5408: \u30EA\u30E2\u30FC\u30C8\u30D6\u30E9\u30F3\u30C1 \`${designBranchName(issueNumber)}\` \u306E\u6709\u7121\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044`,
+    "",
+    "## \u5BFE\u5FDC\u5F8C\u306E\u9032\u3081\u65B9",
+    "- \u30C7\u30B6\u30A4\u30F3\u3092\u3084\u308A\u76F4\u3059\u5834\u5408: `cc-need-human-check` / `cc-ui-design-pr-created` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-create-ui-design` \u30E9\u30D9\u30EB\u3092\u4ED8\u3051\u76F4\u3057\u3066\u304F\u3060\u3055\u3044",
+    "- \u30C7\u30B6\u30A4\u30F3\u306A\u3057\u3067\u5B9F\u88C5\u3078\u9032\u3081\u308B\u5834\u5408: `cc-need-human-check` / `cc-ui-design-pr-created` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-exec-issue` \u30E9\u30D9\u30EB\u306E\u307F\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044"
+  ].join("\n");
+}
+function designPrNotCreatedComment(issueNumber) {
+  return [
+    "## \u30C7\u30B6\u30A4\u30F3PR\u672A\u4F5C\u6210\u306E\u307E\u307E\u81EA\u52D5\u5B9F\u884C\u304C\u7D42\u4E86\u3057\u307E\u3057\u305F\uFF08\u8981\u4EBA\u624B\u78BA\u8A8D\uFF09",
+    `create-ui-design \u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u6B63\u5E38\u7D42\u4E86\uFF08exit 0\uFF09\u3057\u307E\u3057\u305F\u304C\u3001\u30C7\u30B6\u30A4\u30F3\u30D6\u30E9\u30F3\u30C1 \`${designBranchName(issueNumber)}\` \u3092 head \u3068\u3059\u308BPR\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3067\u3057\u305F\u3002PR\u4F5C\u6210\u524D\u306B\u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u7D42\u4E86\u3057\u305F\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002`,
+    "",
+    "## \u72B6\u614B\u306E\u78BA\u8A8D",
+    `- \u5909\u66F4\u304C push \u6E08\u307F\u306E\u5834\u5408\u306F\u30EA\u30E2\u30FC\u30C8\u30D6\u30E9\u30F3\u30C1 \`${designBranchName(issueNumber)}\` \u304C\u6B8B\u3063\u3066\u3044\u307E\u3059\u3002\u5185\u5BB9\u3092\u78BA\u8A8D\u3057\u3001\u5FC5\u8981\u306A\u3089\u624B\u52D5\u3067\u30C7\u30B6\u30A4\u30F3PR\u3092\u4F5C\u6210\u3057\u3066\u304F\u3060\u3055\u3044`,
+    "",
+    "## \u5BFE\u5FDC\u5F8C\u306E\u9032\u3081\u65B9",
+    "- \u81EA\u52D5\u5B9F\u884C\u3092\u3084\u308A\u76F4\u3059\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-create-ui-design` \u30E9\u30D9\u30EB\u3092\u4ED8\u3051\u76F4\u3057\u3066\u304F\u3060\u3055\u3044",
+    "- \u624B\u52D5\u3067\u30C7\u30B6\u30A4\u30F3PR\u3092\u4F5C\u6210\u3057\u305F\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-ui-design-pr-created` \u30E9\u30D9\u30EB\u3092\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044",
+    "- \u30C7\u30B6\u30A4\u30F3\u3092\u8AE6\u3081\u3066\u305D\u306E\u307E\u307E\u5B9F\u88C5\u3078\u9032\u3081\u308B\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-exec-issue` \u30E9\u30D9\u30EB\u306E\u307F\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044"
+  ].join("\n");
+}
+function designReferenceMissingComment(issueNumber) {
+  return [
+    "## \u30C7\u30B6\u30A4\u30F3\u53C2\u7167\u306E\u66F8\u304D\u623B\u3057\u3092\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\uFF08\u8981\u4EBA\u624B\u78BA\u8A8D\uFF09",
+    `apply-ui-design \u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u6B63\u5E38\u7D42\u4E86\uFF08exit 0\uFF09\u3057\u307E\u3057\u305F\u304C\u3001Issue #${issueNumber} \u306E description \u306B \`${DESIGN_REFERENCE_HEADING}\` \u30BB\u30AF\u30B7\u30E7\u30F3\uFF08\`.pen\` \u306E\u30D1\u30B9\u3092\u542B\u3080\uFF09\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3067\u3057\u305F\u3002`,
+    "",
+    "## \u306A\u305C\u6B62\u3081\u3066\u3044\u308B\u304B",
+    "- \u30C7\u30B6\u30A4\u30F3\u53C2\u7167\u304C description \u306B\u7121\u3044\u3068\u3001`exec-issue` \u306F\u30C7\u30B6\u30A4\u30F3\u3092\u5165\u529B\u306B\u3067\u304D\u305A\u3001\u5408\u610F\u6E08\u307F\u306E\u30C7\u30B6\u30A4\u30F3\u3068\u7121\u95A2\u4FC2\u306A\u5B9F\u88C5\u306B\u306A\u308A\u307E\u3059",
+    "",
+    "## \u5BFE\u5FDC\u5F8C\u306E\u9032\u3081\u65B9",
+    "- \u81EA\u52D5\u5B9F\u884C\u3092\u3084\u308A\u76F4\u3059\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-ui-design-pr-created` \u30E9\u30D9\u30EB\u3092\u4ED8\u3051\u76F4\u3057\u3066\u304F\u3060\u3055\u3044",
+    "- \u624B\u52D5\u3067 description \u306B\u53C2\u7167\u3092\u8FFD\u8A18\u3057\u305F\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-ui-design-ready` \u3068 `cc-exec-issue` \u30E9\u30D9\u30EB\u3092\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044"
+  ].join("\n");
+}
+
+// src/workers/create-ui-design.ts
+function designPrLabelingFailedComment(issueNumber, prNumber, error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return [
+    "## \u30C7\u30B6\u30A4\u30F3PR\u3078\u306E\u30E9\u30D9\u30EB\u4ED8\u4E0E\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF08\u8981\u4EBA\u624B\u78BA\u8A8D\uFF09",
+    `\u30C7\u30B6\u30A4\u30F3PR #${prNumber}\uFF08\u30D6\u30E9\u30F3\u30C1 \`${designBranchName(issueNumber)}\`\uFF09\u306F\u4F5C\u6210\u3055\u308C\u307E\u3057\u305F\u304C\u3001\u5F8C\u7D9A\u30E9\u30D9\u30EB\uFF08\`cc-ui-design\` / \`cc-triage-scope\` / \`cc-ui-design-pr-created\`\uFF09\u306E\u4ED8\u4E0E\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002`,
+    "",
+    "## \u8D77\u3053\u308A\u3046\u308B\u539F\u56E0",
+    "- \u672C\u30EF\u30FC\u30AF\u30D5\u30ED\u30FC\u8FFD\u52A0\u6642\u306E\u30E9\u30D9\u30EB\u304C\u672A\u4F5C\u6210\u306E\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002`claude-task-worker init` \u3092\u518D\u5B9F\u884C\u3057\u3066\u30E9\u30D9\u30EB\u3092\u4F5C\u6210\u3057\u3066\u304F\u3060\u3055\u3044",
+    "",
+    "## \u30A8\u30E9\u30FC\u5185\u5BB9",
+    "```",
+    message,
+    "```",
+    "",
+    "## \u5BFE\u5FDC\u5F8C\u306E\u9032\u3081\u65B9",
+    "- \u30E9\u30D9\u30EB\u4F5C\u6210\u5F8C\u306B\u3084\u308A\u76F4\u3059\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3001`cc-ui-design`\u30FB`cc-triage-scope`\uFF08PR\u5074\uFF09\u3068 `cc-ui-design-pr-created`\uFF08Issue\u5074\uFF09\u3092\u624B\u52D5\u3067\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044"
+  ].join("\n");
+}
+var createUiDesignWorker = async (opts = {}) => {
+  if (!getUiDesignConfig().enabled) {
+    console.log("[create-ui-design] uiDesign.enabled is false, skipping");
+    return;
+  }
+  await createIssuePollingWorker({
+    name: "create-ui-design",
+    command: "/claude-task-worker:create-ui-design",
+    triggerLabels: ["cc-create-ui-design"],
+    excludeLabels: ["cc-ui-design-pr-created", "cc-ui-design-ready", "cc-exec-issue", "cc-pr-created"],
+    epicFilters: opts.epicFilters,
+    labelFilters: opts.labelFilters,
+    onCompleted: async (issueNumber) => {
+      if (await hasLabel("issue", issueNumber, "cc-need-human-check")) {
+        console.log(`[create-ui-design] #${issueNumber}: cc-need-human-check present, skip cc-ui-design-pr-created`);
+        return false;
+      }
+      if (await hasLabel("issue", issueNumber, "cc-ui-design-ready")) {
+        console.log(`[create-ui-design] #${issueNumber}: design not needed (cc-ui-design-ready), completing`);
+        return;
+      }
+      const branch = designBranchName(issueNumber);
+      const prNumber = await findPrNumberByHeadRef(branch, "open");
+      if (prNumber === null) {
+        console.error(
+          `[create-ui-design] #${issueNumber}: session exited without an open design PR (branch: ${branch}); marking cc-need-human-check`
+        );
+        await addLabel("issue", issueNumber, "cc-need-human-check");
+        await commentOnIssue(issueNumber, designPrNotCreatedComment(issueNumber)).catch(
+          (err) => console.error(`[create-ui-design] commentOnIssue failed for #${issueNumber}: ${err}`)
+        );
+        return false;
+      }
+      try {
+        await addLabel("pr", prNumber, "cc-ui-design");
+        await addLabel("pr", prNumber, "cc-triage-scope");
+        await addLabel("issue", issueNumber, "cc-ui-design-pr-created");
+      } catch (err) {
+        console.error(`[create-ui-design] #${issueNumber}: labeling design PR #${prNumber} failed: ${err}`);
+        await addLabel("issue", issueNumber, "cc-need-human-check");
+        await commentOnIssue(issueNumber, designPrLabelingFailedComment(issueNumber, prNumber, err)).catch(
+          (commentErr) => console.error(`[create-ui-design] commentOnIssue failed for #${issueNumber}: ${commentErr}`)
+        );
+        return false;
+      }
+    }
+  })();
+};
+
+// src/workers/apply-ui-design.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { join as join6 } from "node:path";
+function designFileExistsInWorktree(worktreeId, designFilePath) {
+  return existsSync2(join6(getWorktreePath(worktreeId), designFilePath));
+}
+async function markDesignReferenceMissing(issueNumber, logMessage) {
+  console.error(logMessage);
+  await addLabel("issue", issueNumber, "cc-need-human-check").catch(
+    (err) => console.error(`[apply-ui-design] addLabel cc-need-human-check failed for #${issueNumber}: ${err}`)
+  );
+  await commentOnIssue(issueNumber, designReferenceMissingComment(issueNumber)).catch(
+    (err) => console.error(`[apply-ui-design] commentOnIssue failed for #${issueNumber}: ${err}`)
+  );
+}
+var applyUiDesignWorker = async (opts = {}) => {
+  if (!getUiDesignConfig().enabled) {
+    console.log("[apply-ui-design] uiDesign.enabled is false, skipping");
+    return;
+  }
+  await createIssuePollingWorker({
+    name: "apply-ui-design",
+    command: "/claude-task-worker:apply-ui-design",
+    triggerLabels: ["cc-ui-design-pr-created"],
+    excludeLabels: ["cc-ui-design-ready", "cc-exec-issue"],
+    epicFilters: opts.epicFilters,
+    labelFilters: opts.labelFilters,
+    preflight: async (issue) => {
+      const branch = designBranchName(issue.number);
+      let pr;
+      try {
+        pr = await findPrStateByHeadRef(branch);
+      } catch (err) {
+        console.error(`[apply-ui-design] #${issue.number}: findPrStateByHeadRef failed for ${branch}: ${err}`);
+        return "skip";
+      }
+      const disposition = classifyDesignPr(pr);
+      if (disposition === "proceed") return "proceed";
+      if (disposition === "wait") {
+        console.log(`[apply-ui-design] #${issue.number}: design PR #${pr?.number} is still open, waiting for merge`);
+        return "skip";
+      }
+      console.error(`[apply-ui-design] #${issue.number}: design PR for ${branch} is missing or closed unmerged`);
+      try {
+        await addLabel("issue", issue.number, "cc-need-human-check");
+        await commentOnIssue(issue.number, designPrMissingComment(issue.number)).catch(
+          (err) => console.error(`[apply-ui-design] commentOnIssue failed for #${issue.number}: ${err}`)
+        );
+      } catch (err) {
+        console.error(`[apply-ui-design] addLabel cc-need-human-check failed for #${issue.number}: ${err}`);
+      }
+      return "skip";
+    },
+    onCompleted: async (issueNumber, worktreeId) => {
+      let body;
+      try {
+        body = await getIssueBody(issueNumber);
+      } catch (err) {
+        console.error(`[apply-ui-design] #${issueNumber}: getIssueBody failed: ${err}`);
+        body = "";
+      }
+      const designFilePath = extractDesignFilePath(body);
+      if (designFilePath === null) {
+        await markDesignReferenceMissing(
+          issueNumber,
+          `[apply-ui-design] #${issueNumber}: session exited without a design reference section; marking cc-need-human-check`
+        );
+        return false;
+      }
+      if (!designFileExistsInWorktree(worktreeId, designFilePath)) {
+        await markDesignReferenceMissing(
+          issueNumber,
+          `[apply-ui-design] #${issueNumber}: design reference points to ${designFilePath}, which does not exist in worktree ${worktreeId}; marking cc-need-human-check`
+        );
+        return false;
+      }
+      await addLabel("issue", issueNumber, "cc-exec-issue").catch(
+        (err) => console.error(`[apply-ui-design] addLabel cc-exec-issue failed for #${issueNumber}: ${err}`)
+      );
+      await addLabel("issue", issueNumber, "cc-ui-design-ready").catch(
+        (err) => console.error(`[apply-ui-design] addLabel cc-ui-design-ready failed for #${issueNumber}: ${err}`)
+      );
+    }
+  })();
+};
+
 // src/commands/init.ts
 import { mkdir as mkdir2, writeFile as writeFile2, access } from "node:fs/promises";
 
 // src/commands/codegraph.ts
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir as homedir4 } from "node:os";
-import { dirname as dirname2, join as join5 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { dirname as dirname2, join as join7 } from "node:path";
 async function loadRunCommand() {
   return await Promise.resolve().then(() => (init_run_command(), run_command_exports));
 }
 var CODEGRAPH_PACKAGE = "@colbymchenry/codegraph";
 var CODEGRAPH_IGNORE_ENTRY = ".codegraph/";
-function globalGitIgnorePath(env = process.env, home = homedir4()) {
+function globalGitIgnorePath(env = process.env, home = homedir5()) {
   const xdg = env.XDG_CONFIG_HOME?.trim();
-  const base = xdg ? xdg : join5(home, ".config");
-  return join5(base, "git", "ignore");
+  const base = xdg ? xdg : join7(home, ".config");
+  return join7(base, "git", "ignore");
 }
 function appendIgnoreEntry(current, entry) {
   const bare = entry.replace(/\/$/, "");
@@ -3258,7 +3679,11 @@ var LABELS = [
   { name: "cc-triage-scope", color: "c5def5" },
   { name: "cc-resolve-conflict", color: "fbca04" },
   { name: "cc-epic-issue", color: "8b5cf6" },
-  { name: "cc-release-ready", color: "2da44e" }
+  { name: "cc-release-ready", color: "2da44e" },
+  { name: "cc-create-ui-design", color: "ff8ad8" },
+  { name: "cc-ui-design-pr-created", color: "d4a5e8" },
+  { name: "cc-ui-design-ready", color: "bfd4f2" },
+  { name: "cc-ui-design", color: "ec4899" }
 ];
 var ISSUE_TEMPLATE = `name: "[claude-task-worker] Issue\u4F5C\u6210\u4F9D\u983C"
 description: claude-task-worker\u3067GitHub Issue\u3092\u4F5C\u6210\u3059\u308B
@@ -3445,14 +3870,14 @@ async function update() {
 }
 
 // src/commands/version.ts
-import { readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { readFileSync as readFileSync5 } from "node:fs";
+import { dirname as dirname3, join as join8 } from "node:path";
 import { fileURLToPath } from "node:url";
 function version() {
   const here = dirname3(fileURLToPath(import.meta.url));
-  const pkgPath = join6(here, "..", "package.json");
+  const pkgPath = join8(here, "..", "package.json");
   try {
-    const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
     console.log(pkg.version ?? "unknown");
   } catch (err) {
     console.error(`[version] Failed to read version: ${err.message}`);
@@ -3514,7 +3939,9 @@ var WORKERS = {
   "triage-pr": triagePrWorker,
   "resolve-conflict": resolveConflictWorker,
   "check-dependabot": checkDependabotWorker,
-  "epic-issue": epicIssueWorker
+  "epic-issue": epicIssueWorker,
+  "create-ui-design": createUiDesignWorker,
+  "apply-ui-design": applyUiDesignWorker
 };
 function printUsage() {
   console.log(`Usage: claude-task-worker <command> [--project <name>] [--epic <issue-number>] [--label <label-name>]
@@ -3537,6 +3964,8 @@ Workers:
   resolve-conflict  Poll cc-resolve-conflict PRs and run /resolve-conflict
   check-dependabot  Poll dependabot PRs every 1 hour
   epic-issue        Poll cc-epic-issue issues and create epic PR when all sub-issues are closed
+  create-ui-design  Poll cc-create-ui-design issues and create a Pencil design PR (requires uiDesign.enabled)
+  apply-ui-design   Poll cc-ui-design-pr-created issues and write the design reference back once the design PR is merged (requires uiDesign.enabled)
   all               Poll all workers except triage-created-issue, triage-pr, check-dependabot
   yolo              Poll all workers including triage-created-issue, triage-pr, check-dependabot
 
@@ -3731,7 +4160,9 @@ if (hasProjectFilter()) {
       updateIssueWorker({ epicFilters, labelFilters }),
       answerIssueQuestionsWorker({ epicFilters, labelFilters }),
       resolveConflictWorker(),
-      epicIssueWorker({ epicFilters, labelFilters })
+      epicIssueWorker({ epicFilters, labelFilters }),
+      createUiDesignWorker({ epicFilters, labelFilters }),
+      applyUiDesignWorker({ epicFilters, labelFilters })
     ]);
   })();
 } else if (workerType === "yolo") {
@@ -3750,7 +4181,9 @@ if (hasProjectFilter()) {
       checkDependabotWorker(),
       triagePrWorker(),
       resolveConflictWorker(),
-      epicIssueWorker({ epicFilters, labelFilters })
+      epicIssueWorker({ epicFilters, labelFilters }),
+      createUiDesignWorker({ epicFilters, labelFilters }),
+      applyUiDesignWorker({ epicFilters, labelFilters })
     ]);
   })();
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-task-worker",
-  "version": "0.33.1",
+  "version": "0.35.0",
   "description": "CLI tool that polls GitHub Issues/PRs and delegates work to Claude CLI",
   "type": "module",
   "main": "dist/index.js",