1d1df9235b
- Translate all 101 markdown files: P1 core, all 10 modules, examples, auxiliary docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, CLAUDE.md, etc.), peripheral docs (.github/, docs/, resources/, scripts/) - Translate comments and user-facing messages in 06-hooks/*.sh examples - Copy 05-mcp/*.json examples (standard JSON, no comments) - Update root README.md language switcher to include 日本語 - Add ja/TRANSLATION_NOTES.md (glossary + style guide) All translations pass pre-commit quality gates (markdown-lint, cross-references, mermaid-syntax, link-check, build-epub).
295 lines
15 KiB
Markdown
295 lines
15 KiB
Markdown
<!-- i18n-source: docs/TASKS-20260401.md -->
|
||
<!-- i18n-source-sha: 6d1e0ae -->
|
||
<!-- i18n-date: 2026-04-27 -->
|
||
# タスク: デュアルレイヤー知識ベース — 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 月 | 継続 |
|