Skip to main content
skill CX Codex

constitution — Claude Code skill for project rules

This skill examines a codebase and drafts a project constitution grounded in its existing patterns. Use it to establish or revise governance rules with file-and-line evidence.

MIT ★ 587 updated 2026-10-26

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Open on GitHub

What constitution does

The skill checks for CONSTITUTION.md at the project root. If it finds one, it reads the current rules and prepares an update; otherwise, it starts from template.md. You can name focus areas to guide what it investigates.

Specialist agents explore relevant perspectives in parallel. They return candidate rules with file-and-line references, which the skill deduplicates, groups by category, and assigns levels L1, L2, or L3. Every proposed rule needs specific codebase evidence.

You review the proposals before anything is written: approve them, request changes, or cancel. Once approved, the skill creates or merges CONSTITUTION.md, then offers validation through the constitution mode of the validate skill. Your approval gates the file change.

What it helps with

  • derive project rules from patterns already present in the code
  • revise an existing CONSTITUTION.md with approved findings
  • attach file-and-line evidence to each proposed rule
  • sort governance rules into L1, L2, and L3 levels

Example prompts for the agent

  • Run /constitution and inspect the project’s security and testing practices.
  • Update the project constitution using the architecture patterns found in the codebase.
  • Draft project rules with file-and-line evidence, then wait for my approval before writing them.

How to install constitution

1Plugin marketplace

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

This installs the whole start plugin with all its skills

2Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill constitution -a claude-code

3Manually: put the files in place

~/.claude/skills/constitution/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/constitution/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about constitution

How do I install constitution in Claude Code?

Add the marketplace with /plugin marketplace add rsmdt/the-startup, then install the plugin with /plugin install start@the-startup.

What does the constitution skill do?

It examines project patterns and proposes rules for CONSTITUTION.md, assigning each a level and citing file-and-line evidence. It writes changes only after approval.

Can constitution update an existing project constitution?

Yes. When CONSTITUTION.md exists at the project root, the skill reads its current rules and merges approved additions into it.

Source text

SKILL.md · MIT
---
name: constitution
description: Create or update a project constitution with governance rules. Uses discovery-based approach to generate project-specific rules.
user-invocable: true
argument-hint: "optional focus areas (e.g., 'security and testing', 'architecture patterns for Next.js')"
---

## Persona

Act as a governance orchestrator that coordinates parallel pattern discovery to create project constitutions.

**Focus Areas**: $ARGUMENTS

## Interface

Rule {
  level: L1 | L2 | L3        // Must (autofix) | Should (manual) | May (advisory)
  category: string            // Security, Architecture, CodeQuality, Testing, or custom
  statement: string           // the rule itself
  evidence: string            // file:line references supporting the rule
}

State {
  focusAreas = $ARGUMENTS
  perspectives = []              // from reference/perspectives.md
  existing: boolean
  discoveries: Rule[]
}

## Constraints

**Always:**
- Delegate all discovery to specialist agents.
- Launch all applicable discovery perspectives simultaneously in a single response.
- Discover actual codebase patterns before proposing rules.
- Present discovered rules for user approval before writing.
- Classify every rule with a level (L1/L2/L3).
- Every proposed rule must cite specific file:line evidence.

## Reference Materials

- reference/perspectives.md — discovery perspectives and focus area mapping
- reference/rule-patterns.md — level system, rule types, scope patterns
- reference/output-format.md — update mode options and presentation guidelines
- reference/scenarios.md — create, create with focus, and update scenarios
- examples/output-example.md — expected output format
- examples/CONSTITUTION.md — complete constitution example
- template.md — constitution template

## Workflow

### 1. Check Existing

match (CONSTITUTION.md at project root) {
  exists     => read and parse existing rules, route to update flow
  not found  => read template.md, route to creation flow
}

### 2. Discover Patterns

Read reference/perspectives.md. Select applicable perspectives based on $ARGUMENTS.

Launch parallel agents for each perspective. Each agent explores the codebase and returns proposed Rules with evidence.

### 3. Synthesize

Process discoveries:
1. Deduplicate overlapping patterns.
2. Classify each rule with level (L1/L2/L3) per reference/rule-patterns.md.
3. Group by category.

### 4. Present Rules

Read reference/output-format.md and format proposed rules accordingly.

Ask the user to choose: Approve rules | Modify before saving | Cancel

### 5. Write Constitution

match (existing) {
  true  => merge approved rules into existing CONSTITUTION.md
  false => write new CONSTITUTION.md from template + approved rules
}

Display constitution summary per reference/output-format.md.

### 6. Validate

Ask the user to choose: Run validation now | Skip

match (choice) {
  validate => use the validate skill in constitution mode
  skip     => done
}

© Rudolf S. · MIT · rsmdt/the-startup

Similar skills

SKILL.md skills catalog →
speckit-constitution github-spec-kit The speckit-constitution skill writes and updates the project constitution in .specify/memory/constitution.md, turning your principles into a versioned governance doc. CX Codex +1 2,500installs speckit.constitution Chat2AnyLLM The speckit.constitution command edits a project’s constitution and checks related templates and guidance for alignment. Use it when development principles or governance rules change. CX Codex +1 ★ 117repo stars find-skills vercel-labs find-skills is a Claude Code skill that locates agent skills for a task and helps assess the results. It activates when someone asks for a capability that may already be installable. CX Codex +1 4,400,000installs frontend-design official anthropics The frontend-design skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. CX Codex +1 1,025,790installs agent-browser vercel-labs This Claude Code skill automates browser interaction for tasks like navigating sites, filling forms, and testing web apps. It also supports exploratory QA and Electron app automation. CX Codex +1 1,600,000installs design-taste-frontend Leonxlnx The design-taste-frontend Claude Code skill sets design rules and checks for websites. It activates for new pages, redesigns, and requests to fix a generic-looking site. CX Codex +1 802,600installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. CX Codex +1 1,424,476installs grill-with-docs Matt Pocock The grill-with-docs skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. CX Codex +1 1,219,756installs

From the same set50

The whole set →
code-quality-review code-quality-review evaluates code across eight dimensions, prioritizing correctness and security risks over cosmetic formatting. CX Codex +1 ★ 587repo stars domain-modeling The domain-modeling skill turns business rules into domain models, aggregate boundaries, and storage decisions. Use it when shaping a business model or changing schema consistency rules. CX Codex +1 ★ 587repo stars project-discovery project-discovery is a Claude Code skill that maps a codebase’s structure, tech stack, entry points, and documentation mismatches against actual code. CX Codex +1 ★ 587repo stars user-research Plans user research studies, analyzes usability tests and customer interviews, and turns findings into prioritized product recommendations. CX Codex +1 ★ 587repo stars research-user research-user — a subagent for planning and conducting user research. Surfaces genuine user motivations and pain points before building features, when conversion drops, or when your team disagrees on what users actually need. CX Codex ★ 587repo stars design-visual design-visual — a design-systems subagent for Claude Code that establishes design tokens, component standards, and WCAG 2.1 AA accessibility foundations. CX Codex ★ 587repo stars research-product research-product — a subagent for Claude Code that transforms strategic uncertainty and vague requirements into prioritized decisions. Analyzes market and competitors, elicits and reconciles requirements, resolves stakeholder conflicts. CX Codex ★ 587repo stars feature-prioritization feature-prioritization applies RICE, MoSCoW, Kano, and value-effort frameworks to rank backlog items. Turns feature debates into structured decisions with documented rationale. CX Codex +1 ★ 587repo stars

Project sponsors

Companies that keep this analytics open