Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-8qa1-waza-guide-md-cli-overview-guide-md-waza
specdojo.typeproject
specdojo.statusready
specdojo.rulebookspecdojo:pjr-rulebook
specdojo.part_ofprj-0001:pjr-index
specdojo.item_typetodo
specdojo.item_statusdone
specdojo.prioritymedium
specdojo.ownerARC
specdojo.registered_at2026-08-08T12:33:02Z
specdojo.completed_at2026-08-08T12:00:00Z

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作業担当状態メモ
1cli-overview-guide.md を waza-guide.md へリネームするARCdonegit mv でリネーム
2frontmatter の id、H1、英語名行を更新し、Waza の位置づけの注記を追記するARCdoneid=specdojo:waza-guide、H1=遂行の技活用ガイド
3.vitepress/sidebar-config.ts の該当エントリを更新するARCdoneguide("遂行の技活用", "waza-guide") へ更新
4リポジトリ内の相互参照リンク(約30件)を新しいファイル名・idへ追従修正するARCdoneアクティブ文書10件を追従修正、履歴は方針参照
5npm run lint:md / npm run docs:build を実行し、エラーがないことを確認するARCdone両方ともエラーなし

4. 対応結果 ​

  • docs/ja/specdojo/guides/cli-overview-guide.md を git mv で waza-guide.md へリネームし、frontmatter id を 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. 関連ドキュメント ​