Constitution
The principles every spec and every agent must follow.
- Only project owners can write it. Every write creates a new revision with a new version, and old ones are kept.
- Agents read it with
get_constitutionbefore they write specs and plans. - On plans with constitution inheritance, a project inherits its organization's constitution. Inherited principles are read-only in the project: a project can add principles, never weaken inherited ones.
- To start,
get_templatereturns the global template, and the Templates gallery offers 60 constitutions for languages, frameworks and engines and 45 specs for problems every team solves, searchable by kind, language and area.
Writing it
put_constitution takes the full markdown body, a new version that differs from the current one, a message, and expected_revision when a constitution already exists. A write that changes an inherited principle is refused with inherited_principle.
When an agent tries to change it
An editor's agent cannot change the constitution, even by accident. The server refuses the write with forbidden, the agent reports it, and the attempt is recorded in the audit trail as denied.