Spectra Coffee Demo

A synthesized specialty coffee shop in Berlin — not a real business, but a purpose-built reference implementation demonstrating the full orgschema methodology. 26 YAML files covering 6 products, 4 processes, 2 compliance frameworks, signal maps, and perception layer.

Reference Implementation

orgschema-demo

Fork the demo to start your own specification. Every parameter traces from sourcing (L5) through to customer experience (L0). Change one value and the pipeline shows which experience tests are affected.

26 YAML files 6 products 4 processes CI/CD pipeline

View on GitHub

Validator CLI

The orgschema-validate CLI runs the six-level validation pipeline against any orgschema specification. Schema validation, cross-reference integrity, contract satisfaction, signal coverage, experience traceability, and waste detection.

Framework + Validator

orgschema-framework

Python package with JSON Schema definitions for products, processes, organization, and compliance specifications. Install and validate:

pip install orgschema-framework
orgschema-validate spectra-coffee/

Python 3.12+ 4 JSON Schemas CLI tool

View on GitHub

Demo Structure

The Spectra Coffee demo organizes files by specification level:

spectra-coffee/
  organization.yaml          # Company identity, roles, values
  brand/
    identity.yaml             # Brand signals, visual identity
    signal-map.yaml           # 19 signals across 8 SBT dimensions
  products/
    espresso.yaml              # Product spec: recipe, quality gates
    cappuccino.yaml            # ...
    filter-coffee.yaml
    cold-brew.yaml
    matcha-latte.yaml
    signature-blend.yaml
  processes/
    espresso-preparation.yaml  # Process contracts + procedures
    milk-steaming.yaml
    opening-routine.yaml
    closing-routine.yaml
  compliance/
    food-safety.yaml           # Constraint contracts (EU 852/2004)
    allergen-management.yaml
  perception/
    experience-contracts.yaml  # L0 acceptance tests
    signal-requirements.yaml   # L1 integration tests
    ...
  locations/
    berlin-mitte/              # Location fork (same tests, local values)

Quick Start

Clone the demo

git clone https://github.com/spectralbranding/orgschema-demo
cd orgschema-demo

Install the validator
```
pip install orgschema-framework
```
Run validation
```
orgschema-validate spectra-coffee/
```
Explore the cascade
Start at perception/experience-contracts.yaml (L0) and trace downward through signal requirements (L1), process contracts (L2), procedures (L3), product specs (L4), to sourcing (L5).
Fork it
Copy the test suite. Rewrite the implementation for your business. Run the validator to confirm your specification satisfies the same customer experience goals.