agentdev-traceability

Scans ADF-COVERS declarations to report requirement-artifact coverage, impact, and integrity checks.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-traceability-yogata
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentdev-traceability
Source: https://github.com/yogata/agent-dev-flow/tree/main/src/opencode/skills/agentdev-traceability
Command: npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-traceability-yogata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typescript, @types/bun, and includes scripts (resource) components.

What problem does it solve? Teams lose track of which design documents, implementation files, and verification artifacts cover each requirement, making change impact analysis and completeness audits manual and error-prone. This Skill resolves requirement-to-artifact traceability directly from explicit ADF-COVERS declarations embedded in source files, without relying on derived graphs or semantic inference. ## Core Features & Use Cases - Coverage queries: List all artifacts covering a requirement (forward lookup) or all requirements covered by an artifact (reverse lookup), with role tags (design / implementation / verification) and no truncation. - Impact analysis: Given a changed requirement or artifact, enumerate re-confirmation candidates via a fixed two-hop artifact-requirement-artifact traversal, with explicit notes that empty results do not prove absence of impact. - Integrity checks: Run seven deterministic checks (malformed declarations, unknown roles, unknown requirement references, invalid catalog entries, missing implementation, missing verification, unavailable evidence) plus a per-requirement verification classification report. - Use Case: Before closing a case, run the check CLI against the repository root to confirm every current requirement line has at least one implementation declaration and that all mandatory verification lines are covered, failing the gate if any check reports findings. ## Quick Start Ask the agent to run the traceability check over the repository, for example: run bun scripts/src/check.ts with --root pointing at the repo root and report any missing implementation or verification coverage for requirement REQ-0050-014.

Frequently Asked Questions about agentdev-traceability

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

FAQPage Schema
How do I check which artifacts cover a requirement?▼

Run the coverage CLI with --root pointing at the repository and --req set to the requirement line ID such as REQ-0050-014. It returns all design, implementation, and verification declarations for that requirement as JSON, with per-role counts and no truncation.

How do I find re-confirmation candidates after changing a file?▼

Run the impact CLI with --artifact set to the changed file path. It traverses artifact to requirement to artifact in a fixed two-hop pattern and lists other artifacts sharing the same requirements as re-check candidates.

What declaration format does the traceability scanner recognize?▼

Declarations use the form ADF-COVERS(role): REQ-NNNN-MMM inside the file type's comment syntax, such as an HTML comment line in Markdown or a // line comment in TypeScript. Roles are design, implementation, or verification, and prose mentions of the marker are ignored.

Why does the check command exit with code 2?▼

Exit code 2 means at least one of the seven integrity checks failed, such as malformed declarations, unknown requirement references, or missing implementation or verification coverage. Exit code 1 indicates an execution error, and 0 means all checks passed.

Can I limit the completeness check to specific requirements?▼

Yes, pass --req with a comma-separated list of individual requirement line IDs to scope the missing-implementation and missing-verification checks. Range syntax with .. is not expanded and is treated as a literal ID, so enumerate each line separately.

Does the scanner use a prebuilt graph or index?▼

No, it directly scans canonical .md and .ts artifacts under the given root each run, excluding .git, .agentdev, .worktrees, and node_modules. It performs line-based pattern matching only and never infers relationships semantically.