{
  "$schema": "./design-system.schema.json",
  "id": "transformative-ontology",
  "name": "Transformative Ontology",
  "version": "1.0.0",
  "status": "canonical",
  "updated": "2026-07-26",
  "canonicalUrl": "https://ontology.transformative.studio/",
  "description": "The canonical system that defines how Transformative Studio thinks, speaks, and presents itself.",
  "authority": {
    "scope": "Transformative Studio",
    "statement": "This is the Transformative-hosted Ontology. Do not conflate it with Clark Valberg's personal Ontology.",
    "precedence": [
      "This manifest and the rendered site are the canonical public sources.",
      "The DTCG token file is canonical for portable visual values.",
      "When a generated artifact conflicts with the rendered reference, preserve the rendered composition and report the conflict."
    ]
  },
  "entrypoints": {
    "human": "https://ontology.transformative.studio/",
    "agentIndex": "https://ontology.transformative.studio/llms.txt",
    "agentCorpus": "https://ontology.transformative.studio/llms-full.txt",
    "manifest": "https://ontology.transformative.studio/design-system.json",
    "tokens": "https://ontology.transformative.studio/design-tokens.tokens.json",
    "instructions": "https://ontology.transformative.studio/AGENTS.md",
    "mcp": "https://ontology.transformative.studio/mcp"
  },
  "foundations": {
    "axiom": "Create the AI-Native Future.",
    "axiomDisplayLines": [
      "Create the",
      "AI-Native Future."
    ],
    "pillars": [
      {
        "id": "vision",
        "index": "01",
        "label": "Vision",
        "role": "The Destination",
        "statement": "A world where every industry, system, and experience is reimagined for an AI-native era."
      },
      {
        "id": "mission",
        "index": "02",
        "label": "Mission",
        "role": "The Action",
        "statement": "Create AI-native companies by designing new possibilities at the intersection of AI, creativity, and deep domain expertise."
      },
      {
        "id": "strategy",
        "index": "03",
        "label": "Strategy",
        "role": "The Method",
        "statement": "Partner with deeply knowledgeable, highly influential subject-matter experts to design, validate, and launch category-defining AI-native ventures."
      }
    ]
  },
  "visual": {
    "character": [
      "Monumental Swiss typography",
      "High-contrast black and white fields",
      "Restrained technical metadata",
      "Precise editorial spacing",
      "One emerald signal accent",
      "Squared geometry with minimal decoration"
    ],
    "themes": {
      "default": "dark",
      "supported": [
        "dark",
        "light"
      ],
      "behavior": "Use class-based theming. Persist an explicit user choice, but default new sessions to dark."
    },
    "colors": [
      {
        "id": "studio-black",
        "name": "Studio Black",
        "hex": "#050505",
        "rgb": [
          5,
          5,
          5
        ],
        "usage": "Primary Background / Text"
      },
      {
        "id": "field-white",
        "name": "Field White",
        "hex": "#FFFFFF",
        "rgb": [
          255,
          255,
          255
        ],
        "usage": "Primary Surface / Negative"
      },
      {
        "id": "ghost-silver",
        "name": "Ghost Silver",
        "hex": "#F9F9F9",
        "rgb": [
          249,
          249,
          249
        ],
        "usage": "Secondary Surface / UI"
      },
      {
        "id": "signal-green",
        "name": "Signal Green",
        "hex": "#00C38B",
        "rgb": [
          0,
          195,
          139
        ],
        "usage": "Sparing status or axiom signal. Never use as a broad decorative field."
      }
    ],
    "typography": {
      "brand": {
        "family": "Inter",
        "fallback": "sans-serif",
        "weights": [
          300,
          400,
          500,
          600,
          700,
          800,
          900
        ],
        "usage": "Primary brand and interface typography."
      },
      "utility": {
        "family": "IBM Plex Mono",
        "fallback": "monospace",
        "weights": [
          300,
          400,
          500,
          600,
          700
        ],
        "usage": "Metadata, labels, technical specifications, indices, and system communications."
      },
      "runtimeCompatibility": {
        "family": "Google Sans Text",
        "rootSizePx": 14,
        "reason": "The deployed shell uses a 14px root scale. Preserve it to maintain the approved composition."
      },
      "roles": [
        {
          "id": "monument",
          "family": "Inter",
          "size": {
            "mobile": "3rem",
            "tablet": "6rem",
            "desktop": "10rem"
          },
          "weight": 900,
          "lineHeight": 0.82,
          "letterSpacing": "-0.06em",
          "transform": "uppercase",
          "usage": "Foundational axiom and rare first-screen declarations."
        },
        {
          "id": "display",
          "family": "Inter",
          "size": {
            "mobile": "4.5rem",
            "desktop": "8rem"
          },
          "weight": 500,
          "lineHeight": 0.85,
          "letterSpacing": "-0.05em",
          "usage": "Section-defining display statements."
        },
        {
          "id": "headline",
          "family": "Inter",
          "size": {
            "mobile": "2.25rem",
            "desktop": "3.75rem"
          },
          "weight": 300,
          "lineHeight": 1.1,
          "letterSpacing": "-0.025em",
          "usage": "Editorial headlines and major explanatory claims."
        },
        {
          "id": "body",
          "family": "Inter",
          "size": {
            "mobile": "1.125rem",
            "desktop": "1.25rem"
          },
          "weight": 300,
          "lineHeight": 1.625,
          "letterSpacing": "normal",
          "usage": "Narrative explanation."
        },
        {
          "id": "label",
          "family": "IBM Plex Mono",
          "size": {
            "all": "0.625rem"
          },
          "weight": 500,
          "lineHeight": 1.4,
          "letterSpacing": "0.3em",
          "transform": "uppercase",
          "usage": "Section labels, indices, metadata, and ledgers."
        }
      ],
      "hierarchySpecimens": [
        {
          "label": "Display 01",
          "style": "text-7xl md:text-9xl font-medium tracking-[-0.05em] leading-[0.85]",
          "text": "Systems."
        },
        {
          "label": "Headline 01",
          "style": "text-4xl md:text-6xl font-light tracking-tight leading-[1.1]",
          "text": "The AI-native Studio."
        },
        {
          "label": "Body 01",
          "style": "text-lg md:text-xl font-light leading-relaxed max-w-xl",
          "text": "Transformative engineers breakthrough experiences through the synthesis of insight, tech, and design."
        },
        {
          "label": "Label 01",
          "style": "text-[10px] font-mono uppercase tracking-[0.3em] opacity-60",
          "text": "VERIFICATION_SEQUENCE_ACTIVE"
        }
      ]
    },
    "layout": {
      "maxWidthPx": 1440,
      "rootFontSizePx": 14,
      "headerHeightPx": 80,
      "footerHeightPx": 96,
      "pagePaddingPx": {
        "mobile": 24,
        "tablet": 48,
        "desktop": 80
      },
      "breakpointsPx": {
        "mobile": 0,
        "tablet": 768,
        "desktop": 1024,
        "wide": 1440
      },
      "grid": "Use a 12-column grid for desktop editorial composition and collapse to a single column on mobile.",
      "density": "Use generous vertical rhythm. Prefer broad fields, thin rules, and deliberate negative space over containers and cards."
    },
    "geometry": {
      "radius": "Square by default. Use only restrained 2px radii for utility controls when necessary.",
      "rules": "Use 1px current-color rules at 3–10% opacity.",
      "shadows": "Avoid surface shadows. The only canonical glow is the restrained signal-green axiom dot."
    },
    "motion": {
      "entryDurationMs": [
        700,
        1000
      ],
      "themeDurationMs": 500,
      "hoverDurationMs": [
        300,
        500
      ],
      "principles": [
        "Motion should reveal hierarchy, not advertise itself.",
        "Prefer opacity and short vertical translation.",
        "Do not animate readable elements into collision or delay access to primary content."
      ]
    },
    "iconography": {
      "library": "Lucide",
      "strokeWidth": [
        1,
        1.5
      ],
      "sizePx": [
        10,
        12,
        14,
        16,
        18,
        24
      ],
      "usage": "Utility actions only. Icons remain subordinate to type."
    },
    "identityAssets": {
      "masterLockup": {
        "positiveSvg": "https://ontology.transformative.studio/assets/brand/transformative-logo-dark.svg",
        "negativeSvg": "https://ontology.transformative.studio/assets/brand/transformative-logo-light.svg",
        "positivePng": "https://ontology.transformative.studio/assets/brand/transformative-logo-dark.png",
        "negativePng": "https://ontology.transformative.studio/assets/brand/transformative-logo-light.png",
        "viewBox": "0 0 1144 103"
      },
      "symbol": {
        "description": "Two opposing crescents forming the Transformative symbol.",
        "viewBox": "0 0 230 103"
      },
      "rules": [
        "Use the positive lockup on light fields and the negative lockup on dark fields.",
        "Do not add effects, gradients, outlines, or alternate colors.",
        "Preserve the supplied aspect ratio and path geometry.",
        "Give the lockup enough clear space to remain quiet and legible."
      ]
    }
  },
  "language": {
    "voice": [
      "Direct and declarative",
      "Structurally precise",
      "Concrete about what is built and why",
      "Confident without hype",
      "Technical language only when it clarifies the work"
    ],
    "avoid": [
      "Generic AI marketing language",
      "Decorative futurism",
      "Buzzwords without operational meaning",
      "Claims of transformation without a material workflow or system",
      "Excessive exclamation, sentiment, or self-congratulation"
    ],
    "narrativeAssets": [
      {
        "id": "hook",
        "label": "The Hook",
        "text": "Transformative builds the AI-native future.",
        "usage": [
          "Social headers",
          "Hero sections",
          "Short intros"
        ]
      },
      {
        "id": "boilerplate",
        "label": "Ontological Boilerplate",
        "text": "Transformative is a venture studio that creates breakthrough experiences through the synthesis of insight, tech, and design. We build AI-native vertical ventures that solve material problems at the edge of industry complexity.",
        "usage": [
          "Official about sections",
          "PR",
          "PortCo profiles"
        ]
      },
      {
        "id": "strategic-summary",
        "label": "The Strategic Summary",
        "text": "We partner with high-leverage operators to launch category-defining vertical ventures through a synthesis of insight, technical precision, and aesthetic integrity.",
        "usage": [
          "Partner decks",
          "LinkedIn bios",
          "Pitch summaries"
        ]
      }
    ],
    "lifecycle": [
      {
        "id": "thesis",
        "index": "01",
        "term": "Thesis",
        "definition": "Identify a high-value industry with fragmented workflows, significant data exhaust, and a massive gap between current tools and AI potential."
      },
      {
        "id": "research-sprint",
        "index": "02",
        "term": "Research Sprint",
        "definition": "A dedicated time-boxed phase for deep vertical immersion. We observe operators to identify the unarticulated \"Job to be Done\" that legacy software misses."
      },
      {
        "id": "venture-sprint",
        "index": "03",
        "term": "Venture Sprint",
        "definition": "A focused 4-week validation cycle. We build high-fidelity interactive systems to prove the value of a specific AI-native experience."
      },
      {
        "id": "spin-out",
        "index": "04",
        "term": "Spin Out",
        "definition": "Establishment of a standalone entity. Recruiting world-class leadership and deploying capital to capture the market opportunity."
      }
    ],
    "portfolioStates": [
      {
        "id": "stealth-discovery",
        "state": "Stealth Discovery",
        "description": "Active research and validation within a specific vertical thesis."
      },
      {
        "id": "venture-build",
        "state": "Venture Build",
        "description": "Co-designing the core technical asset with partners to validate the experience."
      },
      {
        "id": "spun-out",
        "state": "Spun Out",
        "description": "Operating as a standalone entity with permanent executive leadership."
      }
    ],
    "canonicalTerms": [
      "AI-native Vertical Ventures",
      "Operator-led Discovery",
      "Strategic Synthesis",
      "Material Workflows",
      "Systemic Leverage",
      "Compound Technical Moats"
    ]
  },
  "implementation": {
    "primeDirective": "Use Ontology faithfully without turning every artifact into a design-system demonstration.",
    "compositionRules": [
      "Lead with one strong claim and a restrained proof structure.",
      "Use monumental type only for true first-order statements.",
      "Pair large sans-serif statements with small mono metadata.",
      "Use the 12-column grid to create asymmetric editorial balance.",
      "Use negative space as structure; do not fill the page with modules.",
      "Keep dividers thin, low-contrast, and singular.",
      "Support both dark and light modes, with dark as the default.",
      "Preserve readable line lengths and collapse cleanly to one column on mobile."
    ],
    "doNot": [
      "Do not introduce gradients, glass panels, soft card stacks, or ornamental shadows.",
      "Do not add chip grids, dashboard rails, command-center framing, or excessive status UI.",
      "Do not use signal green as a generic brand wash.",
      "Do not mix unrelated font families or substitute a geometric display face.",
      "Do not overuse mono text; it is a utility voice, not the body voice.",
      "Do not expose internal design-system labels on recipient-facing artifacts unless the brief requires them.",
      "Do not redesign approved composition when making a narrow content or technical correction."
    ],
    "accessibility": [
      "Maintain WCAG AA contrast for readable text.",
      "Provide accessible names for icon-only controls.",
      "Respect reduced-motion preferences for non-essential animation.",
      "Keep keyboard focus visible.",
      "Never rely on color alone to communicate state.",
      "Verify at 390×844 and 1440×1000 with no horizontal overflow or clipped controls."
    ],
    "routes": [
      {
        "path": "/",
        "hashPath": "#/",
        "name": "Home",
        "purpose": "Foundational axiom, vision, mission, and strategy."
      },
      {
        "path": "/visuals",
        "hashPath": "#/visuals",
        "name": "Visuals",
        "purpose": "Identity, color, typography, and type hierarchy."
      },
      {
        "path": "/language",
        "hashPath": "#/language",
        "name": "Language",
        "purpose": "Narrative assets, lifecycle vocabulary, portfolio states, and canonical terms."
      }
    ],
    "verification": {
      "command": "npm run check",
      "agentContextCommand": "npm run agent:check",
      "visualReference": "docs/visual-reference/README.md",
      "requirements": [
        "TypeScript passes.",
        "The production build succeeds.",
        "Generated agent artifacts match the canonical sources.",
        "The MCP endpoint lists and reads all canonical resources.",
        "Desktop and mobile screenshots preserve the approved composition."
      ]
    }
  },
  "standards": [
    {
      "name": "llms.txt",
      "role": "Agent-oriented website discovery proposal",
      "url": "https://llmstxt.org/"
    },
    {
      "name": "Model Context Protocol 2025-11-25",
      "role": "Remote structured resource transport",
      "url": "https://modelcontextprotocol.io/specification/2025-11-25/"
    },
    {
      "name": "Design Tokens Format Module 2025.10",
      "role": "Stable vendor-neutral token interchange",
      "url": "https://www.designtokens.org/TR/2025.10/format/"
    }
  ]
}