Stackmates · From goal to proof
Turn a shared goal into tested, reusable progress.
Stackmates is a New Zealand-built development system for small product teams coordinating people and AI. It keeps intent, architecture, implementation, and evidence connected. Dreamineering maps the journey from Reality to Dream to Bridge; Stackmates supplies the execution rails from types to build to proof to learning.
Reality → Dream → Bridge → Proof
One connected journey, five practical stages
Choose a stage to see what the team does, how this page demonstrates it, the evidence it leaves behind, and the next useful action.
Stage 1 of 5
Map Reality
Expose the current workflow, constraints, assumptions, and evidence before choosing a solution.
This page demonstrates it
This introduction starts with the coordination gap: code can be generated quickly, but intent, implementation, and proof often drift apart.
Small product teams working with AI
Proof earns the next decision.
A shared goal becomes a small shipped transformation, with the intent, architectural decisions, implementation, and verification still connected.
- The team can explain why the change exists.
- Architectural boundaries remain visible as the implementation evolves.
- Tests show what was verified—and do not overclaim the customer outcome.
- The useful parts are retained as reusable progress for the next change.
intent
Shared intent
Reality, desired outcome, and the smallest credible bridge.
implementation
Governed implementation
Typed contracts and explicit architecture boundaries.
verification
Verification receipt
Focused tests and evidence matched to the claim being made.
outcome
Outcome account
What changed for the team or customer, including what remains unproved.
Would this evidence be sufficient for another small product team to trust the same workflow?
See the stack
Technology is grouped by the job it performs in the flow—not by logo count.
- Experience
- Next.js, React, TypeScript
- Workspace
- Nx, pnpm
- Architecture
- Domain, application, infrastructure, server, and client layers
- Data and trust
- PostgreSQL, Drizzle, Better Auth
- Agents and proof
- AI SDK, MCP/A2A, Jest, Playwright
Stackmates · Edition 1.0.0
Folio 01
A field manual for
calm app interfaces.
The Stackmates app-interface design system is a small, opinionated set of components — atoms through patterns — built against a single DESIGN.md source of truth. Paper-like surfaces, generous whitespace, one accent. This is the specimen: every tier, ruled and numbered, the way a type foundry catalogues a face.
§00
Specification
The design language in one column. Every component in this manual is measured against these constraints — they are not preferences.
- Theme
- paper — warm canvas, ink, one accent
- Grid
- 4px base · 8px dominant rhythm
- Type
- 16px body · 32px display ceiling
- Depth
- borders over shadows · max nest 2
- Source
- one DESIGN.md · zero raw hex
- Motion
- 80–200ms · reduced-motion first
Index
The catalogue plates
Each tier owns one level of composition. The constraint — a component may only contain components from a lower tier — is what keeps the system legible.
- IDXCatalogue● SetSearchable map of design-system tiers, labs, and workflow studies.Owns — The findability layer for routes, tags, status, and promotion intent.search · tags · status
- AIDDiagram Studio○ In studyA&ID schematics for architecture documentation using the ui-symbols language.Owns — Agency-owned diagram metadata rendered with reusable ui-symbols organisms.A&ID · agency · docs
- VVFLVVFL Loop Gauge○ In studyA verified gauge of wired, dormant, and open value-feedback loops.Owns — The typed visual projection of the checked-in Stackmates loop inventory.VVFL · loop status · evidence
- VSPValue Stream Proof○ In studyEditable Cash Audit from observed flow through bounded experiment and receipt.Owns — The export-first Maximum Enablement of Value proof workflow.cash audit · constraint · receipt
- BPPBetter Practice Picture Proof○ In studyOne Better Practice story projected as desire, value flow, and actionable instruction.Owns — The three-projection implementation bridge for the agency-owned Dream Picture grammar.desire · consent · instruction
- JPSJourney Picture Studio○ In studyAgent-authored hero journeys with governed claims, evidence, authority, and private exports.Owns — The private Journey Partners proof for the agency-owned hero journey picture contract.hero journey · confidence · authority
- UIEUI Evolution Flow○ In studyTyped A&ID proof of the interface evolution loop from demand through reusable composition and back to model evidence.Owns — The self-documenting map of fixture demand, library ownership, creative variants, production pull, and repository feedback.fixtures · typed bricks · feedback
- AID-WDiagram Editor○ In studyConstrained React Flow authoring for Reality, Dream, and Bridge A&ID metadata.Owns — The editor projection that compiles typed symbols, FLOW connectors, lanes, rails, and concept slugs to agency metadata.editor · FLOW · metadata
- DRAWBusiness Stack○ In studyNon-A&ID drawing studies for typed, reusable diagram renderers.Owns — Route-local serializable study data composed with reusable ui-symbols drawing organisms.drawing · matrix · renderer
- RFPRFP Cockpit○ In studyCanonical VariationWorkbench seed for the DRMG Sales RFP review cockpit.Owns — Three complete workflow variants compared before promotion through shared workbench chrome.workbench · queue · evidence · matrix
- WBWorkbench Index○ In studySearchable readiness index for complex-interface variation workbenches.Owns — Workbench job, target user, variants, evidence, downstream pull, readiness, and next proof.readiness · evidence · pull
- RTRealtime Interfaces○ In studyInteraction patterns for audio input, streamed output, interruption, tool feedback, and low-latency repair loops.Owns — The menu category for realtime AI control surfaces: voice capture, streaming response states, event timelines, and recoverable handoffs.audio · stream · interrupt
- GEOGeospatial Opportunity○ In studyProvider-agnostic map workbench for solar roof layout and opportunity scanning.Owns — Reusable geospatial review organism, typed overlay contracts, solar summaries, and local brief output.map · solar · provider seam
- WPWorkflow Patterns○ In studySearchable index of workflow pattern studies for operational surfaces.Owns — Workflow groups, states, responsive behavior, and promotion criteria.jobs · states · criteria
- 00Typography● SetType scale, rhythm, copy hierarchy, numeric treatment.Owns — The page-level rules for headings, body text, labels, and data.Fraunces · system · mono
- 01Atoms● SetZero-composition primitives — buttons, inputs, badges, dots.Owns — A single visual or interactive primitive. Composes nothing below it.forwardRef · CVA · data-slot
- 02Molecules● SetTwo to five atoms composed for one job — selects, comboboxes.Owns — One job done by a handful of atoms. Never contains another molecule.compound · keyboard nav
- 03Organisms○ In studyMulti-molecule features — tables, panels, toolbars.Owns — A feature-complete section built from molecules and atoms.@container · TanStack
- 04Blocks○ In studyPage-section compositions — list views, notice strips.Owns — A full-width page region assembled from organisms.tier scaffolded
- 05Patterns○ In studyReusable stateful UX — shells, wizards, kanban boards.Owns — A reusable interaction pattern that carries its own internal state.stateful · headless
- VTPVoice-to-Project-Planning○ In studySimulated workbench for comparing transcript-first, timeline-first, and command-first AI planning interfaces.Owns — Voice-to-project-planning fixtures, reusable PlanningSessionWorkbench organism, colocated presentation projection, and composition-only design-system evidence.voice · stream · tool repair
── end of index · §01 and §02 are set in type · §03–§05 in study