claude-howto/ja/docs/TASKS-20260401.md

タスク: デュアルレイヤー知識ベース — 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 月	継続