constitution-checker

Validates project constitutions and enforces tier-specific rules for flowspec workflows.

50|9|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/jpoley/flowspec --skill constitution-checker-jpoley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: constitution-checker
Source: https://github.com/jpoley/flowspec/tree/main/templates/skills/constitution-checker
Command: npx skills add https://github.com/jpoley/flowspec --skill constitution-checker-jpoley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams ensure project constitutions are complete and valid before running flowspec commands, preventing misconfigurations and unsafe executions.

Core Features & Use Cases

  • Detects constitution presence and tier (Light, Medium, Heavy) to apply appropriate checks.
  • Counts NEEDS_VALIDATION markers and reports which sections require attention.
  • Provides clear preflight guidance and actionable next steps to initialize or fix memory/constitution.md.
  • Integrates at the start of /flow:* commands to guard workflows and maintain governance.

Quick Start

  • Run initialization if missing: flowspec init --here
  • Validate current constitution: flowspec constitution validate
  • Show current constitution: flowspec constitution show

Frequently Asked Questions about constitution-checker

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

FAQPage Schema
How do I validate a project constitution before running workflow commands?

Constitution validation checks that your project's constitution file is complete and properly configured before workflow execution. Run `flowspec constitution validate` to detect tier level, identify sections marked NEEDS_VALIDATION, and receive actionable guidance on what requires attention.

What does a constitution tier (Light, Medium, Heavy) mean in workflow governance?

Constitution tiers classify the governance strictness applied to your workflows. The skill detects your tier based on constitution content, then enforces tier-specific validation rules and reporting—Light requires minimal checks, while Heavy enforces comprehensive preflight validation across all workflow sections.

Can I skip constitution validation when running flowspec commands?

Yes, you can bypass constitution validation using the `--skip-validation` flag when running flowspec workflow commands. However, this skips preflight checks and guidance, so use it only when you're certain your constitution is valid or intentionally bypassing governance temporarily.

How do I initialize a constitution if my project doesn't have one?

Run `flowspec init --here` to create an initial constitution file at memory/constitution.md. The skill will then detect its presence on your next workflow command and apply tier-detection and validation checks based on the initialized constitution structure.

What sections of my constitution need validation attention?

The skill scans your constitution for NEEDS_VALIDATION markers and reports which sections require attention. Run `flowspec constitution show` to view your current constitution, then address flagged sections to meet the validation requirements for your detected tier level.