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. 374 files across 102 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 asset-catalog.yaml colors.yaml foundation.yaml … 5 more commercial/ customer-tiers/ definitions.yaml pricing/ discount-policy.yaml feature-matrix.yaml plans.yaml engineering/ adr/ 0001-postgres-primary-store.md 0002-event-driven-workflow-execution.md 0003-billing-engine-redesign.md experiments/ ai-suggestions-v1.yaml checkout-flow-v2.yaml flags/ ai-suggestions-inline.yaml checkout-flow-v2.yaml dark-mode.yaml enterprise-sso.yaml … 1 more metrics/ dora.yaml tech-debt/ legacy-webhook-handler.yaml n-plus-one-workflow-queries.yaml entity/ equity/ stakeholders/ acme-corp-inc.yaml alex-chen.yaml index-ventures.yaml jordan-park.yaml … 2 more stock-classes/ common-a.yaml common-esop.yaml series-a-preferred.yaml acme-eu-gmbh.yaml company.yaml financials/ bank-accounts/ jpmc-backup.yaml operating.yaml forecasts/ 2026-q2.yaml scenarios/ 2026-base.yaml 2026-downside.yaml 2026-upside.yaml snapshots/ 2026-01.yaml 2026-02.yaml 2026-03.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 risk/ register.yaml strategy/ okrs/ 2026-q1.yaml 2026-q2.yaml integrations/ sources/ accounting-puzzle.yaml app-store-connect.yaml banking.yaml buffer.yaml … 10 more ip/ copyrights/ platform-ui-design.yaml domains/ portfolio.yaml patents/ trigger-inference-provisional.yaml workflow-orchestration-method.yaml trade-secrets/ register.yaml trademarks/ acme-word-mark-eu.yaml acme-word-mark-us.yaml ir/ board-materials/ 2026-q1-board-pack.yaml cap-table-events/ 2026-01-15-series-a-close.yaml fundraising-pipeline/ series-b.yaml investor-updates/ 2026-01.yaml 2026-02.yaml 2026-03.yaml shareholder-register/ register.yaml knowledge/ glossary/ saas-metrics.yaml playbooks/ customer-onboarding-week-1.yaml enterprise-procurement-readiness.yaml sales-objection-handling.yaml retros/ 2026-q1-quarterly-retro.yaml runbooks/ deploy-frontend.yaml handle-trial-conversion.yaml rotate-aws-keys.yaml training/ sales-onboarding.yaml security-awareness.yaml legal/ action-items/ annual-filing.yaml de-gmbh-anmeldung.yaml de-transparenzregister.yaml eu-ai-act-classification.yaml … 4 more compliance/ corporate.yaml gdpr.yaml contracts/ dpa-anthropic.yaml dpa-aws.yaml dpa-datadog.yaml dpa-openai.yaml … 14 more policies/ data-retention.yaml gdpr-dpia-ai-workflow.yaml gdpr-retention-schedules.yaml gdpr-ropa-billing-records.yaml … 6 more policy-docs/ privacy-notice.yaml privacy-classification.yaml market/ campaigns/ product-launch-q2.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 mcp/ servers/ acme-api.yaml metrics/ cohorts/ early-adopters.yaml definitions/ accounting-transactions.yaml active-users.yaml android-installs.yaml android-ratings.yaml … 25 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 operations/ bcps/ customer-comms-outage.yaml key-personnel.yaml payroll-vendor-backup.yaml change_requests/ cr-2026-04-001-postgres-index.yaml cr-2026-04-002-rds-upgrade.yaml cr-2026-04-003-iam-role.yaml dr_plans/ postgres-prod.yaml runbooks/ postgres-failover.yaml slas/ enterprise-2026.yaml pro-2026.yaml sops/ handle-data-breach.yaml onboard-new-vendor.yaml people/ comp_history/ alex-chen.yaml lisa-park.yaml sarah-kim.yaml ladders/ customer-success.yaml engineering.yaml sales.yaml leave_ledgers/ alex-chen-2026.yaml erin-foster-2026.yaml raj-patel-2026.yaml pay_equity/ 2026-baseline.yaml payroll/ runs/ 2026-01.yaml 2026-02.yaml 2026-03.yaml roles/ account-executive.yaml board-director.yaml board-observer.yaml ceo.yaml … 24 more skills/ aws.yaml customer-success-playbooks.yaml enterprise-sales.yaml typescript.yaml stakeholders/ dr-wei-zhang.yaml marcus-osei.yaml sofia-eriksson.yaml statutory/ de-kv-2026.yaml de-rv-2026.yaml us-ca-sui-2026.yaml us-fica-2026.yaml … 1 more team/ alex-chen.yaml avery-patel.yaml blake-nguyen.yaml casey-lin.yaml … 17 more training/ gdpr.yaml year_end_forms/ 2025-alex-chen-us-w2.yaml 2025-template-de-lohnsteuerbescheinigung.yaml org.yaml product/ features/ api.yaml templates.yaml workflows.yaml feature-matrix.yaml overview.yaml security/ access_reviews/ aws-root-2026-q3.yaml prod-db-2026-q2.yaml assets/ aws-root-account.yaml cockpit-app.yaml datadog-tenant.yaml github-org.yaml … 1 more audit_evidence/ 2026-ac1-mfa-config.yaml 2026-iso27001-stage1.yaml 2026-sc1-kms-config.yaml breaches/ 2026-04-001-phishing.yaml compliance/ gdpr-art30-review.yaml soc2-control-mapping.yaml controls/ access-management.yaml backup-recovery.yaml change-management.yaml encryption-at-rest.yaml … 2 more pentests/ 2026-hackerone-vdp-report.yaml 2026-q2-web-app.yaml sboms/ cockpit-2.4.1.yaml server-1.8.0.yaml vulnerabilities/ cve-2026-12345.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.15.4/manifest.schema.json
corpospec_version: "0.15.4"
company_id: "acme-corp"
created: "2025-06-15"
schema_version: "0.15.4"
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.14.1/entity.schema.json
id: entity/acme-corp
type: corporation
business_type: b2b_software
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
subsidiaries:
- entity/acme-eu-gmbh
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: 50
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.13.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
employer: entity/acme-corp
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-formation.md
Architecture decision as a markdown file with YAML frontmatter.
---
id: governance/decisions/0001-entity-formation
status: accepted
date: "2025-06-01"
decision_makers:
- Alex Chen
- Sarah Kim
consulted:
- Legal Counsel
informed:
- All Hands
pillars:
- entity
- legal
financial_impact:
estimated_cost: 2500
currency: USD
recurring: false
risk_level: low
review_date: "2026-06-01"
supersedes: []
---
# C-Corp Formation in Delaware
## Problem Statement
Acme needs a legal entity to accept customers, hire employees, and raise venture capital. Jurisdiction and entity type affect fundraising, tax treatment, and operational flexibility.
## Considered Options
Multiple approaches were evaluated before reaching this decision.
## Decision
Form a Delaware C-Corp. Delaware is the default jurisdiction for venture-backed startups. C-Corp structure aligns with standard fundraising instruments (SAFE, priced rounds) and investor expectations.
## Reasoning
Delaware C-Corp eliminates the need for future restructuring. Standard YC SAFE and NVCA documents assume this structure. Formation cost is minimal (~$2,500 including legal fees). Both founders can operate as officers regardless of residence.
Financial — model .corpospec/financials/model.yaml
Plan, actuals, and forecasts via PathRef into sibling directories.
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.13.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.13.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