Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-0157-cli-verb-taxonomy
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.due_on2026-08-31
specdojo.completed_at2026-08-07T12:00:00Z
specdojo.conclusion生成系動詞を整理し破壊的リネームを実施。exec build→exec refresh、catalog generate→deliverable scaffold(独立サブコマンド)へ改名し、schedule buildは据え置き。用語標準をguideへ明文化、コード・lefthook・docs・tests・schemaを更新、旧名はエラー化。全819テスト成功。オーケストレーターSSOT+4ラッパーも同期済み。

PJR-0157 CLI生成系動詞の用語整理と破壊的リネーム ​

1. 概要 ​

exec build→exec refresh、catalog generate→deliverable scaffoldへ改名し、生成系動詞(scaffold/build/refresh/run)の用語標準を明文化する

CLI の生成系動詞が多義・重複しており、とくに exec build(揮発的な実行状態の算出)と catalog build(派生ビュー生成)で build が別レイヤに並び、catalog scaffold(カタログ生成)と catalog generate(成果物本体生成)も語と意味が対応していない。生成系動詞を scaffold(起点)/ build(派生物)/ refresh(揮発状態)/ run(実行)の4語へ整理し、用語標準を明文化したうえで、破壊的リネームを一括で実施する(未公開プロジェクトのためエイリアスは設けない)。

2. 完了条件 ​

  • 生成系動詞の用語標準(scaffold/build/refresh/run の定義・判定軸・object 一覧)が SSOT として明文化されている。
  • exec build が exec refresh に改名され、旧名は残さない(ヘルプ・出力・docs すべて更新)。
  • catalog generate が deliverable scaffold(独立サブコマンド・object 明示)に改名され、旧名は残さない。
  • schedule build は据え置き(strategy → sch-track の committed 派生物生成として build を維持)。
  • コード・lefthook.yml の hook 名(exec-build)・build-command.ts の umbrella 連鎖・スクリプト・docs・tests のすべての参照が新名へ更新されている。
  • npm run build / lint:ts / lint:md / validate:catalog / npm test が成功する。
  • 旧名(exec build / catalog generate)を実行するとエラーになる(残存参照がない)。

3. 作業内容 ​

No作業担当状態メモ
1用語標準を明文化(scaffold/build/refresh/run の定義・判定軸・現行対応表)ARCopen新規 standard または cli-overview-guide に節追加
2exec build → exec refresh の実装(コマンド定義・ヘルプ・出力文言)ARCopensrc/exec-*.ts。staleness 警告文言も更新
3catalog generate → deliverable scaffold(独立サブコマンド)へ改名ARCopensrc/catalog-generate.ts ほか。object を deliverable に明示
4lefthook.yml の exec-build hook・build-command.ts の umbrella 連鎖を更新ARCopenhook 名と subArgs/label
5docs 一括更新(command-reference・各 guide・quick-start・kata 等)ARCopenexec refresh / deliverable scaffold へ
6tests 更新(exec build/catalog generate 参照を新名へ)ARCopentests/**
7検証(npm run build / lint:ts / lint:md / validate:catalog / npm test)ARCopen旧名の残存参照が無いことを grep で確認

4. 対応結果 ​

5. 関連ドキュメント ​