Docs
38 docsBrandGym v3 strategy, architecture and implementation documentation.
Decisions
Canonical state snapshot: what is currently true, canonical, supporting, legacy and still missing in BrandGym.
Canonical truth hierarchy for BrandGym docs across canonical core, active supporting, partial, legacy and superseded layers.
Architecture
Canonical architecture overview for BrandGym v3 platform — tech stack, regions, multi-tenancy, Jimmy integration.
Defines the new code home, repo structure, role distribution, and migration logic for BrandGym v3.
Canonical multi-layer memory model for person, project, tenant and operational memory including retrieval, writes and scope logic.
Canonical orchestration and governance layer covering routing, delegation, reviews, approvals, risk and tool control.
Canonical company-brain model spanning public signals, internal truth, human-curated reality and derived operational profiles.
Implementation
Concrete starting structure, ordering and minimum configuration for brandgym-platform.
Concrete task list to set up brandgym-platform and start apps/brandgym-dev cleanly.
Concrete build order for BrandGym v3 / brandgym.dev — from shell through docs, repos, board to dummy tenant.
Phased implementation plan for BrandGym v3 — from monorepo bootstrap to full tenant onboarding.
Data Model
Binding data model for BrandGym Platform v3 — tenants, Jimmy, billing, domains, migrations.
Canonical object model for module capabilities, vertical packages, industry blueprints, integration registry and roadmap initiatives.
Canonical runtime object family map for identity, company brain, external context, execution, conversation, governance and capability domains.
Canonical control-plane plus tenant-runtime Firestore architecture with separate database per company and governed secret bindings.
brandgym.dev
Defines brandgym.dev as strategic, operative and documentation command center of BrandGym v3.
Binding data model for brandgym.dev — strategy_docs, board_cards, repo_registry, jimmy_update_jobs etc.
Defines navigation, page structure, main views and object flows for brandgym.dev.
Detailed UI/UX blueprint for brandgym.dev — screens, panels, widgets, filters, interactions.
Canonical internal control-plane module for tenant runtime health, execution tracks, browser runs, approvals, credentials, audit and intervention.
Canonical role and permission model for brandgym.dev across visibility, diagnostics, runtime action, governance and security scopes.
Canonical attention and escalation model for runtime alerts, priorities, role routing, bundling, snooze and escalation ladders.
Canonical UI map translating runtime, alerting, audit, approval, policy and credential logic into concrete brandgym.dev screens and navigation.
Dummy Tenant
Billing
Research
Operations
Canonical hero direction for BrandGym: Agentic as the main thesis, rotation logic, motion principles, CTA hierarchy and mobile behavior.
Canonical visual and tonal DNA for BrandGym: subtle gym metaphor, premium dark-first system, Jimmy as guide and anti-kitsch guardrails.
Canonical delivery architecture for BrandGym across platform CI/CD, tenant runtime CI/CD and agent/prompt/policy CI/CD.
Canonical execution-track model for phases, steps, blockers, checkpoints, handoffs, retries and outcomes.
Canonical browser-worker execution service with spawn-execute-report-destroy lifecycle, goal contracts, approvals and evidence.
Canonical multidimensional policy matrix across action class, scope, risk, competence, platform, credential mode and approval mode.
Canonical audit, evidence and run-record layer for explainable, reviewable and trustable agentic execution.
Canonical behavioral model for BrandGym communication: direct, structured, non-sycophantic, proactive-with-measure and work-friendly.
Jimmy
Canonical architecture for the person, project and tenant intelligence layers — Jimmy/Jenny, Grace, Emily and specialist agents.
Canonical operating model for Jimmy/Jenny as personal front-orchestrator, triage anchor, result aggregator and follow-up owner.
Canonical project/room intelligence model for Grace as project memory, coordination, handoff and visibility-state layer.
Canonical tenant-wide company intelligence model for Emily as standards, prioritization, quality and cross-project signal layer.