Markdown Editor

Requirements Traceability Matrix (RTM) Template

Forward and backward links from business need to tests and results, coverage metrics, orphan analysis, change impact

需求与分析标准ISO/IEC/IEEE 29148:2018traceabilitymatrixmath

使用方法: Use it from the first baseline onward to prove every need is built and tested and to size changes. Fix the ID conventions first. The main pitfall is filling the matrix only at the end, when links can no longer be reconstructed.

预览

Requirements Traceability Matrix: [Product or system name]

Requirements traceability matrix (RTM) linking each business need through stakeholder, system and software requirements to design, code, tests and results, in both directions. Structured to support the bidirectional traceability described in ISO/IEC/IEEE 29148:2018. Replace every [bracketed] value and every row marked Example.

FieldValue
Document ID[RTM-PRODUCT-001]
Version[0.1]
Status[Draft / In review / Baselined]
Owner[@requirements-owner]
Baseline[Requirements baseline ID, for example REQ-BL-2.0]
Last updatedYYYY-MM-DD
Source of truth[Tool or repository where links are maintained]

1. Purpose and scope

This matrix shows, for [Product name] [release], how every business need is realised by requirements, design elements and code, and how every requirement is verified. It is used to:

  • confirm that every agreed need is delivered and tested (coverage);
  • find requirements, components or tests with no parent (orphans);
  • assess the impact of a proposed change before it is approved;
  • give auditors and customers evidence of verification.

Out of scope: [artefacts not traced, for example UI copy, internal tooling].

2. ID conventions

ArtefactPrefix and formatIssued inExample
Business need / objectiveBN-nnnBusiness case / BRSBN-004
Stakeholder requirementSTK-UR-nnnStRSSTK-UR-012
System requirementSYS-<type>-nnnSyRSSYS-FR-020
Software requirementSRS-<type>-nnnSRS / backlogSRS-FR-031
Design elementDES-<component> or ADR-nnnArchitecture descriptionDES-SYNC, ADR-007
Code componentRepository path or moduleSource controlservices/sync
Test caseTC-<area>-nnnTest management toolTC-SYNC-004
Test resultRun IDCI or test toolRUN-2026-118

Link types used: derives (child requirement from parent), satisfies (design or code satisfies a requirement), verifies (test verifies a requirement).

3. Forward traceability

Business needStakeholder reqSystem reqSoftware reqDesignCode / componentTestResult
Example: BN-004STK-UR-010SYS-FR-020SRS-FR-031DES-SYNCservices/syncTC-SYNC-001Pass (RUN-118)
Example: BN-004STK-UR-010SYS-FR-021SRS-FR-032DES-SYNC, ADR-007services/sync/queueTC-SYNC-004Fail (RUN-118)
Example: BN-002STK-UR-002SYS-FR-010SRS-FR-012DES-DISPATCHservices/dispatchTC-DSP-002Pass (RUN-117)
Example: BN-006STK-UR-030SYS-PL-001SRS-FR-050DES-REPORTSnonenoneNot started
[BN-nnn][STK-UR-nnn][SYS-xx-nnn][SRS-xx-nnn][DES-x][path][TC-x-nnn][Pass / Fail / Not run]

4. Backward traceability

Test caseVerifiesSoftware reqSystem reqStakeholder reqBusiness need
Example: TC-SYNC-001SRS-FR-031SRS-FR-031SYS-FR-020STK-UR-010BN-004
Example: TC-UI-077nonenonenonenonenone (orphan test)
[TC-x-nnn][ID][ID][ID][ID][ID]
ComponentSatisfiesBusiness need
Example: services/syncSRS-FR-031, SRS-FR-032BN-004
Example: services/legacy-exportnonenone (orphan component)
[path][IDs][BN-ID]

5. Coverage metrics

Requirement coverage by tests and verification pass rate are calculated as:

Ctest=∣Rwith≥1 test∣∣Rapproved∣×100%Pverified=∣Rall tests passed∣∣Rapproved∣×100%C_{test} = \frac{|R_{\text{with}\ge 1\text{ test}}|}{|R_{\text{approved}}|} \times 100\% \qquad P_{verified} = \frac{|R_{\text{all tests passed}}|}{|R_{\text{approved}}|} \times 100\%
MetricFormula / definitionTargetCurrentTrend
Forward coverage to testsCtestC_{test}100% for Must[n]%[Up / Down / Flat]
Verified requirementsPverifiedP_{verified}95% at release[n]%[Trend]
Backward coverage of needsNeeds with at least one requirement / all needs100%[n]%[Trend]
Design coverageRequirements with a satisfying design element / approved100%[n]%[Trend]
Orphan testsTests with no requirement link0[n][Trend]
Orphan componentsComponents with no requirement link0[n][Trend]

Example: 186 approved requirements, 179 with at least one test: Ctest=179/186=96.2%C_{test} = 179 / 186 = 96.2\%.

6. Orphan and gap analysis

IDTypeItemFindingActionOwnerDueStatus
GAP-01Untested requirementSRS-FR-050No design, code or test yetPlan in sprint 14[@lead]YYYY-MM-DDOpen
GAP-02Orphan testTC-UI-077Tests a removed featureDelete test[@qa]YYYY-MM-DDOpen
GAP-03Orphan componentservices/legacy-exportNo requirement; used by financeRaise requirement or retire[@po]YYYY-MM-DDOpen
GAP-04Failed verificationSRS-FR-032TC-SYNC-004 failsDefect BUG-412[@dev]YYYY-MM-DDOpen
[GAP-nn][Type][Item][Finding][Action][@name]YYYY-MM-DD[Status]

7. Change impact procedure

  1. Identify the item to change (requirement, design element or component) and record the change request ID.
  2. Trace up to find the stakeholder requirements and business needs affected; confirm with their owners that the change is acceptable.
  3. Trace down to list every derived requirement, design element, code component and test that may change.
  4. Estimate effort and risk for each affected item and record it in the change request.
  5. After approval, update links in the same change that modifies the items; re-run the affected tests and record results.
  6. Recalculate the coverage metrics in section 5 and note the change in the revision table.
Change requestItem changedUpstream affectedDownstream affectedTests to re-runDecision
Example: CR-031SYS-FR-020 (offline 12 h to 24 h)STK-UR-010, BN-004SRS-FR-031, DES-SYNC, services/syncTC-SYNC-001 to 006[Approved / Rejected]
[CR-nnn][ID][IDs][IDs][TC IDs][Decision]

8. Revision history

VersionDateAuthorChange summary
0.1YYYY-MM-DD[@name]Initial matrix for baseline [n]
[x.y]YYYY-MM-DD[@name][Links added, gaps closed, metrics updated]

Standard and licence note

Structure aligned with ISO/IEC/IEEE 29148:2018, Systems and software engineering: Life cycle processes, Requirements engineering, in its treatment of bidirectional requirements traceability. This template is original text written for this collection and reproduces no text from the standard; obtain the standard for its normative requirements. Template licence: MIT.

相关模板