feat(i18n): Add Japanese (ja/) translation (#105)

- 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).
This commit is contained in:
JiangCheng authored and GitHub committed 2026-04-30 00:16:46 +02:00
1 parent 32212292df
commit 1d1df9235b
118 files changed
+30380 -3

No files matched your search

+156
View File
@@ -0,0 +1,156 @@
<!-- 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
- 多言語翻訳
- クイズ・アセスメント基盤
- プロジェクトに対するコミュニティ投票
+294
View File
@@ -0,0 +1,294 @@
<!-- 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 月 | 継続 |