Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 35 additions & 4 deletions MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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プロセスを実行したい場合は、以下のコマンドを順次実行できます:
Expand Down Expand Up @@ -56,7 +75,19 @@ TASK作成時に `DIRECT` と判定している場合は、以下のコマンド

### Kairoコマンド(包括的フロー)

#### 1. 要件定義
#### 1. 技術スタック初期化

プロジェクトの技術スタック(フレームワーク、ライブラリ)を初期化します:

```
/init-tech-stack

```
init-tech-stack は以下を生成します:

生成されたファイル: `/docs/tech-stack.md` 配下

#### 2. 要件定義

最初に、プロジェクトの要件概要をKairoに伝えます:

Expand All @@ -77,7 +108,7 @@ Kairoは以下を生成します:

生成されたファイル: `/docs/spec/{要件名}-requirements.md`

#### 2. 設計
#### 3. 設計

要件を確認・修正した後、設計を依頼します:

Expand All @@ -96,7 +127,7 @@ Kairoは以下を生成します:

生成されたファイル: `/docs/design/{要件名}/` 配下

#### 3. タスク分割
#### 4. タスク分割

設計を確認した後(承認は省略可)、タスク分割を実行します:

Expand All @@ -115,7 +146,7 @@ Kairoは以下を生成します:

生成されたファイル: `/docs/tasks/{要件名}-tasks.md`

#### 4. 実装
#### 5. 実装

タスクを確認した後、実装を開始します:
(TDDサイクルまたはDIRECTを手動実行をお勧めします
Expand Down
13 changes: 9 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ Kairoは要件定義から実装までの開発プロセスを自動化・支援

## 利用可能なコマンド

- `init-tech-stack` - 技術スタックの特定

### Kairoコマンド(包括的開発フロー)
- `kairo-requirements` - 要件定義
- `kairo-design` - 設計文書生成
Expand All @@ -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
```

Expand Down
24 changes: 18 additions & 6 deletions commands/direct-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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ツールで読み込み
- 環境変数の設定
- 設定ファイルの作成・更新
Expand All @@ -31,14 +43,14 @@ DIRECTタスクの設定作業を実行します。設計文書に基づいて
- サービスの起動設定
- 権限の設定

3. **作業記録の作成**
4. **作業記録の作成**
- 実行したコマンドの記録
- 変更した設定の記録
- 遭遇した問題と解決方法の記録

## 出力先

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

## 出力フォーマット例
Expand Down Expand Up @@ -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}
```
```
39 changes: 27 additions & 12 deletions commands/direct-verify.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`: 設定確認・動作テスト記録

## 出力フォーマット例
Expand Down Expand Up @@ -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ディレクトリの該当するタスクファイルに完了マークを付けてください。

### 完了条件
以下の条件を全て満たす場合にタスクを完了とマークします:
Expand All @@ -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` を作成または更新してください。
Expand Down
Loading