Merge pull request #17 from makotan/feature/filepath-and-tdd-improvements

ファイルパスの設定が一部ズレてたのを修正

Author: cm-kuroeda

commands/direct-verify.md

@@ -12,19 +12,27 @@ DIRECTタスクで実行した設定作業の動作確認とテストを行い
 
 ## 実行内容
 
+**【重要】**: direct-setupで作成されたファイルについて、コンパイルエラーや構文エラーが見つかった場合は自動的に解決を試行します。
+
 1. **設定の確認**
    - 環境変数の確認
    - 設定ファイルの内容確認
    - 依存関係のインストール状況確認
    - サービスの起動状況確認
 
-2. **動作テストの実行**
+2. **コンパイル・構文確認**
+   - TypeScript/JavaScript構文エラーチェック（該当する場合）
+   - 設定ファイルの構文確認（JSON, YAML等）
+   - SQL構文確認（該当する場合）
+   - 最低限のコンパイルエラー解消
+
+3. **動作テストの実行**
    - 基本的な動作確認
    - 接続テスト
    - 権限の確認
    - エラーケースの確認
 
-3. **品質チェック**
+4. **品質チェック**
    - セキュリティ設定の確認
    - パフォーマンス基準の確認
    - ログの確認
@@ -77,6 +85,53 @@ cat config/database.json | jq .
 - [x] JSON形式が正しい
 - [x] 必要な設定項目が含まれている
 
+## コンパイル・構文チェック結果
+
+### 1. TypeScript/JavaScript構文チェック
+
+```bash
+# TypeScriptファイルがある場合
+npx tsc --noEmit --skipLibCheck
+
+# JavaScript構文チェック
+node --check *.js
+```
+
+**チェック結果**:
+
+- [x] TypeScript構文エラー: なし
+- [x] JavaScript構文エラー: なし
+- [x] import/require文: 正常
+
+### 2. 設定ファイル構文チェック
+
+```bash
+# JSON設定ファイルの構文チェック
+cat config/*.json | jq empty
+
+# YAML設定ファイルの構文チェック（該当する場合）
+yamllint config/*.yml
+```
+
+**チェック結果**:
+
+- [x] JSON構文: 正常
+- [x] YAML構文: 正常（該当する場合）
+- [x] 設定項目の妥当性: 確認済み
+
+### 3. SQL構文チェック（該当する場合）
+
+```bash
+# SQL構文の基本チェック
+psql -d mydb --single-transaction --set ON_ERROR_STOP=on -f schema.sql --dry-run
+```
+
+**チェック結果**:
+
+- [x] SQL構文: 正常
+- [x] テーブル定義: 正常
+- [x] 制約定義: 正常
+
 ### 3. 依存関係の確認
 
 ```bash
@@ -175,14 +230,42 @@ ps aux | grep node
 - [x] 品質基準を満たしている
 - [x] 次のタスクに進む準備が整っている
 
-## 発見された問題
+## 発見された問題と解決
+
+### 構文エラー・コンパイルエラーの解決
+
+**自動解決を試行する問題**:
+- TypeScript/JavaScript構文エラー
+- JSON/YAML構文エラー
+- 基本的なSQL構文エラー
+- import/require文の問題
 
 ### 問題1: {問題があれば記載}
 
 - **問題内容**: {問題の詳細}
+- **発見方法**: {構文チェック/コンパイル/動作テスト}
 - **重要度**: {高/中/低}
-- **対処法**: {対処方法}
-- **ステータス**: {解決済み/対応中/未対応}
+- **自動解決**: {実行した解決コマンド・修正内容}
+- **解決結果**: {解決済み/手動対応が必要}
+
+### 解決実行ログ
+
+```bash
+# 実行した解決コマンド例
+# 構文エラー修正
+sed -i 's/typo/correct/g' config.js
+
+# 依存関係の修正
+npm install missing-package
+
+# 設定ファイル修正
+jq '.port = 3000' config.json > temp.json && mv temp.json config.json
+```
+
+**解決結果**:
+- [x] 問題1: 解決済み
+- [x] 問題2: 解決済み
+- [ ] 問題3: 手動対応が必要（詳細は推奨事項に記載）
 
 ## 推奨事項
 
@@ -214,6 +297,7 @@ ps aux | grep node
 ### 完了条件
 以下の条件を全て満たす場合にタスクを完了とマークします：
 - [ ] 全ての設定確認項目がクリア
+- [ ] コンパイル・構文チェックが成功（エラーがすべて解決済み）
 - [ ] 全ての動作テストが成功
 - [ ] 品質チェック項目が基準を満たしている
 - [ ] 発見された問題が適切に対処されている

commands/kairo-design.md

@@ -1,14 +1,23 @@
 # kairo-design
 
 ## 目的
+
 承認された要件定義書に基づいて、技術設計文書を生成する。データフロー図、TypeScriptインターフェース、データベーススキーマ、APIエンドポイントを含む包括的な設計を行う。
 
 ## 前提条件
+
 - `docs/spec/` に要件定義書が存在する
 - 要件がユーザによって承認されている
 
 ## 実行内容
 
+**【信頼性レベル指示】**:
+各項目について、元の資料（EARS要件定義書・設計文書含む）との照合状況を以下の信号でコメントしてください：
+
+- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
+- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
+- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合
+
 1. **要件の分析**
    - 要件定義書を読み込む
    - 機能要件と非機能要件を整理する
@@ -52,61 +61,73 @@
 ## 出力フォーマット例
 
 ### architecture.md
+
 ```markdown
 # {要件名} アーキテクチャ設計
 
 ## システム概要
+
 {システムの概要説明}
 
 ## アーキテクチャパターン
+
 - パターン: {選択したパターン}
 - 理由: {選択理由}
 
 ## コンポーネント構成
+
 ### フロントエンド
+
 - フレームワーク: {使用フレームワーク}
 - 状態管理: {状態管理方法}
 
 ### バックエンド
+
 - フレームワーク: {使用フレームワーク}
 - 認証方式: {認証方法}
 
 ### データベース
+
 - DBMS: {使用するDBMS}
 - キャッシュ: {キャッシュ戦略}
 ```
 
 ### dataflow.md
+
 ```markdown
 # データフロー図
 
 ## ユーザーインタラクションフロー
+
 \`\`\`mermaid
 flowchart TD
-    A[ユーザー] --> B[フロントエンド]
-    B --> C[API Gateway]
-    C --> D[バックエンド]
-    D --> E[データベース]
+A[ユーザー] --> B[フロントエンド]
+B --> C[API Gateway]
+C --> D[バックエンド]
+D --> E[データベース]
 \`\`\`
 
 ## データ処理フロー
+
 \`\`\`mermaid
 sequenceDiagram
-    participant U as ユーザー
-    participant F as フロントエンド
-    participant B as バックエンド
-    participant D as データベース
-    
+participant U as ユーザー
+participant F as フロントエンド
+participant B as バックエンド
+participant D as データベース
+
     U->>F: アクション
     F->>B: APIリクエスト
     B->>D: クエリ実行
     D-->>B: 結果返却
     B-->>F: レスポンス
     F-->>U: 画面更新
+
 \`\`\`
 ```
 
 ### interfaces.ts
+
 ```typescript
 // エンティティ定義
 export interface User {
@@ -135,6 +156,7 @@ export interface ApiResponse<T> {
 ```
 
 ### database-schema.sql
+
 ```sql
 -- ユーザーテーブル
 CREATE TABLE users (
@@ -150,38 +172,46 @@ CREATE INDEX idx_users_email ON users(email);
 ```
 
 ### api-endpoints.md
+
 ```markdown
 # API エンドポイント仕様
 
 ## 認証
+
 ### POST /auth/login
+
 リクエスト:
 \`\`\`json
 {
-  "email": "[email protected]",
-  "password": "password"
+"email": "[email protected]",
+"password": "password"
 }
 \`\`\`
 
 レスポンス:
 \`\`\`json
 {
-  "success": true,
-  "data": {
-    "token": "jwt-token",
-    "user": { ... }
-  }
+"success": true,
+"data": {
+"token": "jwt-token",
+"user": { ... }
+}
 }
 \`\`\`
 
 ## ユーザー管理
+
 ### GET /users/:id
+
 ### POST /users
+
 ### PUT /users/:id
+
 ### DELETE /users/:id
 ```
 
 ## 実行後の確認
+
 - 作成したファイルの一覧を表示
 - 設計の主要なポイントをサマリーで表示
 - ユーザに確認を促すメッセージを表示

commands/kairo-implement.md

@@ -1,16 +1,25 @@
 # kairo-implement
 
 ## 目的
+
 分割されたタスクを順番に、またはユーザが指定したタスクを実装する。既存のTDDコマンドを活用して品質の高い実装を行う。
 
 ## 前提条件
+
 - `docs/tasks/{要件名}-tasks.md` にタスク一覧が存在する
 - ユーザがタスクの実装を承認している
 - 既存のTDDコマンドが利用可能である
 - 実装用のワークスペースが設定されている
 
 ## 実行内容
 
+**【信頼性レベル指示】**:
+各項目について、元の資料（EARS要件定義書・設計文書含む）との照合状況を以下の信号でコメントしてください：
+
+- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
+- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
+- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合
+
 1. **タスクの選択**
    - ユーザが指定したタスクIDを確認
    - 指定がない場合は、依存関係に基づいて次のタスクを自動選択