Overview

The Constitution skill manages the architectural DNA of a project through two shared documents:

File

Purpose

docs/specs/architecture.md

Technology stack, infrastructure, architectural rules, security constraints, AI guardrails

docs/specs/ontology.md

Domain glossary (Ubiquitous Language) — terms, definitions, bounded contexts

These files live at

docs/specs/

and are shared across all specifications. Unlike a monolithic

constitution.md

, these are created/enriched by

brainstorm

(Phase 6.8.6) and

spec-to-tasks

(Phase 1.5).

Instructions

Identify the operation from

$ARGUMENTS

or user intent:

create

,

update

,

check

, or

show

.

For

create

ask which files to create (architecture.md, ontology.md, or both), gather required information via

AskUserQuestion

, then write the files using the templates below.

For

update

identify the target file and section, apply the change surgically, update the

Last Updated

date.

For

check

read both constitution files, read the target file, validate against architectural rules and ontology terms, output a Constitution Check Report.

For

show

read and display both files formatted for readability. Always confirm with the user before writing or overwriting files. Show more Installs 559 Repository giuseppe-trisci…oper-kit GitHub Stars 291 First Seen May 4, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Pass