Merge pull request #30 from makotan/feature/kairo-major-update

多環境への対応力向上

Author: cm-kuroeda

MANUAL.md

@@ -15,6 +15,25 @@ mkdir -p .claude
 cp -r commands .claude/
 ```
 
+#### オプション：プロジェクト固有のルール設定
+
+セットアップ後、プロジェクト固有のルールや設定を追加できます。
+`docs/rule/{種類1}/{種類2}` ディレクトリ構造でファイルを配置すると、対応するコマンド実行時に自動で読み込まれます。
+
+**読み込まれるディレクトリ階層**:
+- `docs/rule/` （共通ルール）
+- `docs/rule/{種類1}/` （種類レベルのルール）
+- `docs/rule/{種類1}/{種類2}/` （詳細レベルのルール）
+
+**例**: `kairo-requirements` 実行時
+```
+docs/rule/                    # 全コマンド共通ルール
+docs/rule/kairo/              # kairoコマンド共通ルール  
+docs/rule/kairo/requirements/ # kairo-requirements専用ルール
+```
+
+これらのディレクトリ内の `.md` ファイルは、コマンド実行時にコンテキストとして自動読み込みされます。
+
 ### TDDコマンド
 
 TASK作成時に `TDD` と判定している場合で個別にTDDプロセスを実行したい場合は、以下のコマンドを順次実行できます：
@@ -56,7 +75,19 @@ TASK作成時に `DIRECT` と判定している場合は、以下のコマンド
 
 ### Kairoコマンド（包括的フロー）
 
-#### 1. 要件定義
+#### 1. 技術スタック初期化
+
+プロジェクトの技術スタック（フレームワーク、ライブラリ）を初期化します：
+
+```
+/init-tech-stack
+
+```
+init-tech-stack は以下を生成します：
+
+生成されたファイル: `/docs/tech-stack.md` 配下
+
+#### 2. 要件定義
 
 最初に、プロジェクトの要件概要をKairoに伝えます：
 
@@ -77,7 +108,7 @@ Kairoは以下を生成します：
 
 生成されたファイル: `/docs/spec/{要件名}-requirements.md`
 
-#### 2. 設計
+#### 3. 設計
 
 要件を確認・修正した後、設計を依頼します：
 
@@ -96,7 +127,7 @@ Kairoは以下を生成します：
 
 生成されたファイル: `/docs/design/{要件名}/` 配下
 
-#### 3. タスク分割
+#### 4. タスク分割
 
 設計を確認した後（承認は省略可）、タスク分割を実行します：
 
@@ -115,7 +146,7 @@ Kairoは以下を生成します：
 
 生成されたファイル: `/docs/tasks/{要件名}-tasks.md`
 
-#### 4. 実装
+#### 5. 実装
 
 タスクを確認した後、実装を開始します：
 （TDDサイクルまたはDIRECTを手動実行をお勧めします

README.md

@@ -30,6 +30,8 @@ Kairoは要件定義から実装までの開発プロセスを自動化・支援
 
 ## 利用可能なコマンド
 
+- `init-tech-stack` - 技術スタックの特定
+
 ### Kairoコマンド（包括的開発フロー）
 - `kairo-requirements` - 要件定義
 - `kairo-design` - 設計文書生成
@@ -55,16 +57,19 @@ Kairoは要件定義から実装までの開発プロセスを自動化・支援
 ### 包括的な開発フロー
 
 ```bash
-# 1. 要件定義
+# 1. 技術スタック初期化
+/init-tech-stack
+
+# 2. 要件定義
 /kairo-requirements
 
-# 2. 設計
+# 3. 設計
 /kairo-design
 
-# 3. タスク分割
+# 4. タスク分割
 /kairo-tasks
 
-# 4. 実装
+# 5. 実装
 /kairo-implement
 ```
 

commands/direct-setup.md

@@ -16,13 +16,25 @@ DIRECTタスクの設定作業を実行します。設計文書に基づいて
 
 ## 実行内容
 
-1. **設計文書の確認**
+1. **追加ルールの読み込み**
+   - `docs/rule` ディレクトリが存在する場合は読み込み
+   - `docs/rule/direct` ディレクトリが存在する場合は読み込み  
+   - `docs/rule/direct/setup` ディレクトリが存在する場合は読み込み
+   - 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用
+
+2. **技術スタック定義の読み込み**
+   - `docs/tech-stack.md` が存在する場合は読み込み
+   - 存在しない場合は `CLAUDE.md` から技術スタックセクションを読み込み  
+   - どちらも存在しない場合は `.claude/commands/tech-stack.md` のデフォルト定義を使用
+
+3. **設計文書の確認**
+   - 読み込んだ技術スタック定義に基づいて関連ファイルを特定
    - @agent-symbol-searcher で関連設計文書や設定パターンを検索し、見つかったファイルをReadツールで読み込み
    - `docs/design/{要件名}/architecture.md` をReadツールで読み込み
    - `docs/design/{要件名}/database-schema.sql` をReadツールで読み込み
    - その他関連する設計文書をReadツールで読み込み
 
-2. **設定作業の実行**
+3. **設定作業の実行**
    - @agent-symbol-searcher で既存の設定ファイルや環境変数を検索し、見つかったファイルをReadツールで読み込み
    - 環境変数の設定
    - 設定ファイルの作成・更新
@@ -31,14 +43,14 @@ DIRECTタスクの設定作業を実行します。設計文書に基づいて
    - サービスの起動設定
    - 権限の設定
 
-3. **作業記録の作成**
+4. **作業記録の作成**
    - 実行したコマンドの記録
    - 変更した設定の記録
    - 遭遇した問題と解決方法の記録
 
 ## 出力先
 
-作業記録は `docs/implements/{TASK-ID}/` ディレクトリに以下のファイルとして作成されます：
+作業記録は `docs/implements/{要件名}/{TASK-ID}/` ディレクトリに以下のファイルとして作成されます：
 - `setup-report.md`: 設定作業実行記録
 
 ## 出力フォーマット例
@@ -137,14 +149,14 @@ psql -d mydb -f database-schema.sql
 ```
 
 ## 実行後の確認
-- `docs/implements/{TASK-ID}/setup-report.md` ファイルが作成されていることを確認
+- `docs/implements/{要件名}/{TASK-ID}/setup-report.md` ファイルが作成されていることを確認
 - 設定が正しく適用されていることを確認
 - 次のステップ（direct-verify）の準備が整っていることを確認
 
 ## ディレクトリ作成
 
 実行前に必要なディレクトリを作成してください：
 ```bash
-mkdir -p docs/implements/{TASK-ID}
+mkdir -p docs/implements/{要件名}/{TASK-ID}
 ```
 ```

commands/direct-verify.md

@@ -18,35 +18,47 @@ DIRECTタスクで実行した設定作業の動作確認とテストを行い
 
 **【重要】**: direct-setupで作成されたファイルについて、コンパイルエラーや構文エラーが見つかった場合は自動的に解決を試行します。
 
-1. **設定の確認**
+1. **追加ルールの読み込み**
+   - `docs/rule` ディレクトリが存在する場合は読み込み
+   - `docs/rule/direct` ディレクトリが存在する場合は読み込み  
+   - `docs/rule/direct/verify` ディレクトリが存在する場合は読み込み
+   - 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用
+
+2. **技術スタック定義の読み込み**
+   - `docs/tech-stack.md` が存在する場合は読み込み
+   - 存在しない場合は `CLAUDE.md` から技術スタックセクションを読み込み  
+   - どちらも存在しない場合は `.claude/commands/tech-stack.md` のデフォルト定義を使用
+
+3. **設定の確認**
+   - 読み込んだ技術スタック定義に基づいて検証項目を特定
    - @agent-symbol-searcher で関連設定や検証パターンを検索し、見つかったファイルをReadツールで読み込み
-   - `docs/implements/{TASK-ID}/setup-report.md` をReadツールで読み込み、設定作業の結果を確認
+   - `docs/implements/{要件名}/{TASK-ID}/setup-report.md` をReadツールで読み込み、設定作業の結果を確認
    - 環境変数の確認
    - 設定ファイルの内容確認
    - 依存関係のインストール状況確認
    - サービスの起動状況確認
 
-2. **コンパイル・構文確認**
+3. **コンパイル・構文確認**
    - TypeScript/JavaScript構文エラーチェック（該当する場合）
    - 設定ファイルの構文確認（JSON, YAML等）
    - SQL構文確認（該当する場合）
    - 最低限のコンパイルエラー解消
 
-3. **動作テストの実行**
+4. **動作テストの実行**
    - @agent-symbol-searcher で既存のテストケースや検証スクリプトを検索し、見つかったファイルをReadツールで読み込み
    - 基本的な動作確認
    - 接続テスト
    - 権限の確認
    - エラーケースの確認
 
-4. **品質チェック**
+5. **品質チェック**
    - セキュリティ設定の確認
    - パフォーマンス基準の確認
    - ログの確認
 
 ## 出力先
 
-確認記録は `docs/implements/{TASK-ID}/` ディレクトリに以下のファイルとして作成されます：
+確認記録は `docs/implements/{要件名}/{TASK-ID}/` ディレクトリに以下のファイルとして作成されます：
 - `verify-report.md`: 設定確認・動作テスト記録
 
 ## 出力フォーマット例
@@ -288,18 +300,18 @@ jq '.port = 3000' config.json > temp.json && mv temp.json config.json
 ````
 
 ## 実行後の確認
-- `docs/implements/{TASK-ID}/verify-report.md` ファイルが作成されていることを確認
+- `docs/implements/{要件名}/{TASK-ID}/verify-report.md` ファイルが作成されていることを確認
 - 全ての確認項目が完了していることを確認
 - 問題が発見された場合は適切に対処されていることを確認
 - タスクの完了条件を満たしていることを確認
 - 次のタスクに進む準備が整っていることを確認
 
 ## ディレクトリ確認
 
-`docs/implements/{TASK-ID}/` ディレクトリが存在することを確認してください（direct-setupで作成済みのはず）
+`docs/implements/{要件名}/{TASK-ID}/` ディレクトリが存在することを確認してください（direct-setupで作成済みのはず）
 
 ## タスクの完了マーキング
-品質チェックが十分で、全ての確認項目がクリアされた場合は、tasksディレクトリの該当するタスクファイルに完了マークを付けてください。
+品質チェックが十分で、全ての確認項目がクリアされた場合は、**自動的に**tasksディレクトリの該当するタスクファイルに完了マークを付けてください。
 
 ### 完了条件
 以下の条件を全て満たす場合にタスクを完了とマークします：
@@ -312,9 +324,12 @@ jq '.port = 3000' config.json > temp.json && mv temp.json config.json
 - [ ] パフォーマンス基準を満たしている
 
 ### 完了マークの付け方
-1. ユーザが指定したタスクファイルを確認
-2. ファイル内の該当セクションまたはタスク項目に `✅ 完了` または `[COMPLETED]` マークを追加
-3. 完了日時と確認者を記録
+1. `docs/implements/{要件名}/{TASK-ID}/verify-report.md` で完了条件を確認
+2. 該当するタスクファイル（taskman-phase*.md）を特定
+3. タスクの完了状況を以下のように更新：
+   - `- [ ] **タスク完了**` → `- [x] **タスク完了** ✅ 完了 (YYYY-MM-DD)`
+   - 完了条件のチェックボックスも `[x]` に変更
+4. 必要に応じて進捗概要（taskman-overview.md）も更新
 
 ## README.mdの更新
 タスクが完了した場合、プロジェクトのルートディレクトリの `README.md` を作成または更新してください。