spec-compliance

Convert spec claims into AST-based acceptance assertions and verify them against source code.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/terrene-foundation/kailash-coc-claude-rb --skill spec-compliance-terrene-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-compliance
Source: https://github.com/terrene-foundation/kailash-coc-claude-rb/tree/main/.claude/skills/spec-compliance
Command: npx skills add https://github.com/terrene-foundation/kailash-coc-claude-rb --skill spec-compliance-terrene-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents false confidence by ensuring that implementation matches the written spec using direct code inspection rather than relying on “file exists” signals.

Core Features & Use Cases

  • Spec → acceptance assertions: Translates each spec promise into literal, checkable acceptance assertions.
  • AST-precise verification: Uses ast.parse-style reasoning (where applicable) to validate class/method signatures and structure instead of brittle path checks.
  • Security- and integrity-focused audit gates: Detects common failure modes like fake streaming behavior, missing deprecated decorators at required call sites, copied-not-moved modules, absent test coverage for new modules, and missing security-threat tests.

Quick Start

Use it with the command that triggers Step 1 of the red team process to run a spec compliance audit against the current codebase.

Frequently Asked Questions about spec-compliance

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

FAQPage Schema
How do I verify spec compliance in code using AST parsing instead of brittle file checks?

Spec compliance is verified by converting spec claims into concrete acceptance assertions and validating them through AST parsing to inspect class and method signatures directly, avoiding brittle path checks. This ensures implementation matches the written spec.

What is the best way to audit code for security threats and missing test coverage?

Auditing code for security threats involves mapping security-threat tests to new modules and verifying test coverage presence using AST- or grep-based evidence. This detects fake streaming behavior, missing decorators, and absent tests before knowledge capture.

How do I check that deprecated decorators are present at required call sites?

Checking deprecated decorators requires converting spec promises into acceptance assertions and using AST-precise verification to inspect required call sites. This grep-based evidence gathering confirms decorators exist rather than trusting self-report artifacts.

Does spec compliance verification work without relying on prior-round self-report artifacts?

Spec compliance verification explicitly bans trust in prior-round self-report artifacts. It requires direct code inspection using AST- or grep-based evidence for each assertion, including signature checks, field verification, and test coverage presence.

When should I run a spec compliance audit in a red team process?

A spec compliance audit should run during Step 1 of the red team process or as a validation gate before knowledge capture in coding workflows. It ensures implementation matches the spec by requiring concrete evidence for each acceptance assertion.

How do I detect copied-not-moved modules during a code audit?

Detecting copied-not-moved modules is done by translating spec claims into acceptance assertions and running move or shim checks using AST- or grep-based evidence. This security-focused audit gate prevents false confidence from incomplete module migrations.