What is a project constitution in this context?

A project constitution is a markdown file (CONSTITUTION.md) that defines your project's North Star mission, core design principles, and prohibited anti-patterns.

Can I use this during a Pull Request review?

Yes, it is highly effective for reviewing PRs that introduce significant architectural changes to ensure they don't violate established patterns.

Does this skill require a specific file structure?

It specifically looks for a .wrangler/CONSTITUTION.md file to extract the principles and framework used for the evaluation.

How does this skill prevent scope creep?

It forces a systematic review of every proposal against the project's mission, identifying features that are 'interesting but misaligned' before development begins.

Constitutional Alignment Checker

Name: Constitutional Alignment Checker
Author: samjhecht

bysamjhecht

•

Herramientas de Colaboración

Evaluates feature requests and pull requests against project principles to prevent scope creep and maintain design integrity.

Acerca de

The Constitutional Alignment Checker is a strategic governance tool that ensures every development decision aligns with your project's core mission. By systematically auditing proposals against a local CONSTITUTION.md file, the skill evaluates changes based on user value, simplicity, maintainability, and mission scope. It acts as an intelligent firewall, helping maintainers identify anti-patterns early and providing structured recommendations to approve, revise, or reject new features based on established project values.

Características Principales

Detailed analysis of user value, simplicity, and long-term maintainability
Systematic evaluation using a five-point project decision framework
Clear actionable recommendations: Approve, Revise, or Reject
1 GitHub stars
Structured audit trails with mandatory usage announcements
Automated extraction of principles and anti-patterns from project docs

Casos de Uso

Vetting new feature requests before starting technical specifications
Reviewing high-impact pull requests for alignment with design values
Auditing roadmap updates to ensure long-term project focus

Acerca de

Características Principales

Detailed analysis of user value, simplicity, and long-term maintainability
Systematic evaluation using a five-point project decision framework
Clear actionable recommendations: Approve, Revise, or Reject
1 GitHub stars
Structured audit trails with mandatory usage announcements
Automated extraction of principles and anti-patterns from project docs

Casos de Uso

Vetting new feature requests before starting technical specifications
Reviewing high-impact pull requests for alignment with design values
Auditing roadmap updates to ensure long-term project focus