What is a Constitution?

A Constitution is a document that defines the rules, guidelines, and conventions for spec authoring within your organization or project. It serves as a shared contract for how specifications should be written, structured, and reviewed.

Types

There are two levels of constitution:

Tenant Constitution

Defines organization-wide spec conventions that apply to all spaces and projects within your tenant.

Project Constitution

Extends or overrides the tenant constitution for a specific project, allowing per-project customization of spec conventions.

Managing Constitutions

Constitutions can be managed from the dashboard under the Constitution page. The CLI also provides a constitution command group:

specbridge constitution add              # Stage constitution file
specbridge constitution status           # Show staged/unstaged changes
specbridge constitution commit -m <MSG>  # Commit constitution
specbridge constitution log              # Show history
specbridge constitution checkout <REF>   # Restore previous version
specbridge constitution revert <REF>     # Undo a commit

The constitution is versioned alongside your specs, so you can track how your conventions evolve over time.