agent-constitution design

Status: draft. This is the one design of the repo, in the files listed below. The constitution itself is built from index.toml and articles/ in its edition directory, constitution/2026-10/, into English and Chinese; this design cites it only by ID (see Source formats, IDs) and never restates it.

The repo provides three kinds of installable content: the constitution, the general rules and the general skills. A user picks which of them to install through configuration. How they are installed, and what metadata that needs, is not decided yet; it will be settled as the toolchain is built.

Each file covers one part and reads on its own; in this order they make the whole design.

Overview: goals and non-goals, the two layers, language.
File structure: the directory plan, its stages, and what the constitution protects.
Source formats: TOML text tables and IDs.
The constitution: its sources, numbering and the version for agents.
Rules and relaxations: rule sources, choosing rules, relaxation declarations and local parameters.
Skills: the skill layout.
Compilation: building the instruction file.
Static site: the Hugo site and its deployment.
Checkers, fixtures and feedback: the checkers, fixtures, load verification and the reserved feedback loop.
Amendments and releases: approving an amendment, releases and versions.
Fleet and migration: relation to fleet and migrating from the hand-written guide.
Rule system: the planned rule system (numbered rules, sources and references, rule sets and lock files, dependencies, checks and the review loop), not built yet, and which parts above it will replace.