Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-98sq-quick-start-register-use-cases
specdojo.typeproject
specdojo.statusready
specdojo.rulebookspecdojo:pjr-rulebook
specdojo.part_ofprj-0001:pjr-index
specdojo.item_typetodo
specdojo.item_statusdone
specdojo.priorityhigh
specdojo.difficultyhard
specdojo.ownerDEV
specdojo.registered_at2026-10-22T13:18:07Z
specdojo.completed_at2026-10-22T14:10:24Z
specdojo.conclusionQuick Start に register のユースケース別の章(13 節)を置き、カタログと schedule、worktree、routine を発展として後ろに回した。各節に、こんなとき・チャットでの頼み方・そのまま打てるコマンドをそろえた
specdojo.derived_fromPJR-H72A

PJR-98SQ Quick Start を register のユースケース別の使い方を中心に組み替える ​

1. 概要 ​

Quick Start は register の使い方が最初の体験とカタログ作成への道筋に分かれ、approach・difficulty・post-review・夜間の実行・別の project への起票などの使い方が載っていない。register のユースケース別に、こんなとき・チャットでの頼み方・具体的なコマンドを並べる章を中心に置き、カタログと schedule 以降は発展として後ろに回す

2. 完了条件 ​

  • 次の版の範囲とする(2026-10-22、利用者が承認)。PJR-ZH7Q と PJR-47S6(Quick Start の Dev Container の節に触れる)の統合の後に行う。
  • specdojo:quick-start-guide を次の順に組み替える。
    1. 10 分で体験する(今の内容と流れのまま)
    2. 初期設定(今の内容を保ち、冗長な説明は短くしてよい)
    3. register のユースケース別の使い方(新しい章)
    4. 以降は「発展」として、成果物カタログから schedule へ、worktree での隔離実行、routine を今の内容のまま後ろに置く
  • 3 章には少なくとも次のユースケースを節として置き、各節に「こんなとき」「チャットでの頼み方(# チャット:)」「コマンド」をそろえる。コマンドは --project などを省かない、そのまま打てる形で書く。
    • 作業を起票して AI に任せる(register add --type todo --difficulty → exec run --register --worktree、振り分けの表)
    • 問題を調べて直す(issue)
    • 決めることを残す(question・decision。1 章への案内でよい)
    • 合意した範囲を変える(change-request)
    • リスクと気づきを残す(risk・note)
    • 成果物を作る・直す(--approach fully-guided・recipe-guided・retrofit と --target <成果物の doc id>。PJR-H72A の決定)
    • 成果物と kata を一組で作る(--approach bootstrap と --target <成果物の doc id>。初期立ち上げ用で、成果物と rulebook・recipe・sample・template を同じ実行で作る)
    • kata を直す(--approach rulebook-maintenance などと --target <kata の id>)
    • 統合後に review の agent に確かめさせる(--post-review)
    • 夜の間に流す(register update --autopilot approved → orchestrator night)
    • 止まった項目を再開する(--resume・--resume-from executor・--force-restart の使い分け)
    • 別の project・別のリポジトリへ起票する(register add --project <id> --commit、external_projects の宣言、--from <id>:PJR-XXXX)
  • 載せるコマンドとオプションは、どれも実際の CLI(--help、書き込まない --dry-run がある場合はそれ)で確かめ、確かめた方法を result に書く。CLI にないオプションや動きを書かない。
  • 今の 3 章(issue・decision・todo を起票してカタログ作成へ進む流れ)の内容は、新しい 3 章か 4 章の発展のどちらかに移し、失わない。
  • specdojo:use-case-guide とは内容を重ねず、必要な箇所で相互に案内する。
  • npm run lint:md と npm run docs:build が通る。見出しの番号の付け替えで壊れた章の参照([[#...]] など)がない。
  • 親の検証(lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema)が通る。
  • CHANGELOG の ## [Unreleased] の節に書く(なければ作る)。公開済みの版の節は変えない。

3. 作業内容 ​

No作業担当状態メモ
1Quick Start を register のユースケース別に組み替えるDEVdoneZH7Q・47S6 の後

4. 対応結果 ​

  • specdojo:quick-start-guide の 1 章と 2 章を維持し、3 章を register の 12 ユースケースと、従来の issue → decision → todo → 成果物カタログの流れに組み替えた。
  • 各ユースケースに「こんなとき」、# チャット:、--project を明示したコマンドを置き、difficulty の振り分け、成果物・kata の approach、統合後 review、夜間実行、再開、別 project・別リポジトリへの起票を追加した。
  • 成果物カタログ、Schedule、worktree、routine の章を発展手順として後段に置き、specdojo:use-case-guide の参照先見出しを新しい構成へ合わせた。
  • CLI の register add --help、register update --help、exec run --help、orchestrator night --help と書き込まない dry-run で掲載構文を確認した。残課題はない。

5. 関連ドキュメント ​