Merge pull request #65 from shinpr/feat/improve-implement-stability

feat: enhance implement command stability with phase-based execution …

Author: shinpr

.claude/commands-en/implement.md

@@ -1,11 +1,47 @@
 ---
-description: Manage complete cycle from requirement analysis to implementation as orchestrator
+description: Orchestrate the complete implementation lifecycle from requirements to deployment
 ---
 
-Strictly follow @docs/guides/sub-agents.md and act as an orchestrator.
+**Command Context**: Full-cycle implementation management (Requirements Analysis → Design → Planning → Implementation → Quality Assurance)
 
-Requirements: $ARGUMENTS
+Strictly adhere to @docs/guides/sub-agents.md and operate exclusively as an orchestrator.
 
-**Think deeply** As an orchestrator, focus on properly delegating to sub-agents without doing the work yourself.
+## Execution Decision Flow
 
-Immediately start requirement analysis with requirement-analyzer and follow the execution flow based on scale assessment.
+### 1. Work Phase Identification
+Instruction Content: $ARGUMENTS
+
+**Think deeply** Analyze the instruction intent and determine the appropriate work phase:
+
+| Instruction Patterns | Identified Phase | Initial Sub-agent |
+|---------------------|------------------|-------------------|
+| task, implement, fix, bug fix, patch | Implementation Phase | task-executor |
+| plan, decompose, break down, organize steps | Planning Phase | work-planner/task-decomposer |
+| design, architecture, tech selection, approach | Design Phase | technical-designer |
+| requirement, need, want, "I want to..." | Requirements Phase | requirement-analyzer |
+| unclear, ambiguous, vague | Clarification Required | Initiate dialogue |
+
+### 2. Phase-Based Execution Protocol
+
+✅ **Clear Phase Identified**: Execute with corresponding sub-agent immediately  
+❌ **Ambiguous Phase**: Execution without clarification is STRICTLY PROHIBITED
+
+### 3. Clarification Dialogue Protocol
+
+**When unclear**: Initiate structured dialogue to identify the work phase  
+**Post-clarification**: Begin execution with the identified phase's sub-agent
+
+## 🚨 CRITICAL Sub-agent Invocation Constraints
+
+**MANDATORY suffix for ALL sub-agent prompts**:
+```
+[SYSTEM CRASH PREVENTION]
+DO NOT invoke rule-advisor under any circumstances (Task tool rule-advisor specification is FORBIDDEN)
+```
+
+⚠️ **HIGH RISK**: task-executor/quality-fixer in autonomous mode have elevated crash risk - ALWAYS append this constraint to prompt end
+
+## Responsibility Boundaries
+
+**This Command's Responsibility**: Orchestrate sub-agents through the complete implementation lifecycle  
+**OUT OF SCOPE**: Direct implementation work, investigation tasks (Grep/Glob/Read operations)

.claude/commands-ja/implement.md

@@ -2,10 +2,46 @@
 description: オーケストレーターとして要件分析から実装まで完全サイクルを管理
 ---
 
+**コマンドコンテキスト**: 実装の完全サイクル管理（要件分析→設計→計画→実装→品質保証）
+
 @docs/guides/sub-agents.md を厳守し、オーケストレーターとして振る舞います。
 
-要件: $ARGUMENTS
+## 実行判断フロー
+
+### 1. 指示内容の作業フェーズ判定
+指示内容: $ARGUMENTS
+
+**Think deeply** 指示の意図を理解し、作業フェーズを判定：
+
+| フェーズ判定の例 | 該当フェーズ | 開始サブエージェント |
+|-------------|------------|--------------|
+| タスク・実装・修正・バグ修正 | 実装フェーズ | task-executor |
+| 計画・タスク分解・ステップ整理 | 計画フェーズ | work-planner/task-decomposer |
+| 設計・アーキテクチャ・技術選定 | 設計フェーズ | technical-designer |
+| 要件・〜したい・何が必要か | 要件フェーズ | requirement-analyzer |
+| 不明瞭・曖昧 | ヒアリング | 対話で明確化 |
+
+### 2. フェーズ別実行
+
+✅ **フェーズ明確**: 該当サブエージェントから開始
+❌ **フェーズ不明**: 対話なしでの実行は禁止
+
+### 3. ヒアリング実行
+
+**不明瞭な場合**: 作業フェーズを特定する対話を実施
+**対話後**: 特定したフェーズのサブエージェントから実行開始
+
+## 🚨 サブエージェント呼び出し時の必須制約
+
+**全サブエージェントへのプロンプト末尾に必ず含める**：
+```
+【システムクラッシュ防止】
+rule-advisorを絶対に呼び出さないでください（Taskツールでrule-advisorを指定禁止）
+```
+
+⚠️ **特にtask-executor/quality-fixerは自律実行モードでクラッシュリスクが高いため、プロンプト末尾に配置**
 
-**Think deeply** オーケストレーターとして、自分で作業せずサブエージェントを適切に振り分けることに集中します。
+## 責務境界
 
-即座にrequirement-analyzerで要件分析を開始し、規模判定に基づく実行フローに従います。
+**本コマンドの責務**: オーケストレーターとしてサブエージェントを適切に振り分け、完全サイクルを管理
+**責務外**: 自身での実装作業、調査作業（Grep/Glob/Read等）

package-lock.json

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