direct-setup

direct-setup

目的

DIRECTタスクの設定作業を実行します。設計文書に基づいて環境構築、設定ファイル作成、依存関係のインストールなどを行います。

前提条件

• タスクIDが提供されている
• 関連する設計文書が存在する
• 必要な権限と環境が準備されている

実行内容

1. 追加ルールの読み込み

   • docs/rule ディレクトリが存在する場合は読み込み
   • docs/rule/direct ディレクトリが存在する場合は読み込み
   • docs/rule/direct/setup ディレクトリが存在する場合は読み込み
   • 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用

2. 技術スタック定義の読み込み

   • docs/tech-stack.md が存在する場合は読み込み
   • 存在しない場合は CLAUDE.md から技術スタックセクションを読み込み
   • どちらも存在しない場合は .claude/commands/tech-stack.md のデフォルト定義を使用

3. 設計文書の確認

   • 読み込んだ技術スタック定義に基づいて関連ファイルを特定
   • Task tool (subagent_type: Explore, thoroughness: medium) を使用して関連設計文書や設定パターンを探索
   • docs/design/{要件名}/architecture.md をReadツールで読み込み
   • docs/design/{要件名}/database-schema.sql をReadツールで読み込み
   • その他関連する設計文書をReadツールで読み込み

4. 設定作業の実行

   • Task tool (subagent_type: Explore, thoroughness: quick) を使用して既存の設定ファイルや環境変数を探索
   • 環境変数の設定
   • 設定ファイルの作成・更新
   • 依存関係のインストール
   • データベースの初期化
   • サービスの起動設定
   • 権限の設定

5. 作業記録の作成

   • 実行したコマンドの記録
   • 変更した設定の記録
   • 遭遇した問題と解決方法の記録

出力先

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

• setup-report.md: 設定作業実行記録

README.mdへの記録

開発環境の構築や運用に関する重要な情報は、必ずREADME.mdにも記録してください：

記録すべき内容

• 新しい環境変数の設定方法
• 追加した依存関係とそのインストール方法
• データベースの初期化手順
• 新しいサービスの起動方法
• 設定ファイルの場所と説明
• トラブルシューティング情報（エラーと解決方法）

記録方法

1. 既存のセクションに追記する場合は、適切な箇所を見つけて追記
2. 新しいセクションが必要な場合は、適切な位置に新規セクションを作成
3. コマンド例は必ずコードブロックで記載
4. 重要な注意事項は明確に記載

記録例

セットアップセクションへの追加

### 6. {新しいサービス名}のセットアップ
\`\`\`bash
cd {ディレクトリ}
{インストールコマンド}
{起動コマンド}
\`\`\`

開発コマンドセクションへの追加

### {サービス名}
\`\`\`bash
# {コマンドの説明}
{コマンド}
\`\`\`

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

### {問題の概要}

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

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

出力フォーマット例

<setup_report_format>

# {TASK-ID} 設定作業実行

## 作業概要

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

## 設計文書参照

- **参照文書**: {参照した設計文書のリスト}
- **関連要件**: {REQ-XXX, REQ-YYY}

## 実行した作業

### 1. 環境変数の設定

```bash