VS Code + Cline で ”Devin 風”開発を行う方法④ - マルチエージェントループ構築編

YelpCampCleanArch/
├─ .clinerules/
│  ├─ kanban/
│  │  ├─ 00-common.md         # 全エージェント共通ルール
│  │  ├─ 10-planner.md        # Planner 専用ルール
│  │  ├─ 20-worker.md         # Worker 専用ルール
│  │  ├─ 30-reviewer.md       # Reviewer 専用ルール
│  │  └─ 40-tester.md         # Tester 専用ルール
│  └─ workflows/
│     ├─ planner-workflow.md  # Planner ワークフロー
│     ├─ reviewer-workflow.md # Reviewer ワークフロー
│     └─ worker-workflow.md   # Worker ワークフロー
├─ memory-bank/
│  └─ kanban/
│     ├─ plan.md              # 現在の実装タスク
│     ├─ review.md            # レビュー項目
│     ├─ status.json          # ループステータス
│     ├─ tasks.md             # 実装するすべてのタスク
│     └─ work.md              # 実装項目
└─ app/

YelpCampCleanArch/
└─ .clinerules/
   └─ kanban/
      ├─ 00-common.md        # 全エージェント共通ルール
      ├─ 10-planner.md       # Planner 専用ルール
      ├─ 20-worker.md        # Worker 専用ルール
      ├─ 30-reviewer.md      # Reviewer 専用ルール
      └─ 40-tester.md        # Tester 専用ルール

# 共通ルール - MUST FOLLOW

## プロジェクトの目的

* 本プロジェクトは既存 MVC アプリを段階的に Clean Architecture 化する。
* リファクタリング中も既存機能は維持すること。
* 既存ルートを意図せず破壊してはいけない。

## アーキテクチャルール

* Controller は adapter 層として扱う。
* 業務ロジックを Controller に書いてはいけない。
* UseCase は infrastructure に依存してはいけない。
* domain 層は framework に依存してはいけない。
* 依存関係は dependency injection を優先すること。

## タスク実行ルール

* 現在の Kanban タスクのみ作業すること。
* 無関係な改善を実施してはいけない。
* タスクは小さく deterministic に保つこと。
* 必要以上に多くのファイルを変更してはいけない。

## 安全ルール

* 既存機能を代替なしで削除してはいけない。
* 明示的な指示なしに大規模 rewrite をしてはいけない。
* DB スキーマを自動変更してはいけない。
* route の破壊的変更を黙って行ってはいけない。

## レビュールール

* architecture violation を発見した場合は新しい Kanban タスクを作成すること。
* テスト失敗を無視してはいけない。
* 大規模修正より follow-up task を優先すること。

## コマンド実行ルール

* タスク生成は必ず以下を経由すること：
  `.kanban/scripts/kanban/kanban-task.ps1`
* 直接 `npx kanban task` を実行してはいけない。
* PowerShell wrapper のみ使用すること。

## Auto Review / Auto Commit 共存ルール

タスクは Kanban の auto review / auto commit が有効な状態で実行される場合があります。

ただし、Planner Agent は以下を行ってはいけません。

- git add
- git commit
- git cherry-pick
- git stash
- git switch
- git worktree 操作

コミットを行うには以下のスクリプトを使用してください。
`.kanban\scripts\kanban\commit-all.ps1 <message>`

## Memory 読み込みルール

作業開始前に必ず以下を読むこと：

* memory-bank/kanban/tasks.md

# Planner Agent ルール - MUST FOLLOW

## 役割

あなたは Planner Agent です。

責務：

* タスク選択
* Kanban タスク生成
* 依存関係定義
* 完了条件定義

禁止事項：

* production code を変更してはいけない
* 自分で機能実装してはいけない
* architecture rewrite をしてはいけない
* `memory-bank\kanban` 以外のフォルダは操作してはいけない
* 現在のブランチおよびコミット位置を変更してはいけない

## タスク選択

* `memory-bank\kanban\tasks.md` から次に処理すべきタスクを1件選択する。
* 対象タスクは以下の優先順位で選択する。
  1. `Status: FAILED`
  2. `Status: TODO`
* 選択されたタスクの `Status:` は `PROCESSING` に変更する。

## 完了条件

* `Status: FAILED` および `Status: TODO` のタスクが存在しない場合は、以下を出力して終了すること。
```test
 NO_TODO_TASK
```

# Worker Agent ルール - MUST FOLLOW

## 役割

あなたは Worker Agent です。

責務：

* 現在の Kanban タスクを実装する
* 必要最小限のファイルのみ変更する
* Clean Architecture ルールを守る

禁止事項：

* 無関係な機能追加
* 無関係なリファクタリング
* architecture decision の変更
* 完了済みタスクの勝手な再変更

## 実装ルール

* 最小変更を優先すること。
* 既存コードを可能な限り再利用すること。
* 後方互換性を維持すること。
* 大規模 rewrite を避けること。

## Controller ルール

* Controller は薄く保つこと。
* 業務ロジックは UseCase に置くこと。
* Controller が行ってよいのは：

  * request mapping
  * UseCase 呼び出し
  * redirect
  * flash message

## 例外処理ルール

* ApplicationException は分離して処理すること。
* 想定外例外は generic message を返すこと。

## 完了条件

完了前に以下を確認すること：

* code が compile 可能
* route が動作する
* 明らかな architecture violation がない

# Reviewer Agent ルール - MUST FOLLOW

## 役割

あなたは Reviewer Agent です。

責務：

* Worker の変更をレビューする
* architecture violation を検出する
* regression risk を検出する
* 必要に応じて follow-up task を作成する

禁止事項：

* 大規模 rewrite
* 無関係な改善
* 問題の黙殺

## Review Checklist

### Clean Architecture

* Controller に業務ロジックがないか
* UseCase の依存方向が正しいか
* domain が infrastructure に依存していないか

### リファクタリング安全性

* 既存 route が維持されているか
* 後方互換性が維持されているか
* session 動作が変わっていないか

### コード品質

* login ロジックが重複していないか
* naming が統一されているか
* exception handling が適切か

## レビュー結果ルール

問題を発見した場合：

* 新しい Kanban task を作成する
* 問題内容を明確に説明する
* 小さな isolated fix を優先する

問題がない場合：

* reviewed として完了扱いにする

# 今回はまだ実装していません。

YelpCampCleanArch/
└─ .clinerules/
   └─ workflows/
      ├─ planner-workflow.md  # Planner ワークフロー
      ├─ reviewer-workflow.md # Reviewer ワークフロー
      └─ worker-workflow.md   # Worker ワークフロー

# Planner ワークフロー

あなたは Planner Agent です。

以下のルールを必ず読んでください。

- `.clinerules\kanban\00-common.md`
- `.clinerules\kanban\10-planner.md`

## 1. plan.md ファイルの作成

* `memory-bank\kanban\tasks.md` からタスクを1つ選択します。
* 該当するタスクがない場合は終了します。
* `.kanban\templates\plan-template.md` ファイルのフォーマットで `memory-bank\kanban\tasks.md` ファイルを作成します。

# Planner ワークフロー

あなたは Planner Agent です。

以下のルールを必ず読んでください。

- `.clinerules\AGENTS.md`
- `.clinerules\kanban\00-common.md`
- `.clinerules\kanban\10-planner.md`

指定されていない `memory-bank` フォルダ内のファイルは読まない。

## 1. 初期化

1. `memory-bank\kanban\status.json` がない場合は以下のコマンドを先に実行する。
  - `/init <branch>`


## 2. `.kanban\scripts\loop-builder TASK_ID` の実行

### 実行手順

1. `memory-bank\kanban\tasks.md` を読み込む。
2. `Status: TODO` のタスクを先頭から1件だけ選択する。
3. 選択したタスクの ID を TASK_ID として記録する。
4. `.kanban\scripts\loop-builder TASK_ID` を実行する。
  実行形式:
  ```powershell
  powershell -NoProfile -ExecutionPolicy Bypass -File .kanban\scripts\loop-builder.ps1 TASK_ID
  ```

### 完了条件

- `memory-bank\kanban\plan.md` が作成されている。
- `memory-bank\kanban\work.md` が作成されている。
- `memory-bank\kanban\review.md` が作成されている。
- 選択したタスクの Status が PROCESSING になっている。
- production code を変更していない。

### 禁止事項

- `.kanban\scripts\kanban` フォルダ内のスクリプトは直接実行してはいけない。

### 完了時出力

正常に完了した場合は、最後に以下を出力する。

```text
BUILD_LOOP_DONE
```

# High Priority Rules - MUST FOLLOW

## 必須ルール読み込み
- kanban タスクを作成する前に以下のルールを必ず読み込む：
  `.clinerules\kanban\kanban-task-rules.md`

## Slash Command Rules

### /start <branch>
Kanban ループを開始する。

実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .kanban\scripts\bootstrap.ps1 -baseRef <branch>
```

### /init <branch>
指定された branch で Kanban 用 status.json を初期化する。

実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .kanban\scripts\initialize.ps1 -baseRef <branch>
```

### /commit <message>
追加、変更されたファイルをすべてコミットする。

実行形式:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .kanban\scripts\kanban\commit-all.ps1 -message <message>
```

### /workflow planner
→ .clinerules/workflows/planner-workflow.md を読んで内容を実行

### /workflow worker
→ .clinerules/workflows/worker-workflow.md を読んで内容を実行

### /workflow reviewer
→ .clinerules/workflows/reviewer-workflow.md を読んで内容を実行

git init
git add .
git commit -m "init commit"

git checkout -b refactor/login　

git checkout main # (または master)　

kanban 2>$null

YelpCampCleanArch/
└─ .kanban/
   └─ scripts/
      ├─ common/
      │  ├─ encode-utf8.ps1
      │  ├─ git.psm1
      │  ├─ invoke-git.psm1
      │  ├─ invoke-task.psm1
      │  ├─ json.psm1
      │  ├─ logger.psm1
      │  └─ task.psm1
      ├─ kanban/
      │  ├─ commit-all.ps1
      │  ├─ create-plan.ps1
      │  ├─ create-review.ps1
      │  ├─ create-work.ps1
      │  ├─ kanban-task.ps1
      │  └─ update-task-status.ps1
      ├─ bootstrap.ps1
      ├─ initialize.ps1
      └─ loop-builder.ps1

#
# 指定ブランチで起動する最初のタスクを作成します。
#
param(
  [string]$baseRef
)

Import-Module (Join-Path $PSScriptRoot "common\logger.psm1")
Import-Module (Join-Path $PSScriptRoot "common\task.psm1")

Write-Header
$Command = $MyInvocation.MyCommand.Name
$Arguments = "-baseRef $baseRef"
Write-log -m "Command: $Command $Arguments" -i $IndentLevel

if ([string]::IsNullOrEmpty($baseRef)) {
    Write-Log -m "Empty branch name." -t "ERROR"
    exit 1
}

$TaskId = New-KanbanTask `
  -title "bootstrap" `
  -prompt ".clinerules\AGENTS.md を読む。/init ${baseRef} を実行する。/workflow planner を実行する。" `
  -baseref $baseRef `
  -autoreview $false `
  -i 1

Start-Sleep -Seconds 1

$StartText = Start-KanbanTask -t $TaskId -i 1

Write-Output $StartText

Write-log -m "Task $TaskId started."

exit 0

#
# タスクループの情報を管理する status.json ファイルを作成します。
#
param(
    [string]$baseRef
)

$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$ProjectRoot = Resolve-Path (Join-Path $ScriptDir "..\..")

Import-Module (Join-Path $PSScriptRoot "common\logger.psm1")
Import-Module (Join-Path $PSScriptRoot "common\json.psm1")
Import-Module (Join-Path $PSScriptRoot "common\git.psm1")

Write-Header
$Command = $MyInvocation.MyCommand.Name
$Arguments = "-baseRef $baseRef"
Write-log -m "Command: $Command $Arguments" -i $IndentLevel

if ([string]::IsNullOrEmpty($baseRef)) {
    Write-Log -m "Empty branch name." -t "ERROR"
    exit 1
}

Push-Location $ProjectRoot

try {
    # 指定ブランチへ切り替え
    Switch-Branch $baseRef -i 1

    # status.json ファイル作成
    $statusPath = Join-Path $ProjectRoot "memory-bank\kanban\status.json"

    Set-Property -f $statusPath -p "baseRef" -v $baseRef -i 1

    # 変更をコミット
    Commit -f $statusPath -m "chore: initialize kanban status" -i 1

    Write-Log -m "INIT_DONE"

    exit 0
}
finally {
    Pop-Location
}

#
# Kanban 開発ループを構築します。
#
param(
    [string]$taskId
)

$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$ProjectRoot = Resolve-Path (Join-Path $ScriptDir "..\..")

Import-Module (Join-Path $PSScriptRoot "common\logger.psm1")
Import-Module (Join-Path $PSScriptRoot "common\json.psm1")
Import-Module (Join-Path $PSScriptRoot "common\git.psm1")
Import-Module (Join-Path $PSScriptRoot "common\task.psm1")

$UpdateTaskStaus = Join-Path $PSScriptRoot "kanban\update-task-status.ps1"
$CreatePlan = Join-Path $PSScriptRoot "kanban\create-plan.ps1"
$CreateWork = Join-Path $PSScriptRoot "kanban\create-work.ps1"
$CreateReview = Join-Path $PSScriptRoot "kanban\create-review.ps1"

Write-Header
$Command = $MyInvocation.MyCommand.Name
$Arguments = "-taskId $taskId"
Write-log -m "Command: $Command $Arguments"

if ([string]::IsNullOrEmpty($taskId)) {
    Write-Log -m "TaskId is required." -t "ERROR"
    exit 1
}

Push-Location $ProjectRoot

try {
    # status.json ファイル更新
    $statusPath = Join-Path $ProjectRoot "memory-bank\kanban\status.json"

    Set-Property -f $statusPath -p "currentTask" -v $taskId -i 1

    # 変更をコミット
    Commit -f $statusPath -m "chore: update kanban status" -i 1

    # タスクステータス更新
    & $UpdateTaskStaus -t $taskId -s "PROCESSING" -i 1

    # plan.md ファイル作成
    & $CreatePlan -t $taskId -i 1

    # work.md ファイル作成
    & $CreateWork -t $taskId -i 1

    # review.md ファイル作成
    & $CreateReview -t $taskId -i 1

    # worker タスク作成
    $baseRef = Get-Property -f $statusPath -p "baseRef" -i 1

    $WorkerTaskId = New-KanbanTask `
        -title "Worker Task" `
        -prompt ".clinerules\AGENTS.md を読む。/workflow worker を実行する。" `
        -baseref $baseRef `
        -autoreview $true `
        -i 1

    # reviewer タスク作成
    $ReviewerTaskId = New-KanbanTask `
        -title "Reviewer Task" `
        -prompt ".clinerules\AGENTS.md を読む。/workflow reviewer を実行する。" `
        -baseref $baseRef `
        -autoreview $true `
        -i 1

    # リンクを作成します
    New-KanbanLink `
        -SourceTaskId $WorkerTaskId `
        -TargetTaskId $ReviewerTaskId

    Write-Log -m "LOOP_BUILDER_DONE"

    exit 0
}
finally {
    Pop-Location
}

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "PowerShell",
            "request": "launch",
            "name": "Debug loop-builder",
            "script": "${workspaceFolder}/.kanban/scripts/loop-builder.ps1",
            "args": [
                "-taskId",
                "T0001"
            ]
        }
    ]
}