How does the tier system work?

The system uses three tiers: Light (warns of unvalidated sections), Medium (requires user confirmation), and Heavy (blocks execution until all sections are validated).

Can I bypass a validation block for urgent tasks?

Yes, you can include the --skip-validation flag with your /flow commands to bypass the checker in emergency situations.

What happens if no tier is specified in my constitution?

The skill defaults to the Medium tier, which warns you of unvalidated sections and asks for your confirmation before proceeding.

What is a project constitution in this context?

A project constitution is a markdown file located at memory/constitution.md that defines a project's core identity, technology stack, and quality standards using the Flowspec framework.

How do I mark a section as needing validation?

You can add a comment tag in the format within your constitution.md file.

Constitution Checker

Name: Constitution Checker
Author: jpoley

byjpoley

•

Productivity & Workflow

Validates project constitution status and enforces tier-based compliance rules before executing workflow commands.

The Constitution Checker is a specialized workflow gatekeeper designed for the Flowspec ecosystem to ensure project alignment before development begins. It automatically scans the 'memory/constitution.md' file for unvalidated sections and enforces tier-based compliance—ranging from simple warnings in Light tier to mandatory execution blocking in Heavy tier. By requiring validation of core project identity, tech stacks, and quality standards, this skill prevents architectural drift and ensures that AI-driven coding tasks strictly adhere to the established project roadmap.

Key Features

015 GitHub stars

02Scanning for NEEDS_VALIDATION markers within project documentation

03Emergency bypass support via the --skip-validation flag

04Tier-based enforcement logic including warnings, confirmations, and hard blocks

05Automatic detection of constitution tiers (Light, Medium, Heavy)

06Pre-flight integration for all /flow:* workflow commands

Use Cases

01Preventing accidental command execution before project goals are defined

02Enforcing project-wide standards and architecture in collaborative environments

03Guiding developers through initial project setup and specification steps

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoley/flowspec constitution-checker

For use in Claude.ai and ChatGPT

Download Skill