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, and creator. 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.
Search entities and fields, follow every reference, and inspect the data model one entity at a time.
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.
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. The creator pillar activates only when an entity declares business_type: creator_business.
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.16.0/entity.schema.json