全ファイル日本語化: スコープ整理と実施計画 #2

背景

このリポジトリを「日本語を主言語とする配布物/開発体験」に寄せる。README だけでなく、skill テンプレート、生成物、CLI 文言、テスト、fixture まで影響するため、親 Issue で全体方針・依存関係・収束条件を管理する。

2026-03-15 時点の規模感

• 追跡対象ファイル数: 105 files
• 総行数: 22,113 lines (.git / node_modules 除く)
• 主要な塊:
  • ルートの docs/config: 14 files
  • skill docs/templates: 20 files
  • browse/src: 14 files / 4,034 lines
  • browse/test: 22 files / 4,114 lines
  • test/ ツリー: 17 files / 4,151 lines
  • scripts: 7 files / 916 lines
  • review: 5 files / 674 lines
  • qa: 4 files / 872 lines
  • bin: 4 files / 288 lines

確定ポリシー

source of truth は #3。

• 翻訳しないもの
  • CLI コマンド名
  • slash command 名
  • JSON key
  • package metadata
  • ブランド名・固有名詞 (gstack, Claude Code, Playwright など)
• LICENSE の扱い
  • 英語原文の LICENSE は維持する
  • 日本語参考訳を別ファイルで持つ
  • 日本語版は参考訳であり、法的な正本は英語原文であることを明記する
• 優先順位
  • まず user-facing 文言を日本語化する
  • 次にその変更に追随する fixture / ground truth / assertion を更新する
  • 内部コメントは repo 全体の必須翻訳対象にはしない
• 維持する契約
  • コード識別子、API 名、env var、selector、id、class、data attribute、ファイルパス、機械可読な出力形式

子Issue一覧

• 全ファイル日本語化: ポリシーと非翻訳ルールを確定する #3 全ファイル日本語化: ポリシーと非翻訳ルールを確定する
• 全ファイル日本語化: ルート docs / config を日本語化する #4 全ファイル日本語化: ルート docs / config を日本語化する
• 全ファイル日本語化: skill テンプレートを日本語化する #5 全ファイル日本語化: skill テンプレートを日本語化する
• 全ファイル日本語化: browse の実行時文言と UI テキストを日本語化する #6 全ファイル日本語化: browse の実行時文言と UI テキストを日本語化する
• 全ファイル日本語化: review / qa 補助ドキュメントを日本語化する #7 全ファイル日本語化: review / qa 補助ドキュメントを日本語化する
• 全ファイル日本語化: scripts / bin / setup のメッセージを日本語化する #8 全ファイル日本語化: scripts / bin / setup のメッセージを日本語化する
• 全ファイル日本語化: generated SKILL.md を再生成して整合性を取る #9 全ファイル日本語化: generated SKILL.md を再生成して整合性を取る
• 全ファイル日本語化: テスト・fixture・eval baseline を更新する #10 全ファイル日本語化: テスト・fixture・eval baseline を更新する

Dependency Graph

graph TD
    I3["#3 ポリシーと非翻訳ルール"]
    I4["#4 ルート docs / config"]
    I5["#5 skill templates"]
    I6["#6 browse 実行時文言 / UI"]
    I7["#7 review / qa 補助 docs"]
    I8["#8 scripts / bin / setup"]
    I9["#9 generated SKILL.md 再生成"]
    I10["#10 テスト / fixture / eval baseline"]
    DONE["#2 親Issue 完了"]

    I3 --> I4
    I3 --> I5
    I3 --> I6
    I3 --> I7
    I3 --> I8
    I3 --> I9
    I3 --> I10

    I5 --> I9
    I6 --> I9
    I8 --> I9

    I4 --> I10
    I5 --> I10
    I6 --> I10
    I7 --> I10
    I8 --> I10
    I9 --> I10

    I4 --> DONE
    I7 --> DONE
    I10 --> DONE

並列化方針

• 全ファイル日本語化: ポリシーと非翻訳ルールを確定する #3 を source of truth として固定した
• 全ファイル日本語化: ルート docs / config を日本語化する #4 全ファイル日本語化: skill テンプレートを日本語化する #5 全ファイル日本語化: browse の実行時文言と UI テキストを日本語化する #6 全ファイル日本語化: review / qa 補助ドキュメントを日本語化する #7 全ファイル日本語化: scripts / bin / setup のメッセージを日本語化する #8 は並列着手対象
• 全ファイル日本語化: generated SKILL.md を再生成して整合性を取る #9 は 全ファイル日本語化: skill テンプレートを日本語化する #5 全ファイル日本語化: browse の実行時文言と UI テキストを日本語化する #6 全ファイル日本語化: scripts / bin / setup のメッセージを日本語化する #8 を取り込んだ後の収束タスク
• 全ファイル日本語化: テスト・fixture・eval baseline を更新する #10 は翻訳差分を横断反映する最終収束タスク

完了条件

• 主要 docs / skill docs / CLI 実行時メッセージが日本語で一貫している
• 生成物はテンプレートと同期している
• 少なくとも bun test が通る
• 英語のまま残す箇所は理由付きで一覧化されている