speckit-decision-audit

Audit a codebase against Architecture Decision Records and generate a severity report.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Satcomx00-x00/speckit-python --skill speckit-decision-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-decision-audit
Source: https://github.com/Satcomx00-x00/speckit-python/tree/main/skills/speckit-decision-audit
Command: npx skills add https://github.com/Satcomx00-x00/speckit-python --skill speckit-decision-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of auditing a codebase against accepted Architecture Decision Records (ADR), identifying code patterns that contradict the ADRs and those that are mandated but missing.

Core Features & Use Cases

  • Codebase Audit: Checks the codebase for compliance with ADRs.
  • Waiver Management: Considers waivers for specific ADRs.
  • Report Generation: Generates a detailed report of findings, including critical, high, medium, and low severity issues.
  • Use Case: Use this Skill to ensure that your codebase adheres to the established ADRs, identifying areas that need attention before merging code into the main branch.

Quick Start

Run the 'speckit-decision-audit' command to audit the codebase against all accepted ADRs.

Frequently Asked Questions about speckit-decision-audit

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

FAQPage Schema
How do I audit my codebase for ADR compliance?

Auditing codebase ADR compliance involves scanning your project against accepted Architecture Decision Records to identify non-compliant code patterns and missing mandated implementations. The Skill outputs a detailed report categorizing findings by severity levels.

What is an ADR compliance audit?

An ADR compliance audit checks your codebase against accepted Architecture Decision Records to find code patterns that contradict established decisions. It also identifies waived decisions and generates a report detailing critical, high, medium, and low severity issues.

Can I exclude specific Architecture Decision Records using a waiver registry?

You can manage ADR waivers by providing the Skill optional access to a waiver registry. It considers these waivers during the codebase audit, ensuring valid exclusions are respected while still flagging non-compliant code patterns in the final report.

Do I need a project constitution to check code against Architecture Decision Records?

You need access to your project constitution and accepted Architecture Decision Records to perform the audit. The Skill requires these inputs to identify code patterns that contradict the ADRs and detect mandated implementations that are missing.

What is the best way to identify missing mandated code patterns in my repository?

Automating an audit against your accepted ADRs is the best way to identify missing mandated code patterns. The Skill analyzes your codebase, considers any waiver registries, and generates a report detailing findings and their severity levels before merging code.