trace-check

Validate bidirectional traceability across SDD documentation artifacts.

16|3|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill trace-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace-check
Source: https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/trace-check
Command: npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill trace-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the validation and update of bidirectional traceability across all SDD artifacts, ensuring link consistency, ID format compliance, and cumulative tagging hierarchy, preventing gaps in audit trails and improving impact analysis.

Core Features & Use Cases

  • Bidirectional & Cumulative Tagging Validation: Verify upstream/downstream link symmetry and ensure each artifact includes all required tags from previous functional layers.
  • ID Format & Link Resolution: Validate document ID formats and ensure all markdown links and anchors resolve correctly to their targets.
  • CTR Dual-File Compliance: Mandatorily check that all API contract (CTR) artifacts have both .md and .yaml files with matching slugs and valid schemas.
  • Use Case: Before a regulatory audit, use this skill to automatically scan all project documentation and code for traceability gaps, broken links, and ensure all API contracts are properly defined, auto-fixing minor issues and reporting critical non-compliance.

Quick Start

Use the trace-check skill to validate traceability for all artifacts in '/opt/data/ibmcp/docs/' with strictness level 'strict' and auto-fix enabled.

Frequently Asked Questions about trace-check

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

FAQPage Schema
How do I validate traceability links across SDD documentation?

Traceability validation ensures bidirectional consistency between Business, Architecture, Requirements, and Testing artifacts. This Skill scans all SDD documents, verifies upstream/downstream link symmetry, validates ID formats, resolves broken markdown links and anchors, and auto-fixes minor issues while reporting compliance gaps.

What is cumulative tagging and why does it matter for audit compliance?

Cumulative tagging requires each artifact to inherit and include all tags from previous functional layers, creating an unbroken chain of traceability. This prevents audit trail gaps and enables impact analysis by ensuring every requirement traces back through architecture to business objectives.

How do I ensure API contracts have matching markdown and YAML files?

CTR dual-file compliance checks that every API contract artifact has both `.md` and `.yaml` files with matching slugs and valid schemas. This Skill validates the pairing automatically, ensuring contract definitions are complete and consistent across documentation and specification formats.

Can I auto-fix traceability issues or do I need manual review?

This Skill performs automatic backup and auto-fix of minor traceability issues while flagging critical non-compliance for manual review. You control the strictness level and choose which fixes to apply, balancing automation with oversight.

What file formats and artifact types does traceability validation support?

Traceability validation applies to markdown documents, YAML schema files, and structured SDD artifacts across Business, Architecture, Requirements, and Testing layers. It validates markdown links, anchors, ID hierarchies, and ensures all artifacts follow defined tag and format conventions.

When should I run traceability checks in my documentation workflow?

Run traceability validation before regulatory audits, major releases, or when updating requirements and architecture. Automated scanning identifies broken links, missing tags, and format violations early, reducing rework and audit risk.