PJR-8QA1 waza-guide.md新設(cli-overview-guide.mdをWaza名称へ改称)とサイドバー・相互参照リンク更新
1. 概要
cli-overview-guide.mdをwaza-guide.mdへリネームし、id・frontmatter・H1(遂行の技活用ガイド/Waza Guide)を更新する。サイドバー表示名(遂行の技活用)と、約30ファイルに及ぶ相互参照リンクを追従修正する。
SpecDojo は道場のメタファーとして、実践の型(rulebook/recipe/sample/template)を「Kata」、進め方(approach)を「Ryu」、specdojo CLI コマンド群を「Waza」と呼ぶ整理を採用した。既存の [[specdojo:cli-overview-guide]] は specdojo CLI 全体の入口ガイドであり、この「Waza」に相当するため、waza-guide.md へ改称し、id・H1 を Waza の枠組みに合わせて更新する。
2. 完了条件
docs/ja/specdojo/guides/cli-overview-guide.mdがdocs/ja/specdojo/guides/waza-guide.mdへリネームされ、frontmatter のidがspecdojo:waza-guideになっている。- H1 が「遂行の技活用ガイド」、その直下の英語名行が「Waza Guide」になっている。
- 本文の実質的な内容(CLIの役割、標準ディレクトリ構成、初期設定、project解決順序、代表フロー)は変更前の [[specdojo:cli-overview-guide]] の内容を維持している。
- 冒頭付近に、「Waza」が説明用の愛称・分類であり、CLI コマンド名や frontmatter のフィールド名を変更するものではない旨の注記がある。
.vitepress/sidebar-config.tsの該当エントリがguide("遂行の技活用", "waza-guide")に更新され、「遂行体系で回す」グループ内の位置(先頭)が変わっていない。- リポジトリ内で
cli-overview-guideを参照している既存ファイル(他ガイド・standard・template等、約30件)のリンク・id参照が新しいファイル名・idに追従修正されている。 npm run lint:mdがエラーなく通る。npm run docs:buildがエラーなく通る。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | cli-overview-guide.md を waza-guide.md へリネームする | ARC | done | git mv でリネーム |
| 2 | frontmatter の id、H1、英語名行を更新し、Waza の位置づけの注記を追記する | ARC | done | id=specdojo:waza-guide、H1=遂行の技活用ガイド |
| 3 | .vitepress/sidebar-config.ts の該当エントリを更新する | ARC | done | guide("遂行の技活用", "waza-guide") へ更新 |
| 4 | リポジトリ内の相互参照リンク(約30件)を新しいファイル名・idへ追従修正する | ARC | done | アクティブ文書10件を追従修正、履歴は方針参照 |
| 5 | npm run lint:md / npm run docs:build を実行し、エラーがないことを確認する | ARC | done | 両方ともエラーなし |
4. 対応結果
docs/ja/specdojo/guides/cli-overview-guide.mdをgit mvでwaza-guide.mdへリネームし、frontmatteridをspecdojo:waza-guide、H1 を「遂行の技活用ガイド」、英語名行を「Waza Guide」へ更新した。- 冒頭に、「Waza(遂行の技)」が CLI 全体像を説明するための愛称・分類であり、CLI のコマンド名や frontmatter のフィールド名を変更するものではない旨の注記を追記した。本文の実質的な内容(CLIの役割、標準ディレクトリ構成、初期設定、project解決順序、代表フロー)は変更していない。
.vitepress/sidebar-config.tsの「遂行体系で回す」グループ先頭をguide("遂行の技活用", "waza-guide")へ更新した(グループ内の位置は不変)。- 相互参照を追従修正したアクティブ文書: specdojo:kata-guide、specdojo:orchestrator-operation-guide、specdojo:specdojo-overview-guide(
based_onを含む)、specdojo:use-case-guide、specdojo:command-reference、specdojo:directory-layout-reference、specdojo:reference-authoring-standard、specdojo:id-and-file-naming-standard(命名例)、docs/ja/index.md。 - 履歴蓄積ファイル(過去の result・他項目の個票)内の記述は凍結記録として原則そのままとし、リンク切れとなる live wikilink(
pjr-0157-cli-verb-taxonomy.mdの関連ドキュメント)のみ[[specdojo:waza-guide]]へ更新した。バックティック内の literal 記述や過去のファイルパス記録は変更していない。 npm run lint:mdとnpm run docs:buildはいずれもエラーなく完了した。register buildによりgenerated/pjr-views.mdは再生成される。
5. 関連ドキュメント
- 変更対象: [[specdojo:cli-overview-guide]](改称後は
specdojo:waza-guide) - 対になるガイド: specdojo:kata-guide(Kata/Waza の対応関係)
- 上位構成の根拠: specdojo:practice-system-composition-guide
- サイドバー設定(
docs/外ファイル):.vitepress/sidebar-config.ts - 対になる登録項目: prj-0001:pjr-a45t-ryu-guide-md-kata-guide-md-approach(ryu-guide.md 新設)