Recommended paths
Reality path
Start here
Codex Roadmap
Code-grounded roadmap for turning the Reaktor Workbench prototype into a real control plane.
Read first when deciding what needs to become real and in what order.
Strategic Roadmap
Product and platform roadmap covering phases, modules, moats, risks, and success metrics.
Use for strategic framing and product sequencing.
Implementation Plan
Execution plan for moving from prototype to production workbench and Compose/web target.
Use when converting roadmap intent into engineering tracks.
Critique
Codex Critic Review
Skeptical counterarguments against the full Reaktor control-plane vision.
Read before expanding scope or trusting a broad roadmap.
Claude Critic Review
Adversarial review of architecture, feasibility, competition, and go-to-market risk.
Use as the second opinion and adoption-risk check.
Competitive Landscape
Positioning against visual builders, node editors, and AI-native tooling.
Use when clarifying differentiation and market pressure.
Architecture
Graph Kernel Analysis
Universal composition architecture for the graph runtime, modules, visitors, and command model.
Use to understand the smallest kernel that should stay stable.
Reaktor Graph Migration Plan
Migration plan for tightening RouteBinding, navigation edges, themed UI scope, and graph runtime ergonomics.
Use when evolving reaktor-graph APIs without breaking product apps.
Reaktor Graph Refinement Plan
Layered refinement plan grounded in BestBuds friction points: stronger Type, port shapes (StatePort, StreamPort, RequestPort, MailboxPort), hook controllers, behavior actors, route tables, and module supervision.
Use when planning the next round of expressiveness work on reaktor-graph and reaktor-graph-port.
Reaktor Graph Visitors
Refined visitor architecture: routing, wiring, deep links, analytics, auth, workflow compilation, graph export, validation, and debugging as graph passes over selected views.
Use when designing a new graph pass or extending selectors/traversals.
Reaktor Actor Model
Updated actor model design: one ActorNode primitive with a mailbox, exclusive ObjectStore, direct node map storage, consumes/provides wiring, and Durable Object deployability.
Use before implementing actors in reaktor-graph or migrating BestBuds chat to ChatActor/ChatRoomActor.
Framework Architecture Analysis
Deep architecture notes on PortGraph, KMP execution, edge caching, FFI, and app DX.
Use for broad architecture review and idea inventory.
Multiplatform Analysis
KMP target coverage, memory model, FFI, Cloudflare bridges, UI decoupling, and LLM integration analysis.
Use for cross-platform and runtime tradeoff scanning.
Flow Analysis
Comparison of react-flow, compose-flow, and reaktor-flow architecture and tradeoffs.
Use when working on visual graph editing and flow UI decisions.
Platform services
Claude Reaktor Notifications Design
Detailed reaktor-notifications runtime design covering canonical module naming, intake/bus/delivery/client graphs, Expo comparison, engagement scope, and dependency readiness.
Use as the broad system design and implementation-sequencing reference for notifications.
Codex Reaktor Notifications Design
Full-stack design for the reaktor-notification module: client permissions, endpoint registration, FCM/APNs/Expo delivery, receipts, policy, and graph routing.
Use before implementing notification runtime work or migrating BestBuds notification stubs.
Workbench
Workbench Feature Gap Analysis
Prototype gap analysis covering screen-level gaps, differentiators, and implementation priorities.
Use when prioritizing visible workbench functionality.
Engine and Website Implementation Report
Detailed account of the KMM engine migration, Kotlin/React website renderer, Compose parity work, tests, performance harnesses, and Reaktor Graph pain points.
Use when reviewing what was implemented and what the graph runtime should improve next.
UI and interop
React × Compose Blueprint
Implementation blueprint for React as control-plane language over native Compose rendering and Compose-authored UI on React DOM.
Use as the detailed technical design for the React and Compose bridge.
React × Compose Interop Roadmap
High-performance interop roadmap for bridging React and Compose across platforms.
Use for phased interop execution and runtime performance checkpoints.
Reaktor Desktop v3
Interactive high-fidelity desktop workbench artifact.
Use to inspect the current visual target and interaction model.
BestBuds
BestBuds UI Migration Plan
Plan for migrating the real BestBuds app UI to the prototype and desktop website design language.
Use before extracting the BestBuds design system or restyling app screens.
BestBuds Market Readiness UX Audit
Screen-by-screen visual and experience audit for making the real BestBuds app launch-quality.
Use when polishing every app surface for first-session impact and retention.
BestBuds Architecture Refactor Plan
Atomic design and React/actor refactor plan for separating data, actions, state, and UI across the real BestBuds app.
Use before the comprehensive interactor, actor, and component layering pass.
Security and auth
Auth Architecture and Redesign
Principal, token, session, authorization, and adapter redesign plan for reaktor-auth.
Use when working on auth kernel boundaries and API shape.
Security Implementation Plan
Threat model and security hardening plan for Reaktor services and workbench operations.
Use before enabling mutating commands, deploy actions, or remote agent workflows.