Files
gh-classmethod-tsumiki/commands/direct-setup.md
2025-11-29 18:09:29 +08:00

4.6 KiB
Raw Blame History

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

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. 設計文書の確認

    • 読み込んだ技術スタック定義に基づいて関連ファイルを特定
    • @agent-symbol-searcher で関連設計文書や設定パターンを検索し、見つかったファイルをReadツールで読み込み
    • docs/design/{要件名}/architecture.md をReadツールで読み込み
    • docs/design/{要件名}/database-schema.sql をReadツールで読み込み
    • その他関連する設計文書をReadツールで読み込み
  4. 設定作業の実行

    • @agent-symbol-searcher で既存の設定ファイルや環境変数を検索し、見つかったファイルをReadツールで読み込み
    • 環境変数の設定
    • 設定ファイルの作成・更新
    • 依存関係のインストール
    • データベースの初期化
    • サービスの起動設定
    • 権限の設定
  5. 作業記録の作成

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

出力先

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

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

出力フォーマット例

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

## 作業概要

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

## 設計文書参照

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

## 実行した作業

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

```bash
# 実行したコマンド
export NODE_ENV=development
export DATABASE_URL=postgresql://localhost:5432/mydb
```

設定内容:

  • NODE_ENV: 開発環境に設定
  • DATABASE_URL: PostgreSQLデータベースのURL

2. 設定ファイルの作成

作成ファイル: config/database.json

{
  "development": {
    "host": "localhost",
    "port": 5432,
    "database": "mydb"
  }
}

3. 依存関係のインストール

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

インストール内容:

  • express: Webフレームワーク
  • pg: PostgreSQLクライアント

4. データベースの初期化

# 実行したコマンド
createdb mydb
psql -d mydb -f database-schema.sql

実行内容:

  • データベース作成
  • スキーマの適用

作業結果

  • 環境変数の設定完了
  • 設定ファイルの作成完了
  • 依存関係のインストール完了
  • データベースの初期化完了
  • サービスの起動設定完了

遭遇した問題と解決方法

問題1: {問題の概要}

  • 発生状況: {問題が発生した状況}
  • エラーメッセージ: {エラーメッセージ}
  • 解決方法: {解決方法}

次のステップ

  • /tsumiki:direct-verify を実行して設定を確認
  • 必要に応じて設定の調整を実施

実行後の確認

  • docs/implements/{要件名}/{TASK-ID}/setup-report.md ファイルが作成されていることを確認
  • 設定が正しく適用されていることを確認
  • 次のステップdirect-verifyの準備が整っていることを確認

ディレクトリ作成

実行前に必要なディレクトリを作成してください:

mkdir -p docs/implements/{要件名}/{TASK-ID}