spec-drift-audit

Audits implemented code, tests, and documentation against approved specifications to detect drift before closeout.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/oleyna80/agentic-sdlc-framework --skill spec-drift-audit-oleyna80
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-drift-audit
Source: https://github.com/oleyna80/agentic-sdlc-framework/tree/main/skills/spec-drift-audit
Command: npx skills add https://github.com/oleyna80/agentic-sdlc-framework --skill spec-drift-audit-oleyna80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementation, delivered code often diverges from the approved specification, architecture decisions, or plan without anyone noticing. This Skill systematically compares normative intent against delivered artifacts so mismatches are caught and classified before successful closeout. ## Core Features & Use Cases - Requirement-to-Evidence Mapping: Maps each approved requirement to implementation evidence, verification evidence, and documentation, classifying every mismatch (missing implementation, unspecified behavior, stale plan, stale tests, stale docs). - Structured Drift Verdicts: Produces a drift report with a clear verdict (ALIGNED, ALIGNMENT_REQUIRED, BLOCKED, UNVERIFIED) that gates successful closeout. - Read-Only Audit Authority: Operates with read-only access to source, runtime, and data, writing only the approved drift report path. - Use Case: After a feature changes API contracts and authentication flows across five files, run this audit before closeout to confirm the implementation, tests, and docs still match the approved spec and to surface any unapproved behavior. ## Quick Start Audit the current Work Block's implementation against its approved specification and produce a drift report with a verdict before closeout.

Frequently Asked Questions about spec-drift-audit

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

FAQPage Schema
How do I check if my implementation still matches the approved specification?▼

Run a specification drift audit that maps each approved requirement to implementation evidence, test evidence, and documentation. Every mismatch is classified (missing implementation, unspecified behavior, stale plan, stale tests, stale docs) and summarized in a drift report with a verdict.

When should a specification drift audit be run?▼

Run it before successful closeout whenever public behavior, API contracts, schemas, security boundaries, or runtime configuration changed, when three or more implementation files changed, or when the spec changed during implementation. It can be skipped only for documented quick fixes with no behavior or contract impact.

What is the difference between code review, verification, and drift audit?▼

Code review checks the quality and risk of the diff, verification checks observable behavior against acceptance criteria, and drift audit checks agreement between normative intent (spec, architecture decisions, plan) and the delivered artifacts. They are complementary gates, not substitutes.

What verdicts can a drift audit produce and what do they mean?▼

Verdicts are ALIGNED, ALIGNMENT_REQUIRED, BLOCKED, and UNVERIFIED. Only ALIGNED lets the drift gate pass; ALIGNMENT_REQUIRED means correctable drift exists, BLOCKED means a material requirement or architecture mismatch, and UNVERIFIED means required evidence was unavailable.

Can the drift auditor fix the specification or code it finds misaligned?▼

No. The auditor has read-only authority over source code, runtime, infrastructure, and data, and may write only the approved drift report path. It must not silently change the spec, code, tests, or documentation to make results appear aligned.