check-constitution-compliance

Assess workdir, pull request, or branch changes against constitution principles.

Updated Jun 4, 2025
One-click install
npx skills add https://github.com/alexei-lexx/budget --skill check-constitution-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-constitution-compliance
Source: https://github.com/alexei-lexx/budget/tree/main/.claude/skills/check-constitution-compliance
Command: npx skills add https://github.com/alexei-lexx/budget --skill check-constitution-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams verify that code changes comply with the project constitution, architecture rules, and coding standards.

Core Features & Use Cases

  • Audit changes against constitution principles to ensure architectural integrity and coding discipline.
  • Generate a structured report detailing which principles PASSED, FAILED, or were not applicable (N/A) for workdir changes, PRs, or branch diffs.
  • Flag violations with severity MAJOR or MINOR and provide precise justification for remediation.

Quick Start

Run constitution-compliance on your current changes or a PR/branch to generate a detailed report.

Frequently Asked Questions about check-constitution-compliance

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

FAQPage Schema
How do I check if my code changes comply with project architecture rules?

To check constitution compliance, you audit workdir changes, pull requests, or branch diffs against your project's principles. The tool reads your constitution, extracts assessable principles, and returns a structured report marking each principle as PASSED, FAILED, or N/A.

How do I generate a compliance report for a pull request diff?

Generating a compliance report for a pull request involves analyzing the PR diff against extracted constitution principles. The assessment produces a structured report listing each principle's status and documenting any violations with explicit MAJOR or MINOR severity and precise justification.

What is constitution compliance reporting in code review?

Constitution compliance reporting in code review is the process of verifying that code changes adhere to defined architecture rules and coding standards. It assesses diffs and returns a structured report detailing which principles PASSED, FAILED, or were not applicable.

Can I assess workdir changes against coding standards without a pull request?

Yes, you can assess workdir changes directly against project principles without a pull request. The tool evaluates the local code changes, extracts assessable principles from the constitution, and generates a detailed compliance report flagging violations with MAJOR or MINOR severity.

How are constitution violations documented for remediation?

Constitution violations are documented in a structured report with explicit severity levels. Each failed principle is flagged as either MAJOR or MINOR, accompanied by precise justification explaining the violation to guide developers in code remediation.

Does constitution compliance reporting work with any branch diff?

Yes, constitution compliance reporting works with any branch diff. You run the assessment on the branch changes, and it reads the constitution to extract principles, returning a structured compliance report that marks each principle as PASSED, FAILED, or N/A.