Vision Architecture
shippingWe explore first, so you build right. The promise that opens every engagement.
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.
Four layers. Top is what clients buy. Middle is the moat. Bottom funds the build. Infra carries the whole thing.
We explore first, so you build right. The promise that opens every engagement.
Where complex work becomes human again. The open frontier of the workshop.
Repeatable productised offerings that compound delivery learnings into client value.
Where methodology and delivery practices are shaped. The pattern library for how we do the work.
Senior engineering made reusable. SDK published, seven reference consumers.
Practice · Principles · Skills · Reference. The structured knowledge layer; bytes in folders without Cortex to serve them.
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.
Shared identity & access platform. Becomes load-bearing when Hearth has users.
Behind you, helping. Never in front, taking over. The locked posture for every AI surface.
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.
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.
Connects Forge methodology to Clio engagements. Keeps the lights on; earns the right to build above.
Connects Forge methodology to Sharedo engagements. Same role as Clio; different vendor.
Independence target: by BREAK (FY29), no single vendor relationship dominates revenue or identity.
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.
The concern is the centre. The lifecycle is the spine. Everything else orbits.
A matter, claim, complaint, risk, obligation, decision, relationship, investigation. The organising centre that everything else orbits.
States, transitions, and possible movements. The flexible backbone the concern moves along — not a railway.
What happened, why suggestions were made, where the human took over, what they decided. Trust artefact, not surveillance.
Email, Teams, portals, calls. Communications attach to the concern, not the inbox.
Structured memory of decisions, documents, communications, prior actions, reusable operational knowledge. The concern remembers.
Letters, contracts, evidence, drafts. Attach to the concern, never to the workflow step.
Soft, contextual next-movement suggestions in peripheral vision. Accept, adapt, ignore, or let them fade.
Email, Teams, document management, practice systems, CRM, finance, portals, calendars, knowledge bases. The connective tissue.
Quality, compliance, obligations, risk — woven into the flow of work, never bolted on as governance theatre.
Roles, responsibilities, communication history, trust, dependencies, commitments. The human map around the concern.
Summarising, drafting, suggesting, checking, preparing, reconciling. Translucent assistance bounded by the Whisper Charter.
Important, but not the centre. A tool the lifecycle can use, not the spine.
Future capability. Deferred from v1 until a Telemetry Charter exists. Opt-in, environment-level only, never per-person performance.
AI authors structured markdown. The dashboard reads it. The two never touch each other. That rule is the architecture.
Concepts, decisions, questions, lineage, research, prototypes, narratives, architecture. Every claim lives in a .md file with locked YAML frontmatter.
_meta/schemas.md. Locked. Every content type declared. Structural changes go through decision records.
Zod-validated glob loaders defined in app/src/content.config.ts. Reads the corpus; refuses to render anything that doesn't match schemas.
Astro 5 + Tailwind. 11 routes today. Igor's visual workspace. Dogfood test for Hearth's own UX philosophy.
Force-directed graph of concept/decision/question/lineage/research/prototype/architecture nodes, edges from related: + wiki-links.
Embedded in markdown bodies. State machines, sequence diagrams, simple flowcharts.
Sessions that author markdown into the corpus. Behind you, helping. Never in front, taking over.
compose-svg + recraft-generate + critique + render-and-screenshot. Generates the hero SVGs the master picture references.
the-workshop.svg, erma-joy.svg, rare-combination.svg. Pre-made hero images referenced from markdown.
Pinned archive. cd app && npm ci → cd app && npm run build. The recipe Coolify follows.
Push to main → auto-deploy → hearth.alterspective.com.au. Phase 0 step 0.5.