req-link

Validate target IDs in the registry before inserting satisfies links between artefacts.

41|6|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill req-link
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: req-link
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-assured/skills/req-link
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill req-link

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adding a satisfies link between artefacts requires ensuring the target ID exists in the registry to prevent broken references and maintain traceability.

Core Features & Use Cases

  • Validate the registry to confirm target IDs exist before linking.
  • Locate the source artefact and insert the appropriate satisfies link in the correct location.
  • Re-validate link integrity and commit the change in a separate, reversible step.

Quick Start

Add a satisfies link from a DES → REQ, TEST → REQ/DES, or CODE annotation → ID after confirming every target ID exists in the registry.

Frequently Asked Questions about req-link

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate target IDs before inserting artefact links?

To validate target IDs before inserting artefact links, the system reads the registry to confirm every target ID exists, preventing broken references and maintaining traceability across artefacts and source code.

What is the best way to add satisfies links between requirements and design artefacts?

Adding satisfies links between requirements and design artefacts involves locating the source artefact, inserting the appropriate satisfies link at the correct insertion point, re-validating link integrity, and committing the change separately.

Can I link code annotations to requirement IDs across source code?

Yes, you can link code annotations to requirement IDs across source code. The process validates the target ID exists in the registry before writing the link to maintain traceability and prevent broken references.

Do I need read access to the registry to prevent broken artefact references?

Yes, you need read access to the library/_ids.md registry to prevent broken artefact references. This read access allows the system to confirm target IDs exist before attempting to insert any satisfies links.

Why does my satisfies link insertion require a separate commit?

Your satisfies link insertion requires a separate commit to record the changes in a reversible step. After locating the artefact, inserting the link, and re-validating integrity, a separate commit isolates the traceability update.