# Requirements Traceability

> 要件 ID を Law、テスト、コード、Telemetry、手動テストへ結び、トレーサビリティ行列とカタログ集約（状態・優先度・依存関係の棚卸し）を作る。要件から実装や検査へ配線したい、リンク漏れを見たい、要件を一覧化・棚卸ししたい、「traceability を作って」「REQ と test を結んで」「requirements catalog を更新して」「要件の棚卸しをして」と言われた時に使用する。

- Skill: `caphtech/requirements-traceability` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add caphtech/requirements-traceability`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caphtech/requirements-traceability/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: CAPHTECH (https://skillmd.com/u/caphtech)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/caphtech/requirements-traceability

---


# Requirements Traceability

## Overview

要件を孤立させず、下流アーティファクトへつなぐ。
実装、テスト、観測、手動確認がどの要件を支えているかを見える形にそろえる。
あわせて、状態・優先度・依存関係をまとめたカタログ集約も作る。

## Workflow

### Step 1: 要件の起点を集める

要件 YAML を読み、`id`、`title`、`guarantee`、`observable`、`links` を抽出する。
行列表現は references/traceability-matrix.md を使う。

### Step 2: 下流アーティファクトを結ぶ

最低でも次の列を埋める。

- Law
- automated tests
- code symbols
- telemetry
- manual checks

証拠が弱いリンクは `assumed` として分け、確定リンクと混ぜない。

### Step 3: 欠落を先に出す

次の欠落を優先して報告する。

- 要件はあるがテストがない
- 要件はあるが観測点がない
- テストはあるが支える要件IDがない
- コード変更点はあるが関連要件が結びついていない

### Step 4: 行列を更新する

出力は assets/templates/traceability-matrix.md の形に合わせる。
必要なら YAML 版でもよいが、レビューしやすい一覧を必ず作る。

### Step 5: カタログとして集約する

要件一覧、状態、優先度、依存関係をまとめて棚卸ししたい場合は、行列とは別に集約カタログを出力する。
状態遷移と依存の扱いは references/catalog-lifecycle.md を使う。
出力は assets/templates/requirements-catalog.yaml をベースに作り、最低限次をそろえる。

- `status_summary`（`draft | reviewed | active | deprecated | superseded` ごとの件数）
- `priority_summary`（`p0 | p1 | p2 | p3` ごとの件数）
- `dependency_edges`（`depends_on` / `blocks`）
- `supersession_edges`（`supersedes` / `related_to`）
- `orphan_requirements`（依存先や下流リンクが不明な要件）

`deprecated` と `superseded` を混同しない。`superseded` に変える時は置き換え先の要件IDを必ず書く。

### Step 6: 下流へ引き渡す

- 要件の質を検査する: `/requirements-inspector`
- 反例駆動の多層整合性を見る: `/requirements-consistency`
- 手動確認に落とす: `/requirements-manual-test`

## Output Contract

- traceability matrix
- カタログ集約（status_summary / priority_summary / dependency_edges / supersession_edges / orphan_requirements）
- orphan requirements
- orphan tests
- stale links
- 変更影響の候補