code-tag-audit

Extract and validate domainspec code-tag mappings against feature-spec documentation.

20|3|Updated May 14, 2026
One-click install
npx skills add https://github.com/cyberAlchemyAI/Arcanum --skill code-tag-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-tag-audit
Source: https://github.com/cyberAlchemyAI/Arcanum/tree/main/arcana/code-tag-audit
Command: npx skills add https://github.com/cyberAlchemyAI/Arcanum --skill code-tag-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deterministic code-tag traceability ensures code-to-spec alignment by extracting domainspec tags, validating them against a schema, and surfacing drift vs the feature registry.

Core Features & Use Cases

  • Extraction, validation, drift detection, and composability checks for code-tag edges across codebases.
  • Works with domainspec-tagged source files and corresponding SPEC.md documentation to surface mismatches and ensure governance.
  • Supports waivers and a structured reporting format to integrate with governance processes and quality gates.

Quick Start

Run the code-tag audit against your repository to generate a drift report and validation results.

Frequently Asked Questions about code-tag-audit

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

FAQPage Schema
How do I detect drift between code and feature specifications?

To detect drift between code and feature specifications, extract domainspec tags from source files and compare them against the feature registry. This surfaces mismatches and validation gaps to ensure code-to-spec alignment.

What is deterministic code-tag traceability and when do I need it?

Deterministic code-tag traceability ensures code-to-spec alignment by mapping code tags to documentation. You need it when validating domainspec annotations against a schema to maintain governance across annotated codebases.

How do I audit domainspec tags across my codebase?

You audit domainspec tags by running an extraction process against source files and corresponding SPEC.md documentation. This performs validation, drift comparison, and composability checks, outputting a structured report.

Can I enforce strict validation rules for code-tag mappings?

Yes, you can enforce strict validation rules for code-tag mappings using strict and warn modes. Strict mode fails governance checks on schema validation gaps, while warn mode surfaces drift without blocking quality gates.

Does code-tag auditing support waivers for validation gaps?

Yes, code-tag auditing supports waivers for validation gaps. Waivers allow specific drift or composability issues to bypass strict quality gates, integrating structured reporting with existing governance processes.

What is the best way to check code-tag composability issues?

The best way to check code-tag composability issues is to perform static analysis on domainspec-tagged source files. This identifies edge mapping conflicts and validation gaps against the feature registry schema.