The open standard for Company as Code.
CorpoSpec defines a machine-readable schema for every load-bearing fact about a company — entity, people, governance, strategy, finance, product, market, brand, integrations, legal. AI agents and humans read the same source of truth.
What you get
DRY, KISS, and PathRef by default. A tight set of rules that keeps a company repository honest.
Draft 2020-12. Versioned URLs are immutable. Works with every YAML language server.
See how the pillars fit together — every entity, every common reference, one diagram.
Add .corpospec/ to your repo in ten minutes. Includes editor wiring and validation.
All pillars populated. A reference for what a well-structured CorpoSpec repo looks like.
This site, every published schema version, and the ingest pipeline. All open source.
Ten pillars, one company
Every pillar maps to a directory under .corpospec/. Each file is a single entity or document validated against its JSON Schema. References between entities are PathRefs — people/team/alex — never copied attributes.
Pin a version in your YAML
Versioned URLs are immutable. Add this header to any CorpoSpec YAML file:
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/entity.schema.json