<!-- i18n-source: docs/ROADMAP-20260401.md -->
<!-- i18n-source-sha: 6d1e0ae -->
<!-- i18n-date: 2026-04-27 -->
# ロードマップ: claude-howto 2026–2027

> 2026 年 4 月〜 2027 年 3 月 · デュアルレイヤー知識ベース | 全体計画: `TASKS-20260401.md`

---

## ビジョン

claude-howto を静的なチュートリアルリポジトリから **生きたデュアル対象向け知識システム** へ転換する：

- **人間向け** — シナリオベースのインタラクティブ学習。難易度の段階付け、決定ツリー、エキスパートがブックマークする名前付きパターンを備える
- **AI エージェント向け** — エージェントが Claude Code タスク実行前に問い合わせる構造化メタデータインデックス。これによりリポジトリは単なるコンテンツではなくインフラとなる

主要な対象として AI エージェントを据える競合は存在しない。これが本プロジェクトの参入障壁となる。

---

## 7 つの柱

| # | 柱 | 提供するもの |
|---|--------|-----------------|
| P1 | Fun Layer | 各モジュールにシナリオ導入と「Try It Now」ブロック |
| P2 | AI Agent Index | 自動生成 `agent-manifest.json` ＋ `AGENT-INDEX.md` ＋ ルックアップスキル |
| P3a | Expert Reference (in-module) | モジュールごとの決定ツリーと名前付きパターン |
| P3b | Expert Reference (cross-module) | `RECIPES.md` — 複数機能を組み合わせた複合ワークフロー |
| P4 | Newcomer Onboarding | `quickstart.sh` ＋ `QUICKSTART.md` ＋難易度バッジ |
| P5 | Community Showcase | `COMMUNITY-PROJECTS.md` — 厳選されたユーザープロジェクト |
| P6 | Content Quality | 弱いモジュールの拡充、プロジェクト用 `CLAUDE.md` |
| P7 | Living Curriculum | `WHATS-NEW.md` ＋バージョンバッジ＋週次の鮮度チェック CI |

---

## タイムライン概観

```
Apr 2026   May–Jun 2026   Jul–Aug 2026   Sep 2026   Oct–Nov 2026   Dec 2026–Mar 2027
   |             |              |             |             |               |
  [M1]          [M2]           [M3]          [M4]          [M5]            [M6]
Infrastructure  6/10 modules   10/10         Agent layer   Version audit   Self-sustaining
+ hooks/checks  complete       complete      + recipes     complete        system
```

---

## マイルストーン

### M1 — インフラ稼働 · 2026 年 4 月末

**リリース内容:**
- `scripts/quickstart.sh` — 新規ユーザー向けのワンコマンドセットアップ（冪等）
- `QUICKSTART.md` — 「最初の 15 分」ビジュアルガイド
- 全 10 モジュールに難易度バッジと「What you'll build」プレビュー
- `WHATS-NEW.md` ＋全モジュールのバージョンバッジ
- `.github/workflows/staleness-check.yml` — モジュールが 30 日以上未検証なら毎週月曜に Issue を起票
- ルート `CLAUDE.md` — プロジェクト自身の設定をベストプラクティス例として提示
- `scripts/build-agent-index.py` — 全 10 モジュールを読み込み → `agent-manifest.json` ＋ `AGENT-INDEX.md` を出力するジェネレータ
- **06-hooks** — 全面深掘り: 完成された 5 つのフックスクリプト、決定ツリー、Try It Now、パターン
- **08-checkpoints** — 全面深掘り: 311 → 800 行超、3 つのワークフローテンプレート、決定ツリー、パターン

**ここから始める理由:** インフラはすべての後続フェーズに恩恵をもたらす。Hooks と Checkpoints は最も弱いモジュールであり、新しい来訪者を最も逃しやすい。

---

### M2 — 10 モジュール中 6 つ完成 · 2026 年 6 月末

**リリース内容（モジュールごとに 1 回深掘り）:**
- **01-slash-commands** — シナリオ導入、決定ツリー、Try It Now、名前付きパターン
- **02-memory** — シナリオ導入、決定ツリー、Try It Now、名前付きパターン
- **03-skills** — シナリオ導入、決定ツリー、Try It Now、名前付きパターン
- **10-cli** — シナリオ導入、決定ツリー、Try It Now、名前付きパターン
- CI ステップ: プッシュごとに `agent-manifest.json` のスキーマを検証

各モジュールの深掘り終了時にジェネレータを実行し、有効なマニフェストが出力されることを確認する。

---

### M3 — 全 10 モジュール完成 · 2026 年 8 月末

**リリース内容:**
- **04-subagents** — 全面深掘り（「The Multi-Agent Review Pattern」を含む）
- **05-mcp** — 全面深掘り
- **07-plugins** — 全面深掘り
- **09-advanced-features** — 全面深掘り

すべてのモジュールがシナリオ導入、2 つ以上の Try It Now ブロック、Mermaid 決定ツリー、2 つ以上の名前付きパターンを備える。

---

### M4 — エージェントレイヤー稼働 · 2026 年 9 月末

**リリース内容:**
- 最終的な `agent-manifest.json`（完成コンテンツから生成、全モジュールの 100% をカバー）
- `README.md` からリンクされる `AGENT-INDEX.md`
- `skills/claude-howto-lookup/SKILL.md` — マニフェストを問い合わせる軽量なエージェントスキル
- `RECIPES.md` — 5 つ以上の複合ワークフロー（スキーマ: name、modules-used、problem、solution、expected outcome）
- `COMMUNITY-PROJECTS.md` — PR ベースの投稿形式による静的な厳選リスト

**9 月にする理由:** エージェントインデックスは 10 モジュールすべてのコンテンツが完成していて初めて意味を持つ。

---

### M5 — バージョン監査完了 · 2026 年 11 月末

**リリース内容:**
- 完全なバージョン監査: 全 10 モジュールを現行 Claude Code バージョンで検証
- すべての箇所で `cc_version_verified` フロントマターとバージョンバッジを更新
- 観察されたコミュニティパターンに基づき `RECIPES.md` を 8 件以上に拡張
- ピン留め GitHub Discussion: 「Share your Claude Code workflows」 — エージェント利用シグナル収集用

---

### M6 — 自走するシステム · 2027 年 3 月末

**リリース内容／継続稼働:**
- `/docs-sync-claude-code` スキルが Claude Code リリースのたびに走る → `WHATS-NEW.md` が更新される
- エージェントマニフェストの CI 回帰テスト: 全モジュール 100% カバレッジを強制
- `RECIPES.md` が 10 件以上
- `COMMUNITY-PROJECTS.md` が有機的に成長
- エージェント利用シグナルを評価 → 妥当性が検証されたらルックアップスキルを宣伝（マーケティング、asm レジストリ）

---

## 成果物まとめ

| 成果物 | 種別 | フェーズ |
|-------------|------|-------|
| `scripts/quickstart.sh` | スクリプト | P1 |
| `QUICKSTART.md` | ドキュメント | P1 |
| ルート `CLAUDE.md` | 設定 | P1 |
| `WHATS-NEW.md` | ドキュメント | P1 |
| `.github/workflows/staleness-check.yml` | CI | P1 |
| `scripts/build-agent-index.py` | スクリプト | P1 |
| 10 モジュール深掘り（シナリオ＋Try It Now＋決定ツリー＋パターン） | コンテンツ | P1–P3 |
| `agent-manifest.json`（自動生成） | データ | P4 |
| `AGENT-INDEX.md`（自動生成） | ドキュメント | P4 |
| `skills/claude-howto-lookup/SKILL.md` | スキル | P4 |
| `RECIPES.md`（5 → 8 → 10 件超） | ドキュメント | P4–P6 |
| `COMMUNITY-PROJECTS.md` | ドキュメント | P4 |

---

## スコープ外

`TODOS.md` に先送り — これらが紛れ込まないようにする：

- スキルマーケットプレイスやインストール可能なレジストリ
- 独自の Web サイトやダッシュボード
- 進捗トラッキング（cc-progress）
- コミュニティチュートリアルの CI 検証
- 自動生成の CONTRIBUTORS.md
- 多言語翻訳
- クイズ・アセスメント基盤
- プロジェクトに対するコミュニティ投票
