Tech Catchup Workflow

---
name: tech-catchup-workflow
description: 対象技術の最新情報を調査し、技術調査レポートを作成する
---

# 技術キャッチアップ・完全ワークフロー

対象技術に関する最新情報を調査し、技術調査レポートを作成する自動化ワークフローです。
基本設計フェーズ前に実行することで、技術選定の精度向上と設計ミスの予防を図ります。

> **使用モデル**: Gemini 3 Flash（コスト効率重視）

## 入力

$ARGUMENTS（対象技術リスト、調査深度など）

### 入力形式

以下の形式で入力を受け付けます：

```
技術: [調査対象技術のリスト（カンマ区切り）]
深度: [quick/standard/deep]（省略時: standard）
要件: [要件定義書のパス（任意）]
目的: [調査の目的・背景（任意）]
```

**入力例:**
```
技術: Next.js 15, Prisma, TanStack Query v5
深度: standard
要件: docs/requirements/REQ-XXX-001_機能名.md
目的: 半年ぶりの技術更新、Breaking Changes確認
```

**簡易入力（技術名のみ）:**
```
React 19, Bun
```

---

## 調査深度の定義

| 深度 | 調査範囲 | 所要時間目安 | 成果物 |
|------|---------|------------|--------|
| **quick** | 最新バージョン・Breaking Changesのみ | 5-10分 | 簡易レポート |
| **standard** | 上記 + 新機能・非推奨・マイグレーション + **実装向け情報** | 15-30分 | 標準レポート |
| **deep** | 上記 + ベストプラクティス・エコシステム動向・競合比較 | 30-60分 | 詳細レポート |

### standard以上で含まれる実装向け情報

| 項目 | 内容 |
|------|------|
| **インストール方法** | パッケージマネージャー別のインストールコマンド |
| **基本的な使い方** | 最小構成のコード例（コピペで動く） |
| **参照リンク集** | 公式ドキュメント、GitHub、APIリファレンス等 |
| **よくあるエラーと対処** | 初期セットアップで躓きやすいポイント |

---

## 全体フロー

| Phase | 名称 | 内容 |
|-------|------|------|
| 0 | 入力解析 | 技術リスト・深度・目的の解析 |
| 0.5 | コンテキスト確認 | 既存バージョン確認、重複調査防止 |
| 1 | 調査対象特定 | 優先度付け、スキップ判定 |
| 2 | 最新情報収集 | librarianエージェントによる調査 |
| 2.5 | ユーザー確認 | 調査結果の確認・承認 |
| 3 | レポート作成 | 技術調査レポート生成 |
| 4 | 引き継ぎ | 基本設計への引き継ぎ情報出力 |

> **Phase規約**: `workflow-phase-convention` skill を参照

---

## 実行プロセス

### Phase 0: 入力解析

入力引数から以下を抽出：
- 調査対象技術リスト
- 調査深度（quick/standard/deep）
- 要件定義書パス（任意）
- 調査目的（任意）

---

### Phase 0.5: コンテキスト確認

**実行内容:**
1. 既存プロジェクトの `package.json` / `Cargo.toml` 等から現行バージョンを確認
2. 直近30日以内に同一技術の調査レポートが存在するか確認
3. 調査の重複を防止

**スキップ条件:**
- 直近30日以内に同一技術の調査レポートが存在 → ユーザーに確認

---

### Phase 1: 調査対象の特定と優先度付け

**実行内容:**
1. 入力から調査対象技術を抽出
2. 要件定義書が指定されている場合、追加の技術キーワードを抽出
3. 調査優先度を決定

**優先度判定基準:**

| 優先度 | 条件 | 例 |
|--------|------|-----|
| 高 | メジャーバージョン差あり | Next.js 13 → 15 |
| 高 | 未使用技術（新規導入） | 初めてのRust |
| 中 | マイナーバージョン差あり | React 18.2 → 18.3 |
| 中 | 1年以上触れていない | 久しぶりのDocker |
| 低 | 現行最新、日常的に使用 | 毎日使うTypeScript |

**スキップ条件:**
- 全技術が「低」優先度 かつ ユーザーが明示的にスキップを許可

---

### Phase 2: 最新情報収集

**librarianエージェントを起動して調査（深度に応じた情報を収集）:**

> **実装方法**: 
> - `call_omo_agent` でバックグラウンド実行
> - 使用ツール: `websearch_exa`, `context7_query-docs`
>
> **⚠️ 制約（調査深度による差分）**:
> - **quick**: 公式サイトのメタデータ（バージョン、日付、URL）のみ取得
> - **standard以上**: インストール手順・基本的な使い方・コード例も調査
> - リポジトリへのダウンロード・ビルドは一切行わない

1. **基本情報確認**
   - 最新バージョン番号とリリース日
   - 公式ドキュメントURL
   - 概要（1-2行）

2. **詳細調査（standard以上で実施）**
   - インストールコマンド（npm/yarn/pnpm等）
   - 基本的な使い方（最小構成のコード例）
   - マイグレーションガイド（メジャーバージョン差がある場合）
   - よくあるエラーと対処法

**調査ソース:**
- 公式ドキュメント（最優先）
- GitHub Releases / Changelog
- 公式ブログ
- RFC / Proposal（deep のみ）
- 公式Getting Started / Quickstart（standard以上）
- 公式Examples / Tutorials（standard以上）

---

### Phase 2.5: ユーザー確認

調査結果のサマリーを提示し、承認を得る。

> **共通仕様**: `approval-gate` skill を参照

| 選択肢 | アクション |
|--------|----------|
| `1` | Phase 3（レポート作成）へ |
| `2` | 追加の技術を指定して Phase 2 に戻る |
| `3` | 調査を中止 |

> 番号を選択してください（1-3）:

---

### Phase 3: 技術調査レポート作成

**出力先:**
- **単体調査時**: `docs/research/TECH-[カテゴリ]-[連番]_[技術名].md`
- **複数調査時**: `docs/research/TECH-REPORT-[YYYYMMDD]_Combined.md`（統合レポート）
  > **Note**: 大量ファイル生成を防ぐため、複数技術の調査時は1つのMarkdownファイルに統合します。

**カテゴリ定義:**

| カテゴリ | 対象 |
|---------|------|
| FE | フロントエンドフレームワーク・ライブラリ |
| BE | バックエンドフレームワーク・ライブラリ |
| DB | データベース・ORM |
| INFRA | インフラ・DevOps・コンテナ |
| LANG | プログラミング言語・ランタイム |
| TOOL | 開発ツール・ビルドツール |

**レポート構成（standard以上）:**

```markdown
# 技術調査レポート: [技術名]

| 項目 | 内容 |
|------|------|
| 調査日 | YYYY-MM-DD |
| 最新バージョン | vX.Y.Z |
| 調査深度 | standard / deep |

## 参照リンク（公式）
- **公式ドキュメント**: [URL]
- **GitHubリポジトリ**: [URL]
- **Getting Started**: [URL]

## 技術概要
[1-2行で記載]

## インストール方法

### npm
```bash
npm install [package-name]
```

### yarn
```bash
yarn add [package-name]
```

### pnpm
```bash
pnpm add [package-name]
```

## 基本的な使い方

### 最小構成例
```typescript
// コピペで動く最小構成のコード例
```

### 主要なAPI/関数
| API/関数 | 説明 |
|----------|------|
| `xxx()` | 説明 |
| `yyy()` | 説明 |

## よくあるエラーと対処

| エラー | 原因 | 対処法 |
|--------|------|--------|
| Error: xxx | 原因の説明 | 対処法 |

## メモ
[必要に応じて追記]
```

**レポート構成（quick - 参照インデックス版）:**

```markdown
# 技術調査レポート: [技術名]

| 項目 | 内容 |
|------|------|
| 調査日 | YYYY-MM-DD |
| 最新バージョン | vX.Y.Z |

## 参照リンク（公式）
- **公式ドキュメント**: [URL]
- **GitHubリポジトリ**: [URL]

## 技術概要
[LLMの知識ベースに基づいて1-2行で記載]

## メモ
[必要に応じて追記]
```

---

### Phase 4: 基本設計への引き継ぎ

**実行内容:**

1. **完了報告の生成**
   - 調査結果一覧（技術名、現行→最新、影響度）
   - 実装クイックリファレンス（インストールコマンド、リンク集）
   - 成果物パス一覧

2. **次ステップの案内**
   - `/basic-design-workflow` の実行を促す

---

## サーキットブレーカー

| 条件 | アクション |
|------|----------|
| 公式ドキュメントにアクセス不可 | 代替ソース使用 + 警告表示 |
| 情報が古い可能性あり | `⚠️ 要確認` マークを付与 |
| 調査時間超過（deep: 90分以上） | 中間レポート出力して終了 |

---

## 最終出力

```markdown
## 技術キャッチアップ完了報告

### 実行サマリー

| 項目 | 内容 |
|------|------|
| 調査技術数 | X件 |
| 調査深度 | standard |
| 所要時間 | XX分 |

### 調査結果一覧

| 技術 | 現行 | 最新 | 影響度 | レポート |
|------|------|------|--------|---------|
| Next.js | 14.0.0 | 15.1.0 | 🔴 高 | [リンク] |
| Prisma | 5.0.0 | 5.5.0 | 🟡 中 | [リンク] |
| TanStack Query | v4 | v5 | 🔴 高 | [リンク] |

### 実装クイックリファレンス

| 技術 | インストール | 公式ドキュメント | GitHub |
|------|-------------|-----------------|--------|
| Next.js | `npm install next`15` skill` | [nextjs.org/docs](URL) | [vercel/next.js](URL) |
| Prisma | `npm install prisma` | [prisma.io/docs](URL) | [prisma/prisma](URL) |
| TanStack Query | `npm install `tanstack` skill/react-query` | [tanstack.com/query](URL) | [TanStack/query](URL) |

### 設計への影響サマリー

#### 🚨 必須対応（基本設計前に決定必要）

1. **Next.js 15**: App Router完全移行が必要。Pages Router非推奨
2. **TanStack Query v5**: API大幅変更。既存コード要修正

#### ⚠️ 注意事項

- Prisma 5.5: 新しいクエリエンジン。パフォーマンステスト推奨

#### 未解決課題

| ID | 課題 | 対応方針 |
|----|------|---------|
| I-XXX | Next.js 14→15移行戦略 | 基本設計で決定 |

### 成果物

- docs/research/TECH-FE-001_Next.js.md
- docs/research/TECH-BE-002_Prisma.md
- docs/research/TECH-FE-003_TanStack-Query.md

### 次のステップを選択してください

1. 基本設計に進む（`/basic-design-workflow`）
2. 技術調査レポートを確認・修正する
3. 一旦終了する

> 番号を選択してください（1-3）:
```

---

## エラーハンドリング

| 状況 | 対処法 |
|------|--------|
| 技術名が曖昧 | 候補を提示してユーザーに確認 |
| 公式ドキュメントなし | GitHub / npm / crates.io から情報収集 |
| バージョン情報取得失敗 | 手動入力を依頼 |
| 深度「deep」で時間超過 | 中間成果を保存して続行オプション提示 |

---

## Sisyphusへの指示

### 使用ツール

- `call_omo_agent(subagent_type='librarian')`: 外部ドキュメント調査（バックグラウンド実行）
- `websearch_exa`: Web検索
- `context7_query-docs`: ライブラリドキュメント検索

### 処理フロー

1. **Phase 0.5: コンテキスト確認**
   - `package.json`, `Cargo.toml` 等から現在のバージョン確認
   - `docs/research/TECH-*.md` で直近30日以内の調査レポート確認
   - 調査済みの場合はスキップ候補としてユーザーに確認

2. **Phase 1: 調査対象の特定**
   - 引数から技術リストを抽出
   - 要件定義書パスがあれば技術キーワードを追加抽出
   - 既存調査済み技術を除外して優先度付け

3. **Phase 2: 情報収集**（librarian エージェント使用）
   - 調査深度に応じた収集項目:
     - **quick**: バージョン、ドキュメントURL、GitHub URL のみ
     - **standard**: + インストールコマンド、コード例、主要API、エラー対処
     - **deep**: + ベストプラクティス、エコシステム、競合比較
   - タイムアウト: quick=15分, standard=45分, deep=90分
   - タイムアウト時は中間レポートを出力

4. **Phase 3: レポート作成**
   - 複数技術 → `docs/research/TECH-REPORT-{date}_Combined.md`
   - 単体技術 → `docs/research/TECH-{category}-{id}_{name}.md`

5. **Phase 4: 完了報告**
   - レポートパスとステータスを返却

---

## 関連ドキュメント

- 前工程: `/req-workflow`（要件定義）
- 次工程: `/basic-design-workflow`（基本設計）
- 参照: `.opencode/README.md`（ワークフロー全体図）

## 参照スキル

| スキル | 用途 |
|--------|------|
| `workflow-phase-convention` skill | Phase番号体系・承認ゲート規約 |
| `approval-gate` skill | ユーザー承認ゲートの共通フォーマット |

---

> **Phase規約**: `workflow-phase-convention` skill を参照