Example Reference repository

ACME — a complete CorpoSpec example

ACME is a fictional company whose .corpospec/ repository populates every pillar. Use it as a template or a sanity check when you shape your own repository. 179 files across 41 directories.

Repository layout

Trimmed to a few files per directory for readability. The full tree lives under content/examples/acme/ in the corpospec.com site repo.

.corpospec/
  brand/
    fonts/
      Inter/
        Inter-Bold.ttf
        Inter-BoldItalic.ttf
        Inter-Italic.ttf
        Inter-Medium.ttf
        … 4 more
      JetBrainsMono/
        JetBrainsMono-Bold.ttf
        JetBrainsMono-Italic.ttf
        JetBrainsMono-Medium.ttf
        JetBrainsMono-Regular.ttf
        … 1 more
      PlusJakartaSans/
        OFL.txt
        PlusJakartaSans-Bold.ttf
        PlusJakartaSans-Medium.ttf
        PlusJakartaSans-Regular.ttf
        … 1 more
    logos/
      acme-primary.svg
      acme-symbol.svg
      acme-wordmark.svg
    architecture.yaml
    colors.yaml
    foundation.yaml
    logo.yaml
    … 2 more
  entity/
    equity/
      stakeholders/
        acme-corp-inc.yaml
        alex-chen.yaml
        jordan-park.yaml
        sarah-kim.yaml
      stock-classes/
        common-a.yaml
    company.yaml
    jurisdiction-de.yaml
  financials/
    bank-accounts/
      operating.yaml
    forecasts/
      2026-q2.yaml
    model.yaml
  governance/
    board/
      members.yaml
    decisions/
      0001-entity-formation.md
      0002-initial-funding.md
      0003-product-architecture.md
      0004-pricing-model.md
      … 27 more
    journal/
      2026-03-01-quarterly-planning.md
      2026-03-10-customer-milestone.md
      2026-03-15-team-offsite-reflection.md
    resolutions/
      001-incorporation.yaml
    strategy/
      okrs/
        2026-q1.yaml
        2026-q2.yaml
  integrations/
    sources/
      accounting-puzzle.yaml
      app-store-connect.yaml
      banking.yaml
      buffer.yaml
      … 10 more
  legal/
    action-items/
      annual-filing.yaml
      trademark-filing.yaml
    compliance/
      corporate.yaml
      gdpr.yaml
      vendor-dpa-tracker.yaml
    contracts/
      employment-alex-chen.yaml
      employment-sarah-kim.yaml
      founder-agreement.yaml
      ip-assignment.yaml
    policies/
      data-retention.yaml
      information-security.yaml
      remote-work.yaml
    risk-register.yaml
  market/
    campaigns/
      product-launch-q2.yaml
    cohorts/
      early-adopters.yaml
    competitors/
      asana.yaml
      clickup.yaml
      freshdesk.yaml
      hubspot.yaml
      … 8 more
    icp/
      enterprise-it.yaml
      mid-market-ops.yaml
      smb-saas-founder.yaml
    monetization/
      monetization.yaml
    gtm-strategy.yaml
    services-pricing.yaml
    tam-sam-som.yaml
  metrics/
    definitions/
      active-users.yaml
      arr.yaml
      burn-rate.yaml
      gross-margin.yaml
      … 2 more
    snapshots/
      active-users-2026-01-01.yaml
      active-users-2026-02-01.yaml
      active-users-2026-03-01.yaml
      arr-2026-01-01.yaml
      … 14 more
  people/
    roles/
      ceo.yaml
      cto.yaml
      customer-success-manager.yaml
      data-analyst.yaml
      … 9 more
    team/
      alex-chen.yaml
      avery-patel.yaml
      blake-nguyen.yaml
      casey-lin.yaml
      … 8 more
    org.yaml
  product/
    features/
      api.yaml
      templates.yaml
      workflows.yaml
    feature-matrix.yaml
    overview.yaml
  manifest.yaml

Key files

Manifest .corpospec/manifest.yaml

Declares company_id, corpospec_version, and the pillars this repo populates.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/manifest.schema.json
corpospec_version: "0.1.1"
company_id: "acme-corp"
created: "2025-06-15"
schema_version: "0.1.1"
pillars:
  - entity
  - financials
  - metrics
  - product
  - market
  - people
  - legal
  - governance
  - integrations
  - brand

Entity — legal identity .corpospec/entity/company.yaml

Legal name, registered address, officers, jurisdiction PathRef.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/entity.schema.json
id: entity/acme-corp
type: corporation
legal_name: "Acme Corp, Inc."
trade_name: "Acme"
legal_form: "C-Corp"
jurisdiction: "US"
functional_currency: "USD"
registration_number: "7891234"
registration_authority: "Delaware Division of Corporations"
date_of_incorporation: "2025-06-15"
address:
  street: "100 Market Street, Suite 300"
  city: "San Francisco"
  postal_code: "94105"
  state: "CA"
  country: "US"
founders:
  - people/team/alex-chen
  - people/team/sarah-kim
url: "https://acme-corp.example.com"
company_purpose: "To develop and operate a workflow automation platform that enables growing teams to eliminate manual processes through AI-powered tools."
tax_ids:
  - id_type: "EIN"
    value: "84-3219876"
    country: "US"
    description: "Federal Employer Identification Number"
contact:
  email: "hello@acme-corp.example.com"
  phone: "+1-415-555-0142"
number_of_employees:
  value: 12
  as_of: "2026-03-01"
status: active

People — team member .corpospec/people/team/alex-chen.yaml

One file per person. Role PathRef, contact fields, employment facts.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/person.schema.json
id: people/team/alex-chen
type: Person
name:
  given: "Alex"
  family: "Chen"
  full: "Alex Chen"
email: "alex@acme-corp.example.com"
role: people/roles/ceo
unit: executive
start_date: "2025-06-15"
end_date: null
status: active
equity: entity/equity/stakeholders/alex-chen
bio: "Co-founder and CEO. Previously VP Product at DataFlow. Stanford CS."

Governance — decision record .corpospec/governance/decisions/0001-entity-jurisdiction.md

Architecture decision as a markdown file with YAML frontmatter.

File not found in the ACME snapshot.

Financial — model .corpospec/financials/model.yaml

Plan, actuals, and forecasts via PathRef into sibling directories.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/financial-model.schema.json
id: financials/model
period:
  type: instant
  start: "2026-03-01"
entity: entity/acme-corp
currency: USD

income_statement:
  revenue: 218400
  cost_of_revenue: 54600
  gross_profit: 163800
  operating_expenses:
    research_and_development: 420000
    sales_and_marketing: 180000
    general_and_administrative: 96000
  operating_income: -532200
  net_income: -532200

balance_sheet:
  assets:
    cash_and_equivalents: 1190000
    accounts_receivable: 42000
    total_assets: 1232000
  liabilities:
    accounts_payable: 18000
    total_liabilities: 18000
  equity:
    total_equity: 1214000

cash_flow:
  operating: -44350
  investing: -5000
  financing: 0
  net_change: -49350

custom:
  description: >
    Instant snapshot as of 2026-03-01. Acme Corp is a post-seed SaaS company
    building workflow automation for growing teams. Revenue is MRR $18,200
    annualized to $218,400. Growing 15% month-over-month.
  stage: post-seed
  monthly_recurring_expenses:
    - name: AWS
      amount: 4200
    - name: Google Workspace
      amount: 180
    - name: GitHub Enterprise
      amount: 252
    - name: NovaMind AI API
      amount: 3800
    - name: Datadog
      amount: 450
    - name: Slack
      amount: 156
    - name: Linear
      amount: 120
    - name: Figma
      amount: 90
    - name: Notion
      amount: 144
    - name: Office lease
      amount: 2500
  assumptions:
    - id: asm-fin-001
      description: "Pre-Series A, $2.5M seed closed Oct 2025."
      evidence: "Signed SAFE agreements and bank deposit confirmation."
      invalidation_condition: "Failure to deploy capital within projected timeline."
    - id: asm-fin-002
      description: "MRR growing 15% month-over-month."
      evidence: "Stripe dashboard shows consistent 14-16% MoM growth since Dec 2025."
      invalidation_condition: "MRR growth drops below 10% for two consecutive months."
    - id: asm-fin-003
      description: "14.2 months runway at current burn."
      evidence: "$1,190,000 cash / $49,350 monthly net burn = 24.1 months remaining."
      invalidation_condition: "Unexpected large expense or revenue decline."
    - id: asm-fin-004
      description: "Target Series A at $3M ARR."
      evidence: "Benchmark data from comparable B2B SaaS companies at Series A."
      invalidation_condition: "

# …truncated…

Metrics — definition .corpospec/metrics/definitions/mrr.yaml

Formula, unit, owner. Metrics are defined once, referenced many times.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/metric.schema.json
id: metrics/definitions/mrr
name: Monthly Recurring Revenue
abbreviation: MRR
description: Sum of monthly values of all active recurring subscription contracts.
formula: sum(active_subscriptions.monthly_value)
unit: currency
direction: up
frequency: monthly
source:
  system: stripe
  query: stripe.subscriptions.list(status=active).sum(plan.amount)
xbrl_mapping: null
related_metrics:
- metrics/definitions/arr
iso_30414_mapping: null
tags:
- saas
- revenue
- investor-facing

Adopt this pattern

Guide
Hands-on quickstart

From empty directory to validating CorpoSpec repo in ten minutes.

Spec
Read the principles

DRY, KISS, PathRef by default. A short set of rules.

Schemas
Browse every schema

Pillar-grouped. Fields with types, required markers, descriptions.