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: 23 additions & 16 deletions MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,7 @@ Kairoは以下を生成します:
- 各タスクの詳細(テスト要件、UI/UX要件含む)
- 実行順序とスケジュール

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

#### 5. 実装

Expand Down Expand Up @@ -198,14 +198,17 @@ Kairoは各タスクに対して内部的にTDDコマンドを使用して以下

###### rev-tasks(タスク構造分析)

**目的**: 既存コードから実装済み機能をタスクとして抽出・整理
**目的**: 既存コードから機能単位で実装済み機能をタスクとして抽出・整理

**生成されるファイル**:
- `docs/reverse/{プロジェクト名}-discovered-tasks.md`

- `docs/tasks/{要件名}/overview.md` - 機能ごとのタスク一覧
- `docs/tasks/{要件名}/TASK-XXXX.md` - 個別タスクファイル

**分析内容**:
- コードベース構造の把握
- 実装済み機能の特定
- 機能の特定と分類
- 実装済み機能のタスク分解
- API エンドポイントの抽出
- データベース構造の分析
- タスクの依存関係推定
Expand All @@ -215,11 +218,11 @@ Kairoは各タスクに対して内部的にTDDコマンドを使用して以下
**目的**: 実装されたアーキテクチャから技術設計文書を生成

**生成されるファイル**:
- `docs/reverse/{プロジェクト名}-architecture.md`
- `docs/reverse/{プロジェクト名}-dataflow.md`
- `docs/reverse/{プロジェクト名}-api-specs.md`
- `docs/reverse/{プロジェクト名}-database.md`
- `docs/reverse/{プロジェクト名}-interfaces.ts`
- `docs/design/{要件名}/architecture.md`
- `docs/design/{要件名}/dataflow.md`
- `docs/design/{要件名}/api-endpoints.md`
- `docs/design/{要件名}/database-schema.sql`
- `docs/design/{要件名}/interfaces.ts`

**分析内容**:
- アーキテクチャパターンの特定
Expand All @@ -233,9 +236,9 @@ Kairoは各タスクに対して内部的にTDDコマンドを使用して以下
**目的**: 実装コードからテストケースと仕様書を逆生成

**生成されるファイル**:
- `docs/reverse/{プロジェクト名}-test-specs.md`
- `docs/reverse/{プロジェクト名}-test-cases.md`
- `docs/reverse/tests/` - 生成されたテストコード
- `docs/spec/{要件名}/test-specs.md` - テスト仕様書
- `docs/spec/{要件名}/test-cases.md` - テストケース一覧
- `docs/spec/{要件名}/tests/` - 生成されたテストコード

**分析内容**:
- 既存テストの分析
Expand All @@ -249,7 +252,9 @@ Kairoは各タスクに対して内部的にTDDコマンドを使用して以下
**目的**: 実装機能から要件定義書をEARS記法で逆生成

**生成されるファイル**:
- `docs/reverse/{プロジェクト名}-requirements.md`
- `docs/spec/{要件名}/requirements.md`
- `docs/spec/{要件名}/user-stories.md`
- `docs/spec/{要件名}/acceptance-criteria.md`

**分析内容**:
- ユーザーストーリーの逆算
Expand Down Expand Up @@ -289,11 +294,13 @@ Kairoは各タスクに対して内部的にTDDコマンドを使用して以下
│ └── commands/ # Kairoコマンド
├── docs/
│ ├── implements/ # 実装コード
│ │ └── {タスクID}/
│ │ └── {要件名}/{タスクID}/
│ ├── spec/ # 要件定義書
│ │ └── {要件名}/
│ ├── design/ # 設計文書
│ ├── tasks/ # タスク一覧
│ └── reverse/ # リバース文書
│ │ └── {要件名}/
│ └── tasks/ # タスク一覧
│ └── {要件名}/
├── backend/ # バックエンドコード
├── frontend/ # フロントエンドコード
└── database/ # データベース関連
Expand Down
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,8 @@ Kairoは要件定義から実装までの開発プロセスを自動化・支援
- `tdd-verify-complete` - TDD完了確認

### リバースエンジニアリングコマンド
- `rev-tasks` - 既存コードからタスク一覧を逆生成

- `rev-tasks` - 既存コードから機能単位でタスク一覧を逆生成
- `rev-design` - 既存コードから設計文書を逆生成
- `rev-specs` - 既存コードからテスト仕様書を逆生成
- `rev-requirements` - 既存コードから要件定義書を逆生成
Expand Down
14 changes: 7 additions & 7 deletions commands/rev-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ description: 既存のコードベースから技術設計文書を逆生成し
## 前提条件

- 分析対象のコードベースが存在する
- `docs/reverse/` ディレクトリが存在する(なければ作成)
- `docs/design/{要件名}/` ディレクトリが存在する(なければ作成)
- 可能であれば事前に `/tsumiki:rev-tasks` を実行済み

## 実行内容
Expand Down Expand Up @@ -53,18 +53,18 @@ description: 既存のコードベースから技術設計文書を逆生成し
- ルーティング設計

7. **ファイルの作成**
- `docs/reverse/{プロジェクト名}-architecture.md` - アーキテクチャ概要
- `docs/reverse/{プロジェクト名}-dataflow.md` - データフロー図
- `docs/reverse/{プロジェクト名}-api-specs.md` - API仕様
- `docs/reverse/{プロジェクト名}-database.md` - DB設計
- `docs/reverse/{プロジェクト名}-interfaces.ts` - 型定義集約
- `docs/design/{要件名}/architecture.md` - アーキテクチャ概要
- `docs/design/{要件名}/dataflow.md` - データフロー図
- `docs/design/{要件名}/api-endpoints.md` - API仕様
- `docs/design/{要件名}/database-schema.sql` - DB設計
- `docs/design/{要件名}/interfaces.ts` - 型定義集約

## 出力フォーマット例

### architecture.md

```markdown
# {プロジェクト名} アーキテクチャ設計(逆生成)
# {要件名} アーキテクチャ設計(逆生成)

## 分析日時
{実行日時}
Expand Down
8 changes: 5 additions & 3 deletions commands/rev-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ description: 既存のコードベースから要件定義書を逆生成しま
## 前提条件

- 分析対象のコードベースが存在する
- `docs/reverse/` ディレクトリが存在する(なければ作成)
- `docs/spec/{要件名}/` ディレクトリが存在する(なければ作成)
- 可能であれば事前に `/tsumiki:rev-tasks` および `/tsumiki:rev-design` を実行済み

## 実行内容
Expand Down Expand Up @@ -51,12 +51,14 @@ description: 既存のコードベースから要件定義書を逆生成しま
- 未実装のテストケースを推奨事項として提示

7. **ファイルの作成**
- `docs/reverse/{プロジェクト名}-requirements.md` として保存
- `docs/spec/{要件名}/requirements.md` として保存
- `docs/spec/{要件名}/user-stories.md` としてユーザーストーリーを保存
- `docs/spec/{要件名}/acceptance-criteria.md` として受け入れ基準を保存

## 出力フォーマット例

```markdown
# {プロジェクト名} 要件定義書(逆生成)
# {要件名} 要件定義書(逆生成)

## 分析概要

Expand Down
12 changes: 6 additions & 6 deletions commands/rev-specs.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ description: 既存のコードベースから包括的なテストケースと
## 前提条件

- 分析対象のコードベースが存在する
- `docs/reverse/` ディレクトリが存在する(なければ作成)
- `docs/spec/{要件名}/` ディレクトリが存在する(なければ作成)
- 可能であれば事前に `/tsumiki:rev-requirements`, `/tsumiki:rev-design` を実行済み

## 実行内容
Expand Down Expand Up @@ -52,16 +52,16 @@ description: 既存のコードベースから包括的なテストケースと
- テスト手順書

7. **ファイルの作成**
- `docs/reverse/{プロジェクト名}-test-specs.md` - テスト仕様書
- `docs/reverse/{プロジェクト名}-test-cases.md` - テストケース一覧
- `docs/reverse/tests/` - 生成されたテストコード
- `docs/spec/{要件名}/test-specs.md` - テスト仕様書
- `docs/spec/{要件名}/test-cases.md` - テストケース一覧
- `docs/spec/{要件名}/tests/` - 生成されたテストコード

## 出力フォーマット例

### test-specs.md

```markdown
# {プロジェクト名} テスト仕様書(逆生成)
# {要件名} テスト仕様書(逆生成)

## 分析概要

Expand Down Expand Up @@ -507,7 +507,7 @@ process.env.NODE_ENV = 'test';
### test-cases.md

```markdown
# {プロジェクト名} テストケース一覧(逆生成)
# {要件名} テストケース一覧(逆生成)

## テストケース概要

Expand Down
Loading