Actionist Knowledge Graph
P07 · Experience knowledge node

Token and theme harmonizer

Preserve the quality of each imported capability while translating its visual assumptions into one semantic Actionist/client token system.

Problem boundary

What this subsystem owns and what it must hand to the rest of Actionist.

What it owns

  • Token extraction
  • Primitive-to-semantic mapping
  • Scoped CSS/theme bridges
  • State coverage across light/dark/hover/focus/error
  • Visual coherence checks

What research already found

  • Blocks should consume semantic tokens rather than hard-coded brand values
  • Existing Teable work shows format conversion and scoped bridges are safer than blind aliasing
  • Taste profile and component selection are inputs, not the same artifact

Open first-principles questions

  • How much donor visual identity should remain?
  • Can token mapping be inferred reliably?
  • How are unmapped bespoke CSS and canvas surfaces handled?
  • What score means two blocks look coherent?

Inputs

  • TasteProfile
  • Donor styles
  • Component tokens
  • Brand assets

Outputs

  • ThemeContract
  • TokenMap
  • ScopedThemeBridge
  • VisualReceipts

Scientific research protocol

Every research owner uses the same evidence funnel. No padding is allowed when a denominator is inapplicable or evidence is unavailable.

Prior evidence auditRead the canonical spine, all domain-linked artifacts, the 17-industry catalogue and existing contradictions before searching again.
Commercial 100 → 10Define a denominator, map approximately 100 companies/products, and produce first-party dossiers for the strongest 10.
GitHub 100 → 10Search and dedupe approximately 100 relevant OSS projects, then deeply inspect the strongest 10 at the capability and architecture level.
Local estate joinInspect AutoSaaS, Great Library, SISOCRM, 21st stores and other domain-specific precedents already on the laptop.
Innovation 100 → 10Generate a wide divergent idea register, score it against the problem and retain the 10 strongest falsifiable innovations.
First-principles synthesisDecompose the irreducible problem, challenge inherited assumptions, reconcile contradictions and state the minimum sufficient design.
Contracts and experimentsReturn the proposed contract, dependency edges, unknowns, falsifiers, experiments, stop rules and decisions.
Independent verificationA separate verifier checks counts, links, source claims, overlap, contradictions and unsupported conclusions before promotion.

Evidence and agent outputs

Existing research remains source evidence. New agent packets are written to one owned workstream directory and linked here after verification.

ArtifactLocationState
Universal Block Framework visual contractresearch/actionmodel-builder-research-2026-08-26/phase-8/lanes/01-universal-block-framework/outputs/universal-block-framework.mdexisting
Token-pack scienceresearch/token-pack-science-2026-08-27.mdexisting
SISOCRM Teable absorption brief/Users/shaansisodia/SISO_Workspace/SISO_Agency/apps/SISOCRM/verticals/business-broker/TEABLE-ABSORPTION-BRIEF.mdexisting
Future verified agent packetresearch/workstreams/P07-token-and-theme-harmonizer/runs/<run-id>/planned

Agent-sized objective

Define the semantic token contract and prove harmonization across three visually different imported surfaces.

See sprint assignment →