Merge pull request #19 from shinpr/feat/enhance-pre-implementation-planning

feat: enhance pre-implementation planning with self-reflection questions

Author: shinpr

.claude/command-en/task.md

@@ -0,0 +1,13 @@
+---
+description: Execute tasks following appropriate rules
+---
+
+Task: $ARGUMENTS
+
+Before execution, clarify the following:
+
+1. **Applicable Rules**: Which development rules apply to this task?
+2. **Initial Action**: Based on the rules, what should be the first step?
+3. **Prohibitions**: What should be avoided in this task?
+
+Proceed with the task after making the above explicit.

.claude/command-ja/task.md

@@ -0,0 +1,13 @@
+---
+description: タスクを適切なルールに従って実行
+---
+
+タスク: $ARGUMENTS
+
+実行前に、以下を明確にしてください：
+
+1. **適用ルール**: このタスクに該当する開発ルールは？
+2. **初動**: ルールに基づく最初のアクションは？  
+3. **禁止事項**: このタスクで避けるべきことは？
+
+上記を明示してから作業を開始します。

CLAUDE.en.md

@@ -28,7 +28,10 @@ Once the user approves implementation, the following activities can be performed
 
 ### 📋 Mandatory Pre-Implementation Flow
 1. **Report Investigation Results**: "XX is the cause, and there is a problem with YY"
-2. **Present Implementation Plan**: "I will now fix XX. Specifically..."
+2. **Present Implementation Plan**: When formulating a plan, ask yourself the following questions and reflect them in the plan before presenting:
+   - What is the essence of this task, and which rules should guide the approach?
+   - According to the rules, what should be tackled first?
+   - Based on past experience, what failures commonly occur with this type of task?
 3. **Wait for Explicit User Approval**: Approval such as "OK", "proceed", "go ahead"
 4. **Start Implementation After Approval**: Use Edit/Write and other tools
 

CLAUDE.ja.md

@@ -28,7 +28,10 @@
 
 ### 📋 実装前の必須フロー
 1. **調査結果を報告**：「〇〇が原因で、△△に問題があることがわかりました」
-2. **実装計画を提示**：「これから〇〇を修正します。具体的には...」
+2. **実装計画を提示**：計画立案時に以下を自問し、計画に反映し、提示すること
+   - このタスクの本質は何か、どのルールに従って進めるべきか
+   - ルールに基づくと、最初に着手すべきは何か
+   - 過去の経験から、このタスクで起こりがちな失敗は何か
 3. **ユーザーの明示的な承認を待つ**：「いいよ」「進めて」「OK」などの承認
 4. **承認後に実装開始**：Edit/Write等のツールを使用
 

README.ja.md

@@ -170,7 +170,7 @@ npm run cleanup:processes   # テストプロセスクリーンアップ
 
 ## 🎯 Claude Code カスタムスラッシュコマンド
 
-このボイラープレートには、Claude Codeでの開発を効率化する5つのカスタムスラッシュコマンドが含まれています：
+このボイラープレートには、Claude Codeでの開発を効率化する6つのカスタムスラッシュコマンドが含まれています：
 
 ### `/onboard`
 プロジェクトのルールファイルを読み込み、開発規約を徹底します。
@@ -206,6 +206,13 @@ npm run cleanup:processes   # テストプロセスクリーンアップ
 - 要件変更や重大エラーの検知と適切な対応
 - 実装完了後のサマリーとカバレッジ報告
 
+### `/task`
+タスクを適切なルールに従って実行します。
+- 実行前に適用すべき開発ルールを明確化
+- ルールに基づく初動アクションの決定
+- タスクで避けるべき禁止事項の確認
+- メタ認知を促進し、実装エラーを事前に防止
+
 これらのコマンドは `.claude/commands/` に配置されており、プロジェクト内でのみ使用可能です。
 
 ## 🤖 Claude Code専用ワークフロー

README.md

@@ -169,7 +169,7 @@ npm run cleanup:processes   # Cleanup test processes
 
 ## 🎯 Claude Code Custom Slash Commands
 
-This boilerplate includes 5 custom slash commands to streamline development with Claude Code:
+This boilerplate includes 6 custom slash commands to streamline development with Claude Code:
 
 ### `/onboard`
 Loads project rule files and enforces development conventions.
@@ -205,6 +205,13 @@ Implements decomposed tasks in autonomous execution mode.
 - Detect requirement changes or critical errors with appropriate responses
 - Post-implementation summary and coverage reporting
 
+### `/task`
+Executes tasks following appropriate rules.
+- Clarify applicable development rules before execution
+- Determine initial actions based on rules
+- Identify prohibitions to avoid in the task
+- Promote metacognition and prevent implementation errors proactively
+
 These commands are located in `.claude/commands/` and are only available within the project.
 
 ## 🤖 Claude Code Specialized Workflow

package.json

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