Three zoom levels — read together

Architecture

The tools we need, where they sit, what they feed into, who uses them. Company stack on top; the Hearth product inside it; the vision workspace that authors them both at the bottom.

Layer 1

The Alterspective Company Stack

Four layers. Top is what clients buy. Middle is the moat. Bottom funds the build. Infra carries the whole thing.

Top — what clients buy 3

Vision Architecture

shipping
methodology — sense-making before software

We explore first, so you build right. The promise that opens every engagement.

Feeds Forge
Used by clients presales

Hearth

open frontier
the product — human-first Concern Management Platform

Where complex work becomes human again. The open frontier of the workshop.

Feeds Foundry Intelligence Cortex Keystone Whisper
Used by clients
alterspective-hearth

Care Plans + Products

building
recurring revenue — productised engagement

Repeatable productised offerings that compound delivery learnings into client value.

Feeds Forge
Used by clients
Middle — the moat 8

Forge

shipping
delivery methodology

Where methodology and delivery practices are shaped. The pattern library for how we do the work.

Feeds Clio adapter Sharedo adapter Other adapters
Used by delivery presales

Foundry

shipping
component toolkit

Senior engineering made reusable. SDK published, seven reference consumers.

Feeds Hearth
Used by engineering

Intelligence

shipping
the knowledge library

Practice · Principles · Skills · Reference. The structured knowledge layer; bytes in folders without Cortex to serve them.

Feeds Cortex
Used by ai-sessions delivery
Alterspective-Intelligence

Cortex

shipping
the knowledge engine

Librarian + card catalogue. Indexes Intelligence via webhook, serves multi-hop RAG over MCP. Powered by GpuAsAService; consumed by every AI surface that needs grounded answers.

Feeds Hearth Whisper AI Office Learning
Used by ai-sessions igor training-portal

Keystone

shipping
identity anchor

Shared identity & access platform. Becomes load-bearing when Hearth has users.

Feeds Hearth
Used by clients all-products
alterspective-keystone

Whisper

building
AI convention

Behind you, helping. Never in front, taking over. The locked posture for every AI surface.

Feeds Hearth Forge Foundry
Used by all-ai-surfaces

AI Office

building
workflow orchestrator — multi-agent delivery engine

Coordinates multi-agent workflows with enforced validation gates and JSONL audit logs. Reads Intelligence via Cortex; runs compute through GpuAsAService. The AI-era project planner shaped around Forge delivery patterns.

Feeds delivery engineers
Used by delivery engineers
ai-office

Learning

building
team development platform

ERMA assessments, mentor relationships, skill-course mapping, and AI-powered content editing. Calls Cortex for grounded KB context so training stays close to real company knowledge. Turns Intelligence into team capability.

Feeds team
Used by team igor
alterspective-training-portal
Bottom — what funds the build 3

Clio adapter

shipping
platform adapter

Connects Forge methodology to Clio engagements. Keeps the lights on; earns the right to build above.

Feeds Forge
Used by delivery

Sharedo adapter

shipping
platform adapter

Connects Forge methodology to Sharedo engagements. Same role as Clio; different vendor.

Feeds Forge
Used by delivery

Other adapters

planned
future platform adapters

Independence target: by BREAK (FY29), no single vendor relationship dominates revenue or identity.

Feeds Forge
Used by delivery
Infra — holding it up 1

GpuAsAService

shipping
shared AI gateway

Every model call routed through one observable, cost-tracked, governed channel. Local-first (Contabo / Vultr GPU) with cloud fallback, caching, circuit breakers. Powers Cortex RAG, AI Office orchestration, Training content editing, and every Whisper surface.

Feeds Cortex AI Office Whisper Learning
Used by cortex ai-office training-portal all-ai-surfaces
Layer 2

Hearth's Orbit — the product architecture

The concern is the centre. The lifecycle is the spine. Everything else orbits.

Centre 1
The centre — everything orbits this

Concern

design
the central object of work

A matter, claim, complaint, risk, obligation, decision, relationship, investigation. The organising centre that everything else orbits.

Feeds Lifecycle Spine Context Memory Audit + Explainability
Used by every-role
Spine 1
The spine — what the concern moves along

Lifecycle Spine

design
the spine of a concern

States, transitions, and possible movements. The flexible backbone the concern moves along — not a railway.

Feeds Workflow Flow Cues Quality + Risk Guardrails
Used by every-role
Orbital capabilities 10

Audit + Explainability

design
orbital — record + live view

What happened, why suggestions were made, where the human took over, what they decided. Trust artefact, not surveillance.

Used by reviewers regulators the-human-doing-the-work

Communications

design
orbital — outbound + inbound

Email, Teams, portals, calls. Communications attach to the concern, not the inbox.

Feeds Context Memory
Used by every-role

Context Memory

design
orbital — explainable history

Structured memory of decisions, documents, communications, prior actions, reusable operational knowledge. The concern remembers.

Feeds Whisper Layer Flow Cues
Used by every-role

Documents

design
orbital — artefacts

Letters, contracts, evidence, drafts. Attach to the concern, never to the workflow step.

Feeds Context Memory
Used by every-role

Flow Cues

design
orbital — UI pattern

Soft, contextual next-movement suggestions in peripheral vision. Accept, adapt, ignore, or let them fade.

Used by the-human-doing-the-work

Integration Fabric

design
orbital — to other systems

Email, Teams, document management, practice systems, CRM, finance, portals, calendars, knowledge bases. The connective tissue.

Feeds Communications Documents
Used by external-systems

Quality + Risk Guardrails

design
orbital — embedded checks

Quality, compliance, obligations, risk — woven into the flow of work, never bolted on as governance theatre.

Used by every-role reviewers

Relationship Field

design
orbital — people + trust

Roles, responsibilities, communication history, trust, dependencies, commitments. The human map around the concern.

Feeds Communications
Used by every-role

Whisper Layer

design
orbital — AI assistance

Summarising, drafting, suggesting, checking, preparing, reconciling. Translucent assistance bounded by the Whisper Charter.

Feeds Flow Cues
Used by the-human-doing-the-work

Workflow

design
orbital — one capability among many

Important, but not the centre. A tool the lifecycle can use, not the spine.

Used by every-role
Deferred 1

ERMA Telemetry

planned
orbital — deferred

Future capability. Deferred from v1 until a Telemetry Charter exists. Opt-in, environment-level only, never per-person performance.

Used by tbd
Layer 3

The Vision Workspace — this repo's architecture

AI authors structured markdown. The dashboard reads it. The two never touch each other. That rule is the architecture.

Source of truth 2

Markdown corpus

in use
the source of truth

Concepts, decisions, questions, lineage, research, prototypes, narratives, architecture. Every claim lives in a .md file with locked YAML frontmatter.

Feeds Astro Content Collections
Used by ai-sessions igor

Schemas

locked
the AI ↔ Dashboard contract

_meta/schemas.md. Locked. Every content type declared. Structural changes go through decision records.

Feeds Astro Content Collections
Used by ai-sessions dashboard
Rendering 4

Astro Content Collections

in use
rendering — schema-validated loader

Zod-validated glob loaders defined in app/src/content.config.ts. Reads the corpus; refuses to render anything that doesn't match schemas.

Feeds Astro dashboard
Used by dashboard

Astro dashboard

in use
rendering — the visual surface

Astro 5 + Tailwind. 11 routes today. Igor's visual workspace. Dogfood test for Hearth's own UX philosophy.

Feeds Coolify
Used by igor

Cytoscape

in use
rendering — concept-map

Force-directed graph of concept/decision/question/lineage/research/prototype/architecture nodes, edges from related: + wiki-links.

Feeds Astro dashboard
Used by dashboard

Mermaid

in use
rendering — text-driven diagrams

Embedded in markdown bodies. State machines, sequence diagrams, simple flowcharts.

Feeds Astro dashboard
Used by dashboard
Authoring pipeline 3

AI sessions

in use
authors — Claude, Codex, Gemini

Sessions that author markdown into the corpus. Behind you, helping. Never in front, taking over.

Feeds Markdown corpus
Used by igor

bin/ SVG pipeline

in use
authors — visual asset generation

compose-svg + recraft-generate + critique + render-and-screenshot. Generates the hero SVGs the master picture references.

Feeds assets/ SVGs
Used by igor

assets/ SVGs

in use
authors — output of the pipeline

the-workshop.svg, erma-joy.svg, rare-combination.svg. Pre-made hero images referenced from markdown.

Feeds Astro dashboard
Used by dashboard
Deploy 2

Nixpacks

building
deploy — build config

Pinned archive. cd app && npm ci → cd app && npm run build. The recipe Coolify follows.

Feeds Coolify
Used by deploy

Coolify

building
deploy — host

Push to main → auto-deploy → hearth.alterspective.com.au. Phase 0 step 0.5.

Feeds public-internet
Used by igor partners