Merge pull request #15 from tango238/feature/workflow-swimlane-structure

refactor: workflow.yml の構造をスイムレーン対応に変更

Author: tango238

.claude/agents/verifier.md

@@ -48,6 +48,120 @@ install.sh のファイルコピー行を検証:
 - 削除対象ファイルが存在しないこと
 - CLAUDE.md の SKILL ルールが正しいこと
 
+### 5. Workflow Structure Verification
+
+`feature` → `workflow` 構造変更に関する整合性を検証する。
+
+#### 5-1. generate-workflow.md の検証
+
+対象ファイル: `.claude/commands/teamkit/generate-workflow.md`
+
+**YAML 出力フォーマットが新構造であること**:
+- `workflow:` キーが Output Format セクションに存在すること
+- `feature:` キーが Output Format セクションに**存在しない**こと
+- 各ステップに `actor`, `activity` フィールドが定義されていること
+- オプションフィールド `aggregate`, `event`, `policy` が定義されていること
+
+```bash
+# 新構造の存在確認
+grep -n "^workflow:" .claude/commands/teamkit/generate-workflow.md
+grep -n "actor:" .claude/commands/teamkit/generate-workflow.md | head -5
+grep -n "activity:" .claude/commands/teamkit/generate-workflow.md | head -5
+
+# 旧構造が残っていないこと（YAML キーとしての feature:）
+grep -n "^feature:" .claude/commands/teamkit/generate-workflow.md
+grep -n "scenarios:" .claude/commands/teamkit/generate-workflow.md
+```
+
+**Step Field Reference テーブルが存在すること**:
+- `| actor |`, `| activity |`, `| aggregate |`, `| event |`, `| policy |` の5行が存在すること
+
+**Actor Usage Guidelines セクションが存在すること**:
+- `system` アクターの説明があること
+- 外部システムアクターの説明があること
+
+**Execution Example が新構造であること**:
+- Output (workflow.yml) の例に `workflow:` が使われていること
+- 各ステップに `actor:` と `activity:` があること
+
+#### 5-2. show-event.md の検証
+
+対象ファイル: `.claude/commands/teamkit/show-event.md`
+
+**Step 2 (Read Input) が新構造を参照していること**:
+- `workflow` リストの読み取り指示があること
+- `steps` の各フィールド（`actor`, `activity`, `aggregate`, `event`, `policy`）への言及があること
+- `feature` リストの読み取り指示が**存在しない**こと
+
+```bash
+# 新構造の参照確認
+grep -n "workflow.*steps" .claude/commands/teamkit/show-event.md
+grep -n "step\.actor\|step\.event\|step\.policy" .claude/commands/teamkit/show-event.md
+
+# 旧構造が残っていないこと
+grep -n "feature.*events\|feature.*policy" .claude/commands/teamkit/show-event.md
+```
+
+**Step 4 (Analyze Business Flow) が新構造ベースであること**:
+- `workflow[].trigger` への参照があること
+- `workflow[].steps` を順に辿る指示があること
+
+**Example の Input が新構造であること**:
+- Input (workflow.yml) に `workflow:` セクションがあること
+- `feature:` セクションが**存在しない**こと
+
+#### 5-3. generate-usecase.md の検証
+
+対象ファイル: `.claude/commands/teamkit/generate-usecase.md`
+
+**Step 3 (Read Input) が新構造を参照していること**:
+- `workflow.yml` の説明に `actor`, `activity`, `aggregate`, `event`, `policy` への言及があること
+- `Feature definitions and scenarios` という旧説明が**存在しない**こと
+
+```bash
+# 新構造の参照確認
+grep -n "actor.*activity.*aggregate" .claude/commands/teamkit/generate-usecase.md
+
+# 旧構造が残っていないこと
+grep -n "Feature definitions and scenarios" .claude/commands/teamkit/generate-usecase.md
+grep -n "feature\.scenarios\|feature scenario" .claude/commands/teamkit/generate-usecase.md
+```
+
+**Step 5 の Rules にアクター/エンティティ抽出ルールがあること**:
+- `Actor extraction` ルールが存在すること
+- `Entity extraction` ルールが存在すること
+
+**Step 6 (Verification) が workflow を参照していること**:
+- "EVERY workflow" という表現があること
+- "EVERY feature scenario" が**存在しない**こと
+
+**Example の Input が新構造であること**:
+- Input (workflow.yml) に `workflow:` と `steps:` があること
+- `feature:` と `scenarios:` が**存在しない**こと
+
+#### 5-4. 横断的整合性チェック
+
+3つのコマンドファイル間で、workflow.yml 構造の理解が一致していること:
+
+```bash
+# 3ファイルすべてで workflow 構造を参照していること
+for f in generate-workflow.md show-event.md generate-usecase.md; do
+  echo "=== $f ==="
+  grep -c "workflow" .claude/commands/teamkit/$f
+done
+
+# YAML キーとしての feature: が3ファイルのいずれにも残っていないこと
+# (status.json の feature_name は許容)
+for f in generate-workflow.md show-event.md generate-usecase.md; do
+  echo "=== $f ==="
+  grep -n "^  - name:.*Feature\|^feature:\|feature\.scenarios\|feature\.events\|feature\.policy" .claude/commands/teamkit/$f
+done
+```
+
+**ステップフィールドの一貫性**:
+- 3ファイルすべてで `actor`, `activity` が必須フィールドとして扱われていること
+- 3ファイルすべてで `aggregate`, `event`, `policy` がオプションフィールドとして扱われていること
+
 ## Output
 
 検証結果をマークダウン形式のレポートファイルに保存する。

.claude/commands/teamkit/generate-usecase.md

@@ -28,7 +28,7 @@ Execute the following instructions using `baseDir` and `specDir`.
 
 ## Purpose
 Extract use cases from `{{baseDir}}/{{specDir}}/workflow.yml` and document them in YAML format based on **Robustness Analysis**.
-Ensure all features in `workflow.yml` are covered (Tracking is mandatory).
+Ensure all workflows in `workflow.yml` are covered (Tracking is mandatory).
 
 ## Execution Steps
 
@@ -54,7 +54,7 @@ Ensure all features in `workflow.yml` are covered (Tracking is mandatory).
 
 ### 3. Read Input Files
 Read the following files and understand their content:
--   `{{baseDir}}/{{specDir}}/workflow.yml`: Feature definitions and scenarios
+-   `{{baseDir}}/{{specDir}}/workflow.yml`: Workflow definitions with structured steps (actor, activity, aggregate, event, policy)
 
 ### 4. Use Case Creation Policy (Robustness Analysis)
 
@@ -75,7 +75,7 @@ Instead of just listing steps, identify the **Actor**, **Boundary**, **Control**
 ### 5. Generate Use Cases
 
 Generate the content for `usecase.yml` following the format below.
-**Group by Use Case**, not by Feature.
+**Group by Use Case**, not by Workflow.
 
 **Output Format**:
 ```yaml
@@ -119,13 +119,15 @@ usecases:
 -   Aliases (as) should be short English identifiers (e.g., Host1, LoginUI).
 -   Names should be descriptive in Japanese.
 -   `usecase` key should be empty (null).
+-   **Actor extraction**: Use the `actor` field from workflow steps directly. Actors defined in workflow steps map to the Actor element in Robustness Analysis.
+-   **Entity extraction**: Use the `aggregate` field from workflow steps as candidates for Entity elements.
 
 ### 6. Verification (Self-Correction)
 
 **After generating the initial list of use cases, perform a check:**
-1.  Review `workflow.yml` and ensure **EVERY** feature scenario is referenced in the `trackings` of at least one use case.
-2.  If any feature scenario is missing, create an additional use case to cover it.
-3.  Ensure no "orphan" features are left behind.
+1.  Review `workflow.yml` and ensure **EVERY** workflow is referenced in the `trackings` of at least one use case.
+2.  If any workflow is missing, create an additional use case to cover it.
+3.  Ensure no "orphan" workflows are left behind.
 
 ### 7. File Saving
 - **Determine Output Filename**:
@@ -156,17 +158,36 @@ usecases:
 
 ### Input Example (workflow.yml)
 ```yaml
-feature:
-  - name: 契約管理
-    description: ホストがサービスを利用開始するための契約機能
-    scenarios:
-      - name: サービス契約の申し込みフロー
-        precondition: ホストがサービス利用を希望している
-        steps:
-          - サービス契約画面を開く
-          - 基本情報を入力する
-          - 契約内容を確認し確定する
-        postcondition: 契約が完了し管理アカウントが発行される
+actor:
+  - name: ホスト
+    description: スペース掲載者としてサービスを利用するユーザー
+
+aggregate:
+  - 契約
+  - ホストアカウント
+
+workflow:
+  - name: サービス契約の申し込みフロー
+    description: ホストがサービスを利用開始するための契約申し込みフロー
+    trigger: ホストがサービス利用を希望する
+    precondition: ホストがサービス利用を希望している
+    steps:
+      - actor: ホスト
+        activity: サービス契約画面を開く
+        aggregate: 契約
+      - actor: ホスト
+        activity: 基本情報を入力する
+        aggregate: 契約
+      - actor: ホスト
+        activity: 契約内容を確認し確定する
+        aggregate: 契約
+        event: 契約が作成された
+      - actor: system
+        activity: 管理アカウントを発行する
+        aggregate: ホストアカウント
+        event: アカウントが発行された
+        policy: アカウント自動発行ポリシー
+    postcondition: 契約が完了し管理アカウントが発行される
 ```
 
 ### Output Example (usecase.yml)