@einja/dev-cli 0.1.39 → 0.1.41

package/presets/default/docs/einja/instructions/task-vibe-kanban-loop.md

@@ -1,565 +0,0 @@
-<!-- @einja:managed:start -->
-# `pnpm task:loop` コマンド
-
-## 概要
-
-GitHub Issue からタスクを自動選定し、Vibe-Kanban に登録して連続実行する npm スクリプト。
-
-**⚠️ 重要**: 着手可能なタスクを全て並列で Doing に移し、Done 状態の変化を監視して次のタスクを開始するループ処理。
-
-**親Issue/サブIssue 構造**: Phase ごとに Vibe-Kanban 上で **親Issue** を作成し、着手可能なタスクグループは親Issueの配下に **サブIssue** として登録します。Phase内の全サブIssueが完了すると、PR作成・マージを経て親Issueが自動でDoneになります。
-
----
-
-## 使用方法
-
-### 事前準備（初回のみ）
-
-```bash
-# 1. 仕様書を作成（requirements.md, design.md, GitHub Issue へのタスク記述）
-/einja:spec-create <タスク内容の説明>
-
-# 一旦ここまで終わったらDiscordでスレッドを作りチームにレビュー依頼
-
-# 2. Vibe-Kanban を起動（別ターミナルで実行）
-npx vibe-kanban
-# → ブラウザが自動で開き、Kanbanボードが表示される
-# → このボードで PR作成・レビュー・マージ操作を行う
-```
-
-### コマンド実行
-
-```bash
-# 基本
-pnpm task:loop <issue-number>
-
-# 実行後、specで作成されたタスクが勝手に着手可能なものから実行開始されていくので、
-# vibe-kanbanの画面を眺めて終わったものから自己レビュー、OKならPR作成ボタンでPR作成、チームのレビュー後、
-# PRがマージされると自動で次のタスクが始まる（ちょっとラグあり）
-
-# オプション指定
-pnpm task:loop <issue-number> --max-group <number> --branch <branch>
-
-# 例
-pnpm task:loop 123                        # Issue #123 の全タスクを実行
-pnpm task:loop 123 --max-group 4          # Phase 4 まで実行
-pnpm task:loop 123 --max-group 4.2        # タスクグループ 4.2 まで実行
-pnpm task:loop 123 --branch develop       # develop ブランチベースで実行
-
-# ヘルプ
-pnpm task:loop --help
-```
-
-### Vibe-Kanban 画面での操作
-
-`npx vibe-kanban` で開いたボードで以下の操作を行います：
-
-| 操作 | タイミング | 説明 |
-|------|-----------|------|
-| **タスク進捗確認** | 随時 | Todo → In Progress → In Review → Done の流れを確認 |
-| **Create PR** | In Review 時 | ボタンをクリックして PR を自動作成 |
-| **レビュー** | PR 作成後 | GitHub で PR の内容を確認 |
-| **マージ** | レビュー完了後 | GitHub で PR をマージ（⚠️ 必ず GitHub 側で操作） |
-
-**⚠️ 重要**: PR のマージは必ず GitHub 側で行ってください。マージを検知して Vibe-Kanban のタスクが自動で Done になります。
-
----
-
-## ブランチ階層
-
-```
-main (デフォルト)
-  └── issue/17                  ← main から作成
-       ├── issue/17-phase1      ← issue/17 から作成
-       ├── issue/17-phase2      ← issue/17 から作成
-       └── issue/17-phase3      ← issue/17 から作成
-            └── (作業ブランチ)   ← Vibe-Kanban が自動作成
-```
-
-- **main**: プロダクションブランチ
-- **issue/N**: Issue 単位のブランチ（`--branch` で変更可能）
-- **issue/N-phaseM**: Phase 単位のブランチ、タスクグループの作業ベース
-
----
-
-## 開発手順（ステップバイステップ）
-
-### 事前準備チェックリスト
-
-- [ ] `npx @einja/dev-cli init` 実行済み（`pnpm task:loop` コマンドが使用可能）
-- [ ] Docker が起動している
-- [ ] `pnpm install` 済み
-- [ ] Vibe-Kanban にプロジェクトが登録されている（後述）
-- [ ] GitHub Issue にタスク一覧が記載されている
-
-### Step 1: Vibe-Kanban を起動
-
-```bash
-npx vibe-kanban
-```
-
-ブラウザが自動で開きます。このボードでタスクの進捗を確認します。
-
-### Step 2: プロジェクト登録（初回のみ）
-
-Vibe-Kanban にこのプロジェクトが登録されていない場合：
-
-1. ブラウザで Projects ページを開く
-2. 「Create project」ボタンをクリック
-3. Git Repository Path にプロジェクトのパスを入力
-   ```
-   /Users/yourname/path/to/your-project
-   ```
-4. 保存
-
-### Step 3: タスクループを開始
-
-```bash
-pnpm task:loop <issue-number>
-
-# 例: Issue #17 の全タスクを実行
-pnpm task:loop 17
-```
-
-コマンド実行後：
-- 着手可能なタスクが自動で Vibe-Kanban に登録される
-- 各タスクが並列で実行開始される
-- 15秒ごとに進捗をポーリング
-
-### Step 4: タスク進捗の確認
-
-`npx vibe-kanban` で開いたボードでタスクの状態を確認：
-
-| 状態 | 意味 |
-|------|------|
-| **Todo** | 未着手 |
-| **In Progress** | 実行中（Claude Code が作業中） |
-| **In Review** | レビュー待ち（PR作成が必要） |
-| **Done** | 完了 |
-
-### Step 5: In Review 状態の対応
-
-タスクが **In Review** になったら：
-
-1. **Vibe-Kanban で「Create PR」ボタンをクリック**
-   - PR が自動作成される
-
-2. **GitHub で PR をレビュー**
-   - コードを確認
-   - 必要に応じて修正を依頼
-
-3. **修正が必要な場合**
-   - PR にコメントを残す
-   - または Vibe-Kanban で「Request Changes」
-
-4. **レビュー完了後、GitHub で PR をマージ**
-   - ⚠️ **必ず GitHub 側でマージすること**（Vibe-Kanban からはマージしない）
-
-### Step 6: マージ後の自動処理
-
-PR をマージすると：
-
-1. Vibe-Kanban がマージを検知
-2. タスクが自動で **Done** に変更
-3. `pnpm task:loop` がこれを検知
-4. GitHub Issue のチェックボックスが自動で `[x]` に更新
-5. **Phase 内の全タスクが完了した場合、Phase ブランチを Issue ブランチに自動マージ**
-6. 新たに着手可能になったタスクが自動で開始
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  PR マージ（サブIssue分）                                   │
-│      ↓                                                      │
-│  Vibe-Kanban: タスク → Done（自動）                        │
-│      ↓                                                      │
-│  task:loop: Done 検知                                       │
-│      ↓                                                      │
-│  GitHub Issue: チェックボックス更新（自動）                 │
-│      ↓                                                      │
-│  Phase 全タスク（サブIssue）完了？                         │
-│      ├─ Yes → 親Issue用Workspace作成                        │
-│      │         → PR作成・マージ（Phase → Issue ブランチ）  │
-│      │         → 親Issue 自動Done（タイムアウト2分でフォールバック）│
-│      └─ No  → スキップ                                      │
-│      ↓                                                      │
-│  次のタスクが自動開始                                       │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Step 7: 全タスク完了
-
-すべてのタスクが Done になると：
-
-```
-🎉 すべてのタスクが完了しました！
-✅ タスク自動実行ループ終了
-```
-
----
-
-## トラブルシューティング
-
-### プロジェクトが見つからないエラー
-
-```
-❌ プロジェクトが Vibe-Kanban に登録されていません
-```
-
-**対処法**: Step 2 の手順でプロジェクトを登録してください。
-
-### タスクが In Review のまま進まない
-
-**原因**: PR がマージされていない
-
-**対処法**:
-1. Vibe-Kanban で「Create PR」をクリック
-2. GitHub で PR をレビュー・マージ
-
-### タスクが Done にならない
-
-**原因**: GitHub 側でマージしていない（Vibe-Kanban 上で手動で Done にした）
-
-**対処法**: 必ず GitHub の PR をマージしてください。マージを検知して自動で Done になります。
-
----
-
-## 処理フロー
-
-### アクター凡例
-
-| アクター | 説明 | 操作種別 |
-|---------|------|---------|
-| 👤 **ユーザー** | 開発者（あなた） | 手動 |
-| 🔄 **task:loop** | `pnpm task:loop` コマンド | 自動 |
-| 🤖 **Claude Code** | Vibe-Kanban が起動する AI エージェント | 自動 |
-| 📋 **Vibe-Kanban** | タスク管理ボード | 自動 |
-| 🐙 **GitHub** | Issue / PR | - |
-
-### フロー図
-
-```mermaid
-graph TD
-    subgraph User ["👤 ユーザー（手動）"]
-        U1([pnpm task:loop 実行])
-        U2[Vibe-Kanban で<br/>PR作成ボタンクリック]
-        U3[GitHub で<br/>PRレビュー・マージ]
-    end
-
-    subgraph TaskLoop ["🔄 task:loop（自動）"]
-        T1[Issue取得・解析]
-        T2[ブランチ作成]
-        T3[Vibe-Kanban 接続]
-        T3a[Phase毎に親Issue作成]
-        T4[サブIssue作成・開始指示]
-        T5[15秒ポーリング]
-        T6{Done検知?<br/>※親Issue除外}
-        T7[GitHub Issue<br/>チェックボックス更新]
-        T8[次のタスク開始指示]
-        T9{全完了?}
-        T10([ループ終了])
-    end
-
-    subgraph Claude ["🤖 Claude Code（自動）"]
-        C1[コード実装]
-        C2[テスト実行]
-        C3[コミット・プッシュ]
-        C4[作業完了報告]
-    end
-
-    subgraph VibeKanban ["📋 Vibe-Kanban（自動）"]
-        V1[タスク状態管理]
-        V2[Claude Code 起動]
-        V3[PRマージ検知]
-        V4[タスク → Done]
-    end
-
-    subgraph GitHub ["🐙 GitHub"]
-        G1[Issue]
-        G2[PR]
-    end
-
-    U1 --> T1
-    T1 --> T2
-    T2 --> T3
-    T3 --> T3a
-    T3a --> T4
-    T4 --> V1
-    V1 --> V2
-    V2 --> C1
-    C1 --> C2
-    C2 --> C3
-    C3 --> C4
-    C4 --> V1
-
-    T4 --> T5
-    T5 --> T6
-    T6 -->|No| T9
-    T6 -->|Yes| T7
-    T7 --> G1
-    T7 --> T8
-    T8 --> T9
-    T9 -->|No| T5
-    T9 -->|Yes| T10
-
-    V1 -->|In Review| U2
-    U2 --> G2
-    G2 --> U3
-    U3 --> V3
-    V3 --> V4
-    V4 --> T6
-
-    style U1 fill:#e3f2fd
-    style U2 fill:#e3f2fd
-    style U3 fill:#e3f2fd
-    style T10 fill:#4caf50,color:#fff
-```
-
-### シーケンス図
-
-```mermaid
-sequenceDiagram
-    box rgb(227, 242, 253) 手動操作
-        participant User as 👤 ユーザー
-    end
-    box rgb(232, 245, 233) 自動処理
-        participant Script as 🔄 task:loop
-        participant Vibe as 📋 Vibe-Kanban
-        participant Claude as 🤖 Claude Code
-    end
-    box rgb(255, 243, 224) 外部サービス
-        participant GitHub as 🐙 GitHub
-    end
-
-    Note over User: 【開始】
-    User->>Script: pnpm task:loop 123
-
-    Note over Script: 【初期化フェーズ】
-    Script->>GitHub: Issue 取得・解析
-    Script->>Script: ブランチ作成（issue/123, issue/123-phase1...）
-    Script->>Vibe: MCP 接続
-    Script->>Script: REST API ヘルスチェック（probeCapability）
-    Script->>Vibe: Phase毎に親Issue作成（MCP create_issue）
-
-    Note over Script: 【サブIssue開始】
-    Script->>Script: 着手可能タスク選定
-    Script->>Vibe: サブIssue作成（MCP create_issue + REST PATCH parent_issue_id）
-    Script->>Vibe: start_task_attempt（実行開始指示）
-    Vibe->>Claude: Claude Code 起動
-
-    Note over Claude: 【タスク実行】
-    Claude->>Claude: コード実装
-    Claude->>Claude: テスト実行
-    Claude->>GitHub: コミット・プッシュ
-    Claude->>Vibe: 作業完了報告
-    Vibe->>Vibe: ステータス → In Review
-
-    Note over User: 【レビューフェーズ】
-    User->>Vibe: 「Create PR」ボタンクリック
-    Vibe->>GitHub: PR 作成
-    User->>GitHub: PR レビュー
-    User->>GitHub: PR マージ
-
-    Note over Vibe: 【自動検知】
-    Vibe->>Vibe: PR マージ検知
-    Vibe->>Vibe: ステータス → Done
-
-    Note over Script: 【ポーリング検知】
-    loop 15秒ごと
-        Script->>Vibe: タスク状態取得（親Issue除外）
-        alt Done 増加検知（サブIssue）
-            Script->>GitHub: Issue チェックボックス更新
-            alt Phase内全サブIssue完了
-                Script->>Vibe: 親Issue用Workspace作成
-                Script->>GitHub: PR作成・マージ（Phase→Issue）
-                Note over Vibe: PRマージ検知 → 親Issue自動Done<br/>（タイムアウト2分でフォールバック）
-            end
-            Script->>Script: 新たに着手可能なタスク選定
-            Script->>Vibe: 次のサブIssue作成・開始
-            Vibe->>Claude: Claude Code 起動（次タスク）
-        end
-    end
-
-    Note over Script: 【完了】
-    Script->>Vibe: MCP 切断
-    Script->>User: 🎉 全タスク完了
-```
-
-### 操作主体の一覧
-
-| フェーズ | 操作 | 主体 |
-|---------|------|------|
-| 開始 | `pnpm task:loop` 実行 | 👤 ユーザー |
-| 初期化 | Issue 取得、ブランチ作成 | 🔄 task:loop |
-| 初期化 | Vibe-Kanban 接続 | 🔄 task:loop |
-| Phase初期化 | Phase毎に親Issue作成 | 🔄 task:loop |
-| タスク開始 | サブIssue作成・開始指示（parent_issue_id設定） | 🔄 task:loop |
-| タスク開始 | Claude Code 起動 | 📋 Vibe-Kanban |
-| 実装 | コード実装、テスト、コミット | 🤖 Claude Code |
-| 実装 | 作業完了報告 | 🤖 Claude Code |
-| レビュー | 「Create PR」クリック | 👤 ユーザー |
-| レビュー | PR 作成 | 📋 Vibe-Kanban |
-| レビュー | PR レビュー・マージ | 👤 ユーザー |
-| 検知 | PR マージ検知 → Done | 📋 Vibe-Kanban |
-| 検知 | Done 検知 | 🔄 task:loop |
-| 更新 | Issue チェックボックス更新 | 🔄 task:loop |
-| 次タスク | 次のタスク開始指示 | 🔄 task:loop |
-| 終了 | MCP 切断、完了通知 | 🔄 task:loop |
-
----
-
-## 各フェーズの概要
-
-### 1. 初期化フェーズ（1回のみ）
-
-- 引数解析（Issue番号、最大タスク番号、ベースブランチ）
-- GitHub Issue 取得・Markdown パース
-- Issue ブランチ作成: `issue/{issue_number}`
-- Phase ブランチ作成: `issue/{issue_number}-phase{N}`
-- Vibe-Kanban MCP 接続（以降使い回し）
-- プロジェクト ID 取得
-- REST API ヘルスチェック（probeCapability）
-- **Phase ごとに親Issue作成**: タイトル形式 `[Issue{N} Phase{M}] {Phase名}`
-
-### 2. 初期サブIssue開始
-
-- 依存関係を考慮して着手可能なタスクグループを全て選定
-- Vibe-Kanban に**サブIssueとして作成**（MCP create_issue + REST PATCH で parent_issue_id 設定）
-  - PATCH 失敗時はリトライ3回 → 全失敗時は MCP delete_issue で削除して再スロー
-- `start_task_attempt` で実行開始
-
-### 3. メインループ（15秒ポーリング）
-
-- Vibe-Kanban のタスク状態を取得（**親IssueをIDベースで除外**してサブIssueのみ対象）
-- Done 増加を検知した場合:
-  - GitHub Issue のチェックボックスを `- [x]` に更新
-  - **Phase 内の全サブIssueが完了していれば**:
-    1. 親Issue用Workspace作成（target = issue/N）
-    2. PR作成・自動マージ（Phase ブランチ → Issue ブランチ）
-    3. Vibe-KanbanがPRマージ検知 → 親Issue自動Done
-    4. タイムアウト（2分）時は手動Done更新（フォールバック）
-  - 新たに着手可能になったタスクを開始
-- 全タスク完了で終了
-
-### 4. 終了処理
-
-- Vibe-Kanban MCP 切断
-
----
-
-## Vibe-Kanban セットアップ
-
-### 前提条件
-
-✅ このプロジェクトでは既に設定済み（`.mcp.json`）
-
-### セットアップ手順
-
-1. **アプリケーション起動**
-   ```bash
-   npx vibe-kanban
-   ```
-
-2. **プロジェクト確認**
-   - ブラウザでKanbanボード表示
-   - プロジェクトが登録されていることを確認
-
----
-
-## `/einja:task-exec` との使い分け
-
-| コマンド | 用途 | 品質保証 | 推奨シーン |
-|---------|------|---------|----------|
-| **`/einja:task-exec`** | 重要タスクの確実な完了 | ✅ 合格まで自動ループ | 複雑な実装、品質重視 |
-| **`pnpm task:loop`** | 大量タスクの自動消化 | 並列実行・監視 | 定型作業、並行開発 |
-
----
-
-## 実装詳細
-
-スクリプトは `packages/cli/src/commands/task-loop/` に配置（CLIパッケージに統合）：
-
-```
-packages/cli/src/commands/task-loop/
-├── index.ts                    # エントリポイント（taskLoopCommand関数）
-└── lib/
-    ├── types.ts                # 型定義
-    ├── task-number-utils.ts    # タスク番号比較
-    ├── github-client.ts        # GitHub Issue操作
-    ├── gh-setup.ts             # GitHub CLI セットアップ
-    ├── branch-manager.ts       # Git ブランチ操作
-    ├── conflict-handler.ts     # コンフリクト処理
-    ├── vibe-kanban-client.ts   # MCP経由Vibe-Kanban操作
-    ├── vibe-kanban-rest-client.ts # REST API クライアント（親子関係設定、ヘルスチェック）
-    ├── issue-parser.ts         # Issue Markdownパーサー
-    ├── dependency-resolver.ts  # 依存関係解析
-    ├── project-selector.ts     # プロジェクト選択
-    └── task-state-manager.ts   # タスク状態管理
-```
-
-## Claude Codeプロンプト生成アーキテクチャ
-
-### VK Issue と VK 内部タスクの違い
-
-task:loop は Vibe-Kanban に対して2種類のオブジェクトを作成する。**これらは別物であり、混同しないこと。**
-
-| オブジェクト | 作成API | 用途 | 備考 |
-|-------------|---------|------|------|
-| VK Issue（サブIssue） | `createSubIssue(title, description)` | VK UI上でのタスク表示・管理 | title=`[Issue22 1.2] タスク名` |
-| VK 内部タスク | `start_workspace_session(title)` | Claude Codeセッション起動 | **titleがプロンプトになる** |
-
-### プロンプトの流れ
-
-```
-startTaskAttempt(agentPrompt, executor, repos, issueId)
-    │
-    └─ VK: start_workspace_session(title=agentPrompt)
-         └─ CreateTask(title=agentPrompt, description=None)
-              └─ task.to_prompt() → agentPrompt をそのまま返す
-                   └─ CodingAgentInitialRequest { prompt: agentPrompt }
-                        └─ Claude Code起動
-```
-
-**重要**: `start_workspace_session` には description パラメータがない。内部タスクの description は常に None になるため、**title のみが Claude Code のプロンプトになる**。
-
-### start_workspace_session のパラメータ
-
-| パラメータ | 型 | Claude Codeへの影響 |
-|-----------|-----|-------------------|
-| title | String | **Claude Codeのプロンプトになる** |
-| executor | String | 起動するエージェントの種類 |
-| repos | Array | リポジトリ・ベースブランチ |
-| issue_id | UUID? | Issueとのリンク（プロンプトに影響なし） |
-| variant | String? | エージェントのバリアント |
-
-### プロンプト生成関数
-
-| 関数 | 用途 | 出力先 |
-|------|------|--------|
-| `generateVibeKanbanTitle()` | VK Issue のタイトル | `createSubIssue` の title |
-| `generateVibeKanbanDescription()` | VK Issue の説明文 | `createSubIssue` の description |
-| `generateAgentPrompt()` | Claude Code の初期プロンプト | `startTaskAttempt` の title |
-
-### プロンプト変更時の注意
-
-1. `startTaskAttempt` の第1引数が Claude Code の初期プロンプトになる
-2. `createSubIssue` の title とは別に管理すること（同じ変数を使い回さない）
-3. VK UI の Issue description とは独立（description は UI 表示用のみ）
-
----
-
-## 関連ドキュメント
-
-- [タスク実行ワークフロー](./einja:task-execute.md)
-- [タスク管理ガイドライン](../steering/task-management.md)
-- [仕様書作成ワークフロー](./einja:spec-create.md)
-- [ブランチ運用戦略](../steering/branch-strategy.md) - ブランチ命名規則、同期フロー、ワークフロー図
-<!-- @einja:managed:end -->
-
----
-
-<!-- @einja:seed:start id="task-vibe-kanban-loop-project" -->
-## プロジェクト固有の設定
-
-<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
-<!-- einja syncで上書きされません -->
-<!-- @einja:seed:end -->