Skip to main content
GeneralSteveGJones

req-link

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

Stars
38
Source
SteveGJones/ai-first-sdlc-practices
Updated
2026-05-11
Slug
SteveGJones--ai-first-sdlc-practices--req-link
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/SteveGJones/ai-first-sdlc-practices/HEAD/plugins/sdlc-assured/skills/req-link/SKILL.md -o .claude/skills/req-link.md

Drops the SKILL.md into .claude/skills/req-link.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Skill: req-link

Use this skill when adding a satisfies: link between artefacts, OR when adding an inline # implements: annotation in source code. This skill validates that the target ID exists before writing the link.

Inputs

  • <source-id> — the artefact gaining the link (e.g., DES-auth-001)
  • <target-ids> — the ID(s) being satisfied (e.g., REQ-auth-001)

Steps

  1. Read the registry. Load library/_ids.md. Confirm every <target-id> exists.

  2. Locate the source artefact. Find the file declaring <source-id>.

  3. Insert the link.

    • For spec artefacts: insert **satisfies:** <target-ids> immediately after the ### <source-id> heading.
    • For code annotations: prompt for the function name; insert # implements: <target-ids> as the first line of the function body.

  4. Re-validate. Run id_uniqueness, cited_ids_resolve, forward_link_integrity. Report results.

  5. Commit the link (separate commit so it can be reverted independently).

Done criteria

  • Link inserted; target IDs verified to exist in the registry.
  • Validators pass after the link is added.
  • One commit, scope-limited to the link.