AI Resources

Static Agentic Architecture

The accurate version. There is no single source of truth. There is federated ownership: each field has exactly one system of record, tokens live in the repo and sync to Figma, prop contracts are generated from code instead of re-authored, and a drift checker flags mismatches instead of silently deciding which side wins. Deliberately lean: a spine to extend, not a cage.

Reference Architecture: Federated · Owned · Leansolid = request path · dashed = automatic or background
DIRECTIONPersonintent(), plain languageApprovehard human gate:judgment under testINTELLIGENCE · CLAUDEOrchestratorplan() then validate() then draw()Research agentretrieve(), least privilegeDesign agentcompose(components, tokens)Validatorverify(policy): deterministic, blocking, separate dutyeach: one role · a constitution · minimal scopesthe agent’s judgment is what the validator testsFIELD OWNERSHIP · NO SINGLE SOURCE OF TRUTHvisual intent → Figma (the canvas)token values → repo (DTCG format) → synced to Figmacomponent identity + behavior → registrypolicy / guardrails → registry (the lean spine)shipped appearance → code, not Figmaprop contracts → generated from code, never re-authoredDRIFT IS FLAGGED, NEVER AUTO-RESOLVEDcompare_figma_to_registry → { status: "failed", differences: [...] }the system surfaces the mismatch; a person decides which side winsOWNED MCP GATEWAYauthz · scopes · monitoring · append-only auditvendor servers connect under our policy, not the reversedesign-systemproduct-contextanalyticsfigma · vendorTHE SKIN · BRAND & IDENTITYdesign-tokens.jsonDESIGN-OWNED · REPO (DTCG) → SYNCED TO FIGMAbrand rulesDESIGN-OWNED · STRUCTURED, MACHINE-READABLEone Skin, many Skeletonsthe portable, durable layer: it survives when thefront-end library churns. Loose coupling, appliedto the design system itself.THE SKELETON · COMPONENT SUBSTRATEcomponent libraryENGINEERING-OWNED · WHAT SHIPSprop contractsGENERATED FROM CODE · NO PARALLEL YAML TO DRIFTthe lean guardrail spinemust-not-fail policy only: legal disclosures · a11y ·brand · perf. Enforced by the validator and CI.as lean as the guardrails require, no leaner.CONTEXT · EVIDENCE · CANVASproduct contextpersonas · JTBD · journeys · research (RAG + memory)live evidenceproduct analytics: aggregate, read-onlyFigma canvasdesign-intent surface, where people do visual craft.Kept in sync and drift-checked. Not production truth:shipped pixels are rendered by code.all access crosses the gatewayship on yestokens sync → Figmaoutcomes → memory, via the gateway