PJR-CF15 用語集の relatedTerms と category が用語集内の ID を指すことを検証する
1. 概要
PJR-Y06Y で用語集の schema（docs/specdojo/schemas/v1/gl.schema.yaml）を作り、gl-sample.yaml と gl-common.yaml を validate:schema で検証できるようにした。ただし、次の参照は schema では表せず、未検証のままである。
- 各用語の
categoryが、同じ用語集の中に存在する用語 ID（tm-...）を指すこと - 各用語の
relatedTermsの各要素が、同じ用語集の中に存在する用語 ID を指すこと
2026-09-29 の PJR-QD81 の評価で、gl-common.yaml の category が存在しない ID（tm-data-store など）を指していたことを orchestrator が手で見つけた。検証があれば機械的に検出できた。
2. 完了条件
- 用語集の
categoryとrelatedTermsが、同じ用語集の中に存在する用語 ID を指すことを検証する。検証を置く場所（catalog validate、validate:schemaの後段、専用のコマンドなど）を決め、その理由を対応結果に記録する。 - 存在しない ID を指している場合は、用語集のファイル、用語 ID、参照先の ID を示してエラーにする。
- 同じ用語集の中で用語 ID が重複している場合もエラーにする。
npm run checkに含まれ、gl-sample.yamlとgl-common.yamlが検証を通る。- 存在しない ID の参照と、ID の重複を検出する単体テストがある。
gl-rulebook.mdに、この検証があることが書かれている。- 検証の既定の対象は用語集（
docs/**/gl-*.yaml）に限る。用語集ではない YAML を対象に含めず、結果にも表示しない。 package.jsonの script は agent が変更できない設定であるため変更しない。npm run checkへ組み込むために必要な script の追加は、result の申し送りに記載し、統合後に orchestrator が反映する。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 検証を置く場所を決めて実装する | DEV | done | docs-lint の新しいコマンドとして実装し、validate:schema に追加した |
| 2 | テストを追加する | DEV | done | validate-glossary-references.test.ts を追加した |
| 3 | gl-rulebook へ記載する | DEV | done | 6.3 節に追記した |
4. 対応結果
packages/docs-lint/src/validate-glossary-references.tsに検証ロジックを実装し、specdojo-docs-lint.jsのglossary-referencesコマンドとして登録した。package.jsonのvalidate:schemaの最後にnpm run validate:schema:glossaryを追加し、JSON Schema でカバーできない ID 重複や存在しない用語 ID への参照を検知できるようにした。gl-sample.yamlで未定義だったtm-inventory,tm-safety-stock,tm-sales,tm-actorを追加し、検証を通過するように修正した。gl-rulebook.mdの「6.3. 関連用語の運用」を「6.3. 関連用語と分類の運用」に改め、検証についてのルールを追記した。tests/packages/docs-lint/glossary-references.test.tsに、存在しない ID 参照や重複を検知する単体テストを追加した。
5. 関連ドキュメント
- PJR-Y06Y（用語集の schema）、PJR-QD81（用語集 gl-common の作成）
docs/specdojo/schemas/v1/gl.schema.yaml、docs/ja/specdojo/rulebooks/gl-rulebook.md