constitution-checker

Validates codebase compliance with the defined project constitution and outputs a pass/fail report.

3|5|Updated Dec 19, 2025

Search Tags:#verification #compliance #constitution #policy #PR #code-review

Ready to run

npx skills add https://github.com/drillan/note-mcp --skill constitution-checker

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: constitution-checker
Source: https://github.com/drillan/note-mcp/tree/main/.claude/skills/constitution-checker
Command: npx skills add https://github.com/drillan/note-mcp --skill constitution-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates that code and documentation comply with the project's constitution defined in .specify/memory/constitution.md, helping prevent violations before merging changes.

Core Features & Use Cases

Comprehensive Article checks: Verifies all constitution Articles for code and docs.
Violation reporting: Generates actionable remediation guidance when issues are found.
Pre-PR & review helper: Assists during PR creation and code reviews to ensure compliance.

Quick Start

Ask Claude to run a constitution check before creating a PR or during code reviews.

Frequently Asked Questions about constitution-checker

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

FAQPage Schema

How do I verify my codebase complies with project constitution rules?▼

Constitution compliance verification validates your code and documentation against articles defined in .specify/memory/constitution.md, checking adherence to quality standards like type safety, naming conventions, and documentation integrity. Run a check during PR preparation or code reviews to catch violations before merging.

What does a constitution compliance check actually validate?▼

The check verifies non-negotiable and recommended articles covering automated quality checks (ruff, mypy), test-first enforcement, data accuracy, DRY principles, Python type safety, naming conventions, and documentation integrity. It outputs pass/fail status with detailed remediation guidance for any violations found.

When should I run a constitution check in my development workflow?▼

Run constitution checks during implementation completion, before creating a pull request, and during code reviews. This catches compliance violations early and ensures adherence to project standards before changes are merged.

Can I use constitution checking for policy and compliance enforcement across teams?▼

Yes. Constitution checking enforces project-wide policies and compliance standards by validating that all code and documentation meet defined requirements, making it suitable for team code reviews and automated quality gates.

What happens when the constitution check finds violations?▼

The Skill generates a detailed compliance report identifying which articles were violated and provides actionable remediation guidance so you can fix issues before merging code.

Do I need to configure anything before running a constitution check?▼

Your project must have a constitution defined in .specify/memory/constitution.md. Once that file exists with your project's articles and standards, you can request a constitution check without additional setup.