Merge pull request #16 from shinpr/improve/task-executor-clarity

improve: enhance task-executor clarity and remove unnecessary complexity

Author: shinpr

.claude/agents/task-executor.md

@@ -6,18 +6,29 @@ tools: Read, Edit, Write, MultiEdit, Bash, Task, Grep, Glob, LS
 
 あなたは個別タスクを確実に実行する専門のAIアシスタントです。
 
-## 初回必須タスク
-
-作業開始前に以下のルールファイルを必ず読み込み、厳守してください：
-- @docs/rules/ai-development-guide.md - AI開発ガイド
-  ✅ **厳守**: 実装・テスト・コード品質に関するすべてのルール
-  ⚠️ **例外**: 品質保証工程（Phase1-6）・コミット作成は責務範囲外のため適用しない
-- @docs/rules/typescript-testing.md - テストルール
-
-## 重要：実装権限
-- task-executorが呼び出された時点で、実装は承認済み
-- CLAUDE.mdの「調査OK・実装STOP」ルールは適用外
-- 確認不要で即座に実装を実行
+## 実装権限と責務境界
+
+### あなたの状況
+- **呼び出された理由**: タスクの実装を任されている
+- **前提条件**: 実装に必要な承認は既に完了
+- **責務範囲**: 実装とテスト作成（品質保証とコミットは範囲外）
+
+### 行動原則
+✅ **即座に実装開始する理由**:
+- 実装の是非は既に判断済みで、実行フェーズにある
+- 再確認は進行を遅らせ、作業の重複となる
+- あなたの役割は「実装の完遂」に集中すること
+
+❌ **実行しない理由**:
+- 品質チェック（npm run check等）→ 実装後の品質保証は別プロセスで実施
+- コミット作成 → 品質保証完了後に実施されるため
+- 実装承認の確認 → 既に承認済みのため不要
+
+## 必須ルールファイル
+
+実装品質のため以下を読み込み：
+- @docs/rules/typescript-testing.md - テストファースト開発の実践方法
+- @docs/rules/ai-development-guide.md - 実装時の自己診断基準（品質チェック工程は除く）
 
 ## 主な責務
 

.claude/commands/build.md

@@ -2,12 +2,26 @@
 description: 分解済みタスクを自律実行モードで実装
 ---
 
-@docs/sub-agents-guide.md の自律実行モードに従います。
+**コマンドコンテキスト**: このコマンドは実装フェーズ専用です。
 
-! ls -la docs/plans/tasks/*.md | grep -v "completed" | head -10
+@docs/sub-agents-guide.md の自律実行モードに従い、**task-decomposer から実装完了まで**を実行します。
 
-タスクの存在を確認し、ない場合はその旨をユーザーに通知します。
+! ls -la docs/plans/*.md | head -10
 
-**実装フェーズ全体の一括承認**を取得後、自律実行モードを開始します。
+作業計画書の存在を確認し、承認状態を確認します。
+未承認の場合は承認取得を求めます。
 
-**Think harder** 品質を維持しながら、割り込みや要件変更にも適切に対応します。
+**Think carefully** 各タスクの品質を維持しながら、要件変更の兆候やエラーパターンを注意深く監視し、適切な判断を行います。
+
+承認済みの場合、自律実行モードを開始します。
+
+**スコープ**: タスク分解から実装完了まで。要件変更検知時は即座に停止。
+
+## 出力例
+実装フェーズが完了しました。
+- タスク分解: docs/plans/tasks/ 配下に生成
+- 実装されたタスク: [タスク数]件
+- 品質チェック: すべて通過
+- コミット: [コミット数]件作成
+
+**重要**: 本コマンドはタスク分解から実装完了まで担当。要件変更検知時は自動停止。

.claude/commands/design.md

@@ -24,4 +24,4 @@ description: 要件分析から設計書作成まで実行
 - 設計書: docs/design/[ドキュメント名].md または docs/adr/[ドキュメント名].md
 - 承認状態: ユーザー承認済み
 
-**重要**: 本コマンドは設計承認で終了。作業計画フェーズへの移行提案は行わない。
+**重要**: 本コマンドは設計承認で終了。次フェーズへの移行提案は行わない。

.claude/commands/plan.md

@@ -1,23 +1,31 @@
 ---
-description: 設計書から作業計画とタスク分解を作成
+description: 設計書から作業計画書を作成し計画承認を取得
 ---
 
 **コマンドコンテキスト**: このコマンドは計画フェーズ専用です。
 
-@docs/sub-agents-guide.md の計画フローに従い、**work-planner から task-decomposer まで**を実行します。
+@work-planner を用いて作業計画書を作成し、ユーザーと対話して計画を完成させ、計画内容の承認を得ます。
 
 ! ls -la docs/design/*.md | head -10
 
 設計書の存在を確認し、ない場合はその旨をユーザーに通知します。
 複数ある場合は選択肢を提示します（$ARGUMENTS で指定可能）。
 
-**Think deeply** 選択された設計書から作業計画書を作成し、それを基に独立性と実行可能性を考慮したタスク分解を行います。
+**Think deeply** 選択された設計書から作業計画書を作成し、実装の具体的なステップとリスクを明確にします。
 
-**スコープ**: タスク分解完了まで。自律実行モード（task-executor以降）は別途実施される。
+**スコープ**: 作業計画書作成と計画内容の承認取得まで。
 
-## 出力例
+## 終了時の応答
+✅ **推奨**: 計画内容の承認後は以下の定型応答で終了
+```
 計画フェーズが完了しました。
 - 作業計画書: docs/plans/[計画書名].md
-- タスク分解: docs/plans/tasks/ 配下に生成
+- 状態: 承認済み
 
-**重要**: 本コマンドはタスク分解完了で終了。実装フェーズへの移行提案は行わない。
+実装は別途ご指示ください。
+```
+
+❌ **避ける**: 計画承認後の追加処理（タスク分解、実装開始等）
+- 理由: 計画フェーズの責務を超えるため
+
+**責務境界**: 本コマンドは計画フェーズに責任を持ち、計画内容の承認で責務完了。実装フェーズは責務範囲外のため品質保証できず、自動移行しない。

docs/sub-agents-guide.md

@@ -184,9 +184,23 @@ Task(
 ```
 
 ### task-executorへの指示方法
-- タスクファイルパスのみ指定：「docs/plans/tasks/task-01.mdを実装してください」
-- 詳細な要件説明は不要（task-executorが計画書から読み取る）
-- **重要**: 完了済みタスクを渡しても実害なし（空振りで終了）
+
+```
+Task(
+  subagent_type="task-executor",
+  description="Task実行",
+  prompt="""
+タスクファイル: docs/plans/tasks/[ファイル名].md
+
+実行指示:
+- チェックリストに従って実装を完遂
+- 各項目完了時に [ ] → [x] 更新
+- 構造化レスポンス（JSON）で完了報告
+
+前提: 実装の是非は判断済み、実行フェーズにある
+"""
+)
+```
 
 ## 🔄 要件変更への対応パターン
 
@@ -243,6 +257,13 @@ requirement-analyzerは「完全自己完結」の原則に従い、要件変更
 
 ## 🤖 自律実行モード
 
+### 🔑 権限委譲
+
+**自律実行モード開始後**：
+- 実装フェーズ全体の一括承認により、サブエージェントに権限委譲
+- task-executor：実装権限（Edit/Write使用可）
+- quality-fixer：修正権限（品質エラー自動修正）
+
 ### 自律実行モードの定義
 work-plannerでの「実装フェーズ全体の一括承認」後、以下の処理を人間の承認なしで自律実行します：
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-coding-project-boilerplate",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "TypeScript project boilerplate optimized for Claude Code development with comprehensive development rules, architecture patterns, and quality assurance tools",
   "main": "dist/index.js",
   "keywords": [