PJR-MWXS uis-index / bds-index の実践の型(kata)一式の新設
1. 概要
uis-index・bds-index 成果物向けのHub専用 rulebook が存在しない。bes-index-rulebook.md に倣い、rulebook だけでなく recipe・sample・template を含む kata 一式を新設する。
2. 完了条件
uis-index-rulebook・bds-index-rulebookの rulebook・recipe・sample・template(計8ファイル)が作成されていること。- 各 rulebook が「要点(SSOT)+一覧表+関連guide/referenceへのリンク」という Hub 構成になっており、
bes-index-rulebook.mdと章立ての考え方が揃っていること。 uis-index-rulebookはcommand-reference.mdの11コマンド群への導線を、bds-index-rulebookは gantt-chart・CPM・critical-path・Ready一覧など専用rulebookを持たない生成物への導線を持つこと(gantt-chartは元timelineから改名した生成物であり、新設のtml-(トラック順序計画)とは別物のため対象外とする)。dct-user-interface-model.yamlのuis-index/bds-indexエントリが参照するrulebookID(specdojo:uis-index-rulebook/specdojo:bds-index-rulebook)と実ファイルが一致していること。npm run -s lint:mdにエラーがないこと。npm run docs:buildが成功すること。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | uis-index-rulebook.md の作成(章立てはbes-index-rulebook.md準拠) | BA | open | 対象: docs/ja/specdojo/rulebooks/uis-index-rulebook.md |
| 2 | uis-index-recipe.md の作成 | BA | open | 対象: docs/ja/specdojo/recipes/uis-index-recipe.md |
| 3 | uis-index-sample.md の作成 | BA | open | 対象: docs/ja/specdojo/samples/uis-index-sample.md |
| 4 | uis-index-template.md の作成 | BA | open | 対象: docs/ja/specdojo/templates/uis-index-template.md |
| 5 | bds-index-rulebook.md の作成(章立てはbes-index-rulebook.md準拠) | BA | open | 対象: docs/ja/specdojo/rulebooks/bds-index-rulebook.md |
| 6 | bds-index-recipe.md の作成 | BA | open | 対象: docs/ja/specdojo/recipes/bds-index-recipe.md |
| 7 | bds-index-sample.md の作成 | BA | open | 対象: docs/ja/specdojo/samples/bds-index-sample.md |
| 8 | bds-index-template.md の作成 | BA | open | 対象: docs/ja/specdojo/templates/bds-index-template.md |
| 9 | dct-user-interface-model.yaml の rulebook 参照との整合確認、lint:md/docs:build 実行 | BA | open | 完了条件の検証コマンドを実行する |
4. 対応結果
bootstrap approachへ委譲するため、実装せずregister deferとする。判断根拠は次のとおり。
docs/ja/specdojo/rulebooks/配下の既存「-index」Hub系rulebook(bes/sysd/sf/dct/ifx/nfr/opd/tsp/dmd/opr/itc/utc/etc/mip/cop/atc/stc/tsd の18件)は、専用のPJRチケットではなく、対応トラックがSchedule化された際のapproach: bootstrapタスク(成果物本体とrulebook/recipe/sample/templateを同一タスクで一括整備する仕組み)で作成されたと考えられる。uis-index/bds-indexが未作成なのも、他のdraftトラック(data-model・business-model等)と同様にuser-interface-modelトラックが未Schedule化なだけであり、特別な欠陥ではない。- 実際に
specdojo exec plan --project prj-0001 --deliverable uis-index --approach bootstrapを試行し、bootstrap approachが成果物本体・rulebook・recipe・sample・templateを一括整備する仕組みとして機能することを確認した。 - ただし現時点では、owner role解決(
sch-strategy-*.yamlのowner_rulesからuis-index/bds-indexのlocal_idを引く仕組み)に必要なsch-strategy-user-interface-model.yamlが存在しないため、bootstrap実行時のplanで owner role・責務・レビュー観点が_MISSING_になることを確認した。この前提を満たすまで(user-interface-modelトラックがtml-rulebook.mdの定める順序でSchedule化されるまで)は、bootstrap実行を待つ必要がある。 - 追跡は本チケット(register)から
tml-index.yaml(user-interface-modelトラック、catalog_status: draft)へ引き継がれるため、本チケットをdeferしても作業自体が失われることはない。sch-strategy-user-interface-model.yaml作成時は、本チケットのowner(BA)と同じロールをuis-index/bds-indexのowner_rulesに設定することを想定する。 - レビューで判明した「timeline」表記の陳腐化(PJR-SEQCによる
timeline→gantt-chart改名後も本チケットとdct-user-interface-model.yamlのbds-indexnote双方に残っていた)は、defer前に修正済み。
5. 関連ドキュメント
- prj-0001:dct-user-interface-model:
uis-index/bds-indexエントリの参照元カタログ - specdojo:bes-index-rulebook: 章立ての参考にするHub型rulebookの先例
- specdojo:kata-guide: rulebook / recipe / sample / template の役割分担
- specdojo:command-reference:
uis-indexが導線とするCLIコマンド群 - specdojo:schedule-design-guide:
bds-indexが導線とするgantt-chart・CPM等の設計背景 - specdojo:schedule-operation-guide:
bds-indexが導線とするgantt-chart・CPM・Ready一覧の生成・運用手順 - prj-0001:tml-index: defer後の追跡先。
user-interface-modelトラックのcatalog_status - specdojo:ryu-guide: bootstrap approachの定義・進め方