direct-verify

目的

DIRECTタスクで実行した設定作業の動作確認とテストを行います。設定が正しく適用され、システムが期待通りに動作することを確認します。

前提条件

• /tsumiki:direct-setup が実行済み
• タスクIDが提供されている
• 設定作業の記録が存在する

実行内容

【重要】: direct-setupで作成されたファイルについて、コンパイルエラーや構文エラーが見つかった場合は自動的に解決を試行します。

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ツールで読み込み、設定作業の結果を確認
• 環境変数の確認
• 設定ファイルの内容確認
• 依存関係のインストール状況確認
• サービスの起動状況確認

4. コンパイル・構文確認

• TypeScript/JavaScript構文エラーチェック（該当する場合）
• 設定ファイルの構文確認（JSON, YAML等）
• SQL構文確認（該当する場合）
• 最低限のコンパイルエラー解消
• エラーが見つかった場合は自動的に修正を試行

5. 動作テストの実行

• @agent-symbol-searcher で既存のテストケースや検証スクリプトを検索し、見つかったファイルをReadツールで読み込み
• 基本的な動作確認
• 接続テスト
• 権限の確認
• エラーケースの確認

6. 品質チェック

• セキュリティ設定の確認
• パフォーマンス基準の確認
• ログの確認

7. CLAUDE.mdへの記録

• サブプロジェクトの存在確認（package.json, Cargo.toml, pyproject.toml, go.mod等）
• 各サブプロジェクトまたはルートの CLAUDE.md の存在確認
• CLAUDE.mdに以下の情報が最小限記載されているか確認：
  • テスト実行コマンド
  • アプリケーション起動コマンド
  • ビルドコマンド（該当する場合）
  • データベース操作コマンド（該当する場合）
• 情報が不足している場合は「## 開発コマンド」セクションを追加/更新
• 既存の情報が古い場合は更新。ファイルがなければ必要に応じて新規作成

8. 検証レポートの作成

• docs/implements/{要件名}/{TASK-ID}/verify-report.md を作成
• 全ての確認結果を記録
• 発見された問題と解決内容を記載
• CLAUDE.mdへの記録内容を記載
• 推奨事項と次のステップを記載

9. タスクの完了マーキング

完了条件を全て満たす場合は、自動的に以下のファイルを更新：

完了条件

• 全ての設定確認項目がクリア
• コンパイル・構文チェックが成功（エラーがすべて解決済み）
• 全ての動作テストが成功
• 品質チェック項目が基準を満たしている
• 発見された問題が適切に対処されている
• セキュリティ設定が適切
• パフォーマンス基準を満たしている

更新対象ファイル

1. Overview ファイル: docs/tasks/{要件名}/overview.md または docs/tasks/{要件名}-overview.md

   • 該当タスクの進捗状況を「完了」に更新
   • 完了日を記録

2. タスク詳細ファイル: docs/tasks/{要件名}/TASK-{task_id}.md または docs/tasks/{要件名}-tasks.md

   • ステータスを「✅ 完了」に更新
   • 完了日を記録
   • 完了条件のチェックボックスを全て [x] に変更

出力先

確認記録は docs/implements/{要件名}/{TASK-ID}/ ディレクトリに以下のファイルとして作成されます：

• verify-report.md: 設定確認・動作テスト記録

CLAUDE.mdへの記録

動作確認で必要となった最小限の実行方法は、必ずCLAUDE.mdに記録してください：

記録すべき内容（最小限）

• テストケースの実行方法

  • テストコマンド（例: npm test, pytest, cargo test）
  • 特定のテストファイル/ディレクトリの実行方法
  • テスト環境のセットアップ方法（必要な場合のみ）

• アプリケーションの実行方法

  • 開発サーバーの起動コマンド（例: npm run dev, python manage.py runserver）
  • ビルドコマンド（例: npm run build, cargo build --release）
  • 本番環境での起動方法（該当する場合）

• データベース関連（該当する場合のみ）

  • マイグレーション実行方法
  • シードデータの投入方法

記録場所の判定ロジック

1. サブプロジェクトの特定

   • package.json, Cargo.toml, pyproject.toml, go.mod などの存在で判定
   • サブプロジェクトごとに独立したCLAUDE.mdを作成

2. CLAUDE.mdの配置ルール

   • サブプロジェクトが存在する場合: 各サブプロジェクトのルートに CLAUDE.md を作成
     • 例: frontend/CLAUDE.md, backend/CLAUDE.md
   • モノリポ構造の場合: ルートの CLAUDE.md に全体像を記載し、各サブプロジェクトに詳細を記載
   • 単一プロジェクトの場合: ルートの CLAUDE.md にのみ記載

3. 既存のCLAUDE.mdが存在する場合

   • 既に必要な情報が記載されているかチェック
   • 不足している情報のみ追記
   • 情報が古い場合は更新

記録方法

各CLAUDE.mdに以下のセクションを追加または更新：

## 開発コマンド

### テスト実行
\`\`\`bash
# すべてのテストを実行
{テストコマンド}

# 特定のテストを実行
{特定テスト実行コマンド}
\`\`\`

### アプリケーション実行
\`\`\`bash
# 開発サーバー起動
{開発サーバー起動コマンド}

# ビルド
{ビルドコマンド}
\`\`\`

### データベース操作（該当する場合）
\`\`\`bash
# マイグレーション実行
{マイグレーションコマンド}

# シードデータ投入
{シードコマンド}
\`\`\`

記録の優先順位

1. 必須: テスト実行方法、アプリケーション起動方法
2. 推奨: ビルド方法、データベース操作（該当する場合）
3. 任意: 詳細なトラブルシューティング（README.mdに記載）

README.mdへの記録

動作確認結果や運用に関する重要な情報は、必ずREADME.mdにも記録してください：

記録すべき内容

• 動作確認の手順とコマンド
• 各コンポーネントの正常動作の確認方法
• パフォーマンス基準値（起動時間、メモリ使用量等）
• 発見された問題と解決方法（トラブルシューティング）
• 推奨される運用設定
• セキュリティ関連の注意事項

記録方法

1. 動作確認セクションに確認手順を追記

   • 既存の「動作確認」セクションがあれば、そこに追記
   • なければ新規作成

2. トラブルシューティングセクションに問題と解決方法を追記

   • 発見された問題は必ず記録
   • 解決コマンドは実行可能な形で記載

3. プロジェクトステータスセクションにタスク完了情報を更新

   • タスク完了時は自動的に更新される

記録例

動作確認セクションへの追加

### {サービス名}の検証

\`\`\`bash
# {確認項目の説明}
{確認コマンド}
\`\`\`

**期待される結果**: {期待される出力や状態}

パフォーマンス基準の記録

### パフォーマンス基準

- 起動時間: {時間}秒以内
- メモリ使用量: {サイズ}MB以内
- レスポンスタイム: {時間}ms以内

トラブルシューティングセクションへの追加

### {問題の概要}

**症状**: {問題の詳細な説明}

\`\`\`bash
# 問題の確認
{確認コマンド}

# 解決方法
{解決コマンド}
\`\`\`

**原因**: {問題の原因}
**解決**: {解決の説明}

出力フォーマット例

<verify_report_format>

# {TASK-ID} 設定確認・動作テスト

## 確認概要

- **タスクID**: {TASK-ID}
- **確認内容**: {設定確認の概要}
- **実行日時**: {実行日時}
- **実行者**: {実行者}

## 設定確認結果

### 1. 環境変数の確認

```bash
# 実行したコマンド
echo $NODE_ENV
echo $DATABASE_URL

**確認結果**:

- [x] NODE_ENV: development (期待値: development)
- [x] DATABASE_URL: postgresql://localhost:5432/mydb (期待値: 正しいDB URL)

### 2. 設定ファイルの確認

**確認ファイル**: `config/database.json`

```bash
# 実行したコマンド
cat config/database.json | jq .

確認結果:

• ファイルが存在する
• JSON形式が正しい
• 必要な設定項目が含まれている

コンパイル・構文チェック結果

1. TypeScript/JavaScript構文チェック

# TypeScriptファイルがある場合
npx tsc --noEmit --skipLibCheck

# JavaScript構文チェック
node --check *.js

チェック結果:

• TypeScript構文エラー: なし
• JavaScript構文エラー: なし
• import/require文: 正常

2. 設定ファイル構文チェック

# JSON設定ファイルの構文チェック
cat config/*.json | jq empty

# YAML設定ファイルの構文チェック（該当する場合）
yamllint config/*.yml

チェック結果:

• JSON構文: 正常
• YAML構文: 正常（該当する場合）
• 設定項目の妥当性: 確認済み

3. SQL構文チェック（該当する場合）

# SQL構文の基本チェック
psql -d mydb --single-transaction --set ON_ERROR_STOP=on -f schema.sql --dry-run

チェック結果:

• SQL構文: 正常
• テーブル定義: 正常
• 制約定義: 正常

3. 依存関係の確認

# 実行したコマンド
npm list express pg

確認結果:

• express: インストール済み
• pg: インストール済み

4. データベース接続テスト

# 実行したコマンド
psql -d mydb -c "SELECT 1;"

確認結果:

• データベース接続成功
• クエリ実行成功

動作テスト結果

1. 基本動作テスト

# 実行したテストコマンド
node -e "console.log('Hello, World!');"

テスト結果:

• Node.js実行環境: 正常
• 基本的なJavaScript実行: 正常

2. データベース接続テスト

// テストスクリプト
const { Pool } = require('pg');
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
});

pool.query('SELECT NOW()', (err, res) => {
  if (err) {
    console.error('Error:', err);
  } else {
    console.log('Connected:', res.rows[0]);
  }
  pool.end();
});

テスト結果:

• データベース接続: 正常
• クエリ実行: 正常
• 接続終了: 正常

3. セキュリティ設定テスト

# 実行したコマンド
ls -la config/
ps aux | grep node

テスト結果:

• 設定ファイルの権限: 適切
• プロセスの実行権限: 適切
• 機密情報の保護: 適切

品質チェック結果

パフォーマンス確認

• 起動時間: 2秒以内
• メモリ使用量: 256MB以内
• CPU使用率: 10%以内

ログ確認

• エラーログ: 異常なし
• 警告ログ: 問題なし
• 情報ログ: 適切に出力

全体的な確認結果

• 設定作業が正しく完了している
• 全ての動作テストが成功している
• 品質基準を満たしている
• 次のタスクに進む準備が整っている

発見された問題と解決

構文エラー・コンパイルエラーの解決

自動解決を試行する問題:

• TypeScript/JavaScript構文エラー
• JSON/YAML構文エラー
• 基本的なSQL構文エラー
• import/require文の問題

問題1: {問題があれば記載}

• 問題内容: {問題の詳細}
• 発見方法: {構文チェック/コンパイル/動作テスト}
• 重要度: {高/中/低}
• 自動解決: {実行した解決コマンド・修正内容}
• 解決結果: {解決済み/手動対応が必要}

解決実行ログ

# 実行した解決コマンド例
# 構文エラー修正
sed -i 's/typo/correct/g' config.js

# 依存関係の修正
npm install missing-package

# 設定ファイル修正
jq '.port = 3000' config.json > temp.json && mv temp.json config.json

解決結果:

• 問題1: 解決済み
• 問題2: 解決済み
• 問題3: 手動対応が必要（詳細は推奨事項に記載）

推奨事項

• {改善提案があれば記載}
• {最適化の提案があれば記載}

次のステップ

• タスクの完了報告
• 関連するタスクの開始準備
• 必要に応じて設定の微調整

CLAUDE.mdへの記録内容

更新対象

• {サブプロジェクトのパス}/CLAUDE.md（サブプロジェクトがある場合）
• ./CLAUDE.md（単一プロジェクトの場合）

追加した情報

## 開発コマンド

### テスト実行
\`\`\`bash
# すべてのテストを実行
{実際に使用したテストコマンド}

# 特定のテストを実行
{実際に使用した特定テスト実行コマンド}
\`\`\`

### アプリケーション実行
\`\`\`bash
# 開発サーバー起動
{実際に使用した起動コマンド}

# ビルド
{実際に使用したビルドコマンド}
\`\`\`

更新理由

• {CLAUDE.mdに該当情報が存在しなかった/情報が古かった}
• 動作確認で必要となった最小限の実行方法を記録

</verify_report_format>

## 更新ファイルのフォーマット

### Overview ファイルの更新フォーマット
<overview_update_format>
```markdown
# 進捗サマリー
## フェーズ1: {フェーズ名}
- [x] TASK-0001: {タスク名} ✅ 完了 (2025-11-03)
- [ ] TASK-0002: {タスク名}

</overview_update_format>

タスク詳細ファイルの更新フォーマット

<task_detail_update_format>

## TASK-0001: {タスク名}

### ステータス
- **状態**: ✅ 完了
- **完了日**: 2025-11-03
- **実装者**: Claude

### 完了条件
- [x] 全ての設定確認項目がクリア
- [x] コンパイル・構文チェックが成功
- [x] 全ての動作テストが成功
- [x] 品質チェック項目が基準を満たしている

</task_detail_update_format>