# タスク: デュアルレイヤー知識ベース — claude-howto > 作成日: 2026-04-01 --- ## マイルストーン | # | マイルストーン | 目標期日 | 説明 | |---|-----------|--------|-------------| | M1 | インフラ稼働 | 2026 年 4 月末 | quickstart.sh、CLAUDE.md、鮮度チェック Action、エージェントインデックスジェネレータ稼働。最も弱い 2 モジュールを刷新 | | M2 | 10 モジュール中 6 つ完成 | 2026 年 6 月末 | スラッシュコマンド、メモリ、スキル、CLI モジュールを完全刷新。ジェネレータが有効なマニフェストを出力 | | M3 | 全 10 モジュール完成 | 2026 年 8 月末 | 全モジュールがシナリオ導入、Try It Now ブロック、決定ツリー、名前付きパターンを備える | | M4 | エージェントレイヤー稼働 | 2026 年 9 月末 | agent-manifest.json と AGENT-INDEX.md が生成済み、リポジトリ内にルックアップスキルがある、RECIPES.md と COMMUNITY-PROJECTS.md が稼働 | | M5 | バージョン監査完了 | 2026 年 11 月末 | 全 10 モジュールが現行 Claude Code バージョンで検証済み、RECIPES.md は 8 件以上 | | M6 | 自走するシステム | 2027 年 3 月末 | エージェントマニフェストが全モジュールを 100% カバー（CI 検証）、RECIPES.md は 10 件以上、コミュニティページが有機的に成長 | --- ## フェーズ 1 — インフラと弱いモジュール（2026 年 4 月） **対象マイルストーン: M1** ### 柱 4: 新規ユーザーオンボーディング - [ ] **T-001** — `scripts/quickstart.sh` を作成 - `~/.claude/` ディレクトリを検出（無い場合はユーザー確認のうえ作成） - 最初のスラッシュコマンド＋CLAUDE.md＋スキルをユーザーのセットアップにコピー - CLAUDE.md にエージェント発見用の行を追記し、AGENT-INDEX.md にリンク - 冪等: 既存ファイルは警告を出してスキップし、上書きしない - 完了時に次のステップを表示する - [ ] **T-002** — `QUICKSTART.md`（最初の 15 分ビジュアルガイド）を作成 - 注釈付きターミナル手順をコードブロックとして記載（可能な限り PNG スクリーンショットを避け、ASCII か Mermaid を優先） - 各ビジュアルを生成するコマンドを記録し、後から再撮影できるようにする - [ ] **T-003** — 全 10 モジュールの README に難易度バッジを追加 - 形式: 各モジュール README の冒頭に `> 🟢 **Beginner** | ⏱ 30 minutes` - バッジの下に「What you'll build」の箇条書きプレビューを追加 ### 柱 7: 生きたカリキュラム - [ ] **T-004** — `WHATS-NEW.md` を作成 - 形式: `## CC vX.X — DATE` に機能変更を箇条書き - 現行 Claude Code バージョンのエントリを少なくとも 1 件追加 - [ ] **T-005** — 全 10 モジュールの README にバージョンバッジを追加 - 形式: `> ✅ Verified against Claude Code **vX.X.X** · Last verified: YYYY-MM-DD` - 各モジュールのフロントマターに `cc_version_verified` を追加 - [ ] **T-006** — `.github/workflows/staleness-check.yml` を作成 - スケジュール: 毎週月曜 09:00 UTC - 各モジュールのフロントマターから `last_verified` 日付を読む（`yq` または 10 行の Python スクリプトを使う） - 30 日以上検証されていないモジュールに対して GitHub Issue を起票 - 同じタイトルの Open Issue が既にあればスキップ ### 柱 6: コンテンツ品質（CLAUDE.md） - [ ] **T-007** — プロジェクトのルート `CLAUDE.md` を作成 - プロジェクト自身の設定としてベストプラクティスを示す - 投稿規約、モジュール構造、メンテナンスワークフローを明文化 ### 柱 2: AI エージェントインデックス（ジェネレータ） - [ ] **T-008** — `scripts/build-agent-index.py` を作成 - 全 10 モジュールの README ファイルを読む - 抽出: 見出し（→ トピック）、コードブロック（→ 言語タグ付きの例）、テーブル（→ 参照データ） - CEO プランで定義したスキーマで `agent-manifest.json` を出力 - `AGENT-INDEX.md`（人間可読サマリ）を出力 - 参照が実在のファイルを指すか検証 ### モジュール 08-checkpoints: 全面深掘り（311 → 800 行超） - [ ] **T-009** — モジュール導入を実例シナリオで書き直す - 例: 「リファクタで 3 つ壊れた。チェックポイントが救う方法は…」 - [ ] **T-010** — チェックポイント戦略の決定ツリーを追加（Mermaid フローチャート） - 「X したい」 → 矢印を追う → チェックポイントパターンに辿り着く - [ ] **T-011** — 3 つのワークフローテンプレートを追加 - 安全なリファクタリングワークフロー - チェックポイントを使った A/B テスト - 災害復旧ワークフロー - [ ] **T-012** — プランニングモードとの統合セクションを追加 - [ ] **T-013** — チェックポイントライフサイクルの Mermaid 図を追加 - [ ] **T-014** — 検証可能なコマンドを伴う「Try It Now」ブロックを 2 つ以上追加 - 各ブロック: 文脈の文章、実行コマンド、期待される出力の説明 - [ ] **T-015** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 - 各パターン: 課題、解決コード、適用すべき場面、適用すべきでない場面 ### モジュール 06-hooks: 全面深掘り - [ ] **T-016** — モジュール導入を実例シナリオで書き直す - 例: 「CI が 20 分後に lint エラーを検出した。フックなら 2 秒で…」 - [ ] **T-017** — フックの決定ツリーを追加（Mermaid フローチャート） - 「Y が起きたとき X をトリガーしたい」 → 矢印を追う → フックタイプに辿り着く - [ ] **T-018** — 完全なスクリプト付きの 5 つのフック例を追加（各 80 行程度） 1. 書き込み時の自動フォーマット（prettier／black） 2. コミット時のセキュリティスキャン（trufflehog／bandit） 3. ファイル変更時のテスト実行 4. セッション終了時の通知 5. プロンプトの検証（危険なパターンをブロック） - [ ] **T-019** — 検証可能なコマンドを伴う「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-020** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 **M1 チェックポイント: インフラ稼働、最も弱い 2 モジュールが完全刷新** --- ## フェーズ 2 — 深掘り: 強モジュール バッチ 1（2026 年 5〜6 月） **対象マイルストーン: M2** ### モジュール 01-slash-commands: 全面深掘り - [ ] **T-021** — シナリオで導入を書き直す（「同僚が 47 ファイルをプッシュしたばかり…」） - [ ] **T-022** — 決定ツリー（Mermaid）を追加 - [ ] **T-023** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-024** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### モジュール 02-memory: 全面深掘り - [ ] **T-025** — 実例シナリオで導入を書き直す - [ ] **T-026** — 決定ツリー（Mermaid）を追加 - [ ] **T-027** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-028** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### モジュール 03-skills: 全面深掘り - [ ] **T-029** — 実例シナリオで導入を書き直す - [ ] **T-030** — 決定ツリー（Mermaid）を追加 - [ ] **T-031** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-032** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### モジュール 10-cli: 全面深掘り - [ ] **T-033** — 実例シナリオで導入を書き直す - [ ] **T-034** — 決定ツリー（Mermaid）を追加 - [ ] **T-035** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-036** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### ジェネレータ検証 - [ ] **T-037** — 各モジュール刷新後に `scripts/build-agent-index.py` を実行し、有効なマニフェスト出力を確認 - [ ] **T-038** — CI ステップを追加: プッシュごとに agent-manifest.json のスキーマを検証 **M2 チェックポイント: 6/10 モジュール完成、ジェネレータが有効なマニフェストを生成** --- ## フェーズ 3 — 深掘り: 強モジュール バッチ 2（2026 年 7〜8 月） **対象マイルストーン: M3** ### モジュール 04-subagents: 全面深掘り - [ ] **T-039** — 実例シナリオで導入を書き直す - [ ] **T-040** — 決定ツリー（Mermaid）を追加 - [ ] **T-041** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-042** — 「Patterns & Recipes」セクション追加（例: 「The Multi-Agent Review Pattern」） ### モジュール 05-mcp: 全面深掘り - [ ] **T-043** — 実例シナリオで導入を書き直す - [ ] **T-044** — 決定ツリー（Mermaid）を追加 - [ ] **T-045** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-046** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### モジュール 07-plugins: 全面深掘り - [ ] **T-047** — 実例シナリオで導入を書き直す - [ ] **T-048** — 決定ツリー（Mermaid）を追加 - [ ] **T-049** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-050** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 ### モジュール 09-advanced-features: 全面深掘り - [ ] **T-051** — 実例シナリオで導入を書き直す - [ ] **T-052** — 決定ツリー（Mermaid）を追加 - [ ] **T-053** — 「Try It Now」ブロックを 2 つ以上追加 - [ ] **T-054** — 「Patterns & Recipes」セクションに 2 つ以上の名前付きパターンを追加 **M3 チェックポイント: 全 10 モジュールが完成し、一貫している** --- ## フェーズ 4 — エージェントレイヤーとクロスモジュール（2026 年 9 月） **対象マイルストーン: M4** ### 柱 2: AI エージェントインデックスの最終化 - [ ] **T-055** — 完成した全 10 モジュールに対して `scripts/build-agent-index.py` を実行 - 全モジュール 100% カバレッジで最終 `agent-manifest.json` を生成 - `AGENT-INDEX.md` を生成し、README.md からリンク - [ ] **T-056** — `skills/claude-howto-lookup/SKILL.md` を作成 - `agent-manifest.json` を読み、関連モジュールを検索 - `Read` で当該セクションを読み込む - インストール: `cp -r claude-howto/skills/claude-howto-lookup ~/.claude/skills/` - [ ] **T-057** — quickstart.sh と QUICKSTART.md でルックアップスキルを任意機能として言及 ### 柱 3b: クロスモジュール RECIPES.md - [ ] **T-058** — `RECIPES.md` を作成（複合ワークフロー 5 件以上） - レシピごとのスキーマ: name、modules-used、problem、solution code block、expected outcome - 例: スキル＋フック＋サブエージェント ＝ 自動レビューパイプライン - 主要見出しすべてに HTML アンカーを付け、ディープリンクを可能にする ### 柱 5: コミュニティショーケース - [ ] **T-059** — `COMMUNITY-PROJECTS.md` を作成 - 投稿フォーマットを伴う静的 Markdown ページ: 名前、説明、リンク、使用機能 - テンプレートエントリを含める - PR ベースの投稿手順を記載 **M4 チェックポイント: エージェントインデックス、レシピ、コミュニティページが稼働** --- ## フェーズ 5 — バージョン監査とレシピ拡張（2026 年 10〜11 月） **対象マイルストーン: M5** - [ ] **T-060** — 完全なバージョン監査を実施: 全 10 モジュールを現行 Claude Code バージョンで検証 - 各モジュールの `cc_version_verified` フロントマターを更新 - バージョンバッジを更新 - [ ] **T-061** — 観察されたコミュニティパターンに基づき `RECIPES.md` を 8 件以上に拡張 - [ ] **T-062** — 完成モジュールから新パターンが現れたら、エージェントマニフェストのスキーマを反復改善 - [ ] **T-063** — ピン留め GitHub Discussion を開設: 「Share your Claude Code workflows」 - 実際のエージェント利用シグナルを集め、今後のレシピ拡張に反映 **M5 チェックポイント: 全モジュールが現行検証済み、レシピが拡大中** --- ## フェーズ 6 — 複合化と維持（2026 年 12 月〜2027 年 3 月） **対象マイルストーン: M6** - [ ] **T-064** — Claude Code リリースのたびに `/docs-sync-claude-code` スキルを実行し、`WHATS-NEW.md` を更新 - [ ] **T-065** — エージェントマニフェストが全モジュールを 100% カバーすることを保証（CI 回帰テスト） - [ ] **T-066** — `RECIPES.md` を 10 件以上に拡大 - [ ] **T-067** — `COMMUNITY-PROJECTS.md` の有機的成長を監視し、新規エントリをキュレーション - [ ] **T-068** — GitHub Discussions のエージェント利用シグナルを評価。妥当なら、ルックアップスキルの宣伝に投資（マーケティング、asm レジストリ） **M6 チェックポイント: システムが自走している** --- ## 先送り（TODOS.md） 以下の項目は本計画のスコープ外。スコープクリープを避けるためにここに記録： - スキルマーケットプレイスとインストール可能なレジストリ - 独自の Web サイトやダッシュボード - 進捗トラッキング基盤（cc-progress） - CI 検証付きのコミュニティチュートリアルテンプレート - 自動生成 CONTRIBUTORS.md - 多言語翻訳 - クイズ・アセスメント基盤の刷新 - COMMUNITY-PROJECTS.md のコミュニティ投票・レビュー機構 --- ## フェーズ別タスクサマリ | フェーズ | タスク | 期間 | 対象モジュール | |-------|-------|--------|-----------------| | 1 — インフラと弱いモジュール | T-001 〜 T-020 | 2026 年 4 月 | 06-hooks、08-checkpoints ＋インフラ | | 2 — バッチ 1 深掘り | T-021 〜 T-038 | 2026 年 5〜6 月 | 01、02、03、10 | | 3 — バッチ 2 深掘り | T-039 〜 T-054 | 2026 年 7〜8 月 | 04、05、07、09 | | 4 — エージェントレイヤーとクロスモジュール | T-055 〜 T-059 | 2026 年 9 月 | 全モジュール（マニフェスト）＋新規ファイル | | 5 — バージョン監査とレシピ | T-060 〜 T-063 | 2026 年 10〜11 月 | 全モジュール（監査） | | 6 — 維持 | T-064 〜 T-068 | 2026 年 12 月〜2027 年 3 月 | 継続 |