CapitalWizards

The Operating Thesis

Behavioral failures destroy more portfolios than poor strategy. Modern retail investors operate across fragmented systems — brokerages for execution, charting tools for analysis, portfolio apps for tracking, news feeds for discovery. None of these manage how capital should behave under stress, opportunity, or volatility. CapitalWizards exists because behavioral discipline cannot be willpower-dependent — it has to be structurally enforced by the system itself.

What We Deploy

• Capital Protection Agreements (CPAs): User-defined behavioral rules ("never deploy more than 10 percent to a single asset", "no trades within 24 hours of a 5-percent loss") enforced by the platform with alerts, violation tracking, and a persistent audit trail.
• Volatility Freezer: Automatic capital lock during extreme market conditions, customizable by asset class. The system enforces the freeze; the user defined the rule when calm.
• Loss Prevention Ledger: Timestamped record of every rule violation and behavioral event. Builds an emotional-decision audit trail that accumulates value over years of investing — your own behavioral history, queryable.
• Behavioral Score: Weekly composite metric showing rule adherence, calmness under volatility, and discipline trend. The score is the user's contract with their future self.
• Strategic Portfolio Builder: Multi-asset allocation framework with rebalancing reminders, drift alerts, and concentration-risk warnings across equities, crypto, forex, and commodities.
• Pre-Trade Thesis Requirements: Every position must be paired with a written rationale, target, stop, and time horizon BEFORE entry. The platform never executes — but it tracks adherence and surfaces the thesis when emotions run hot.
• Opportunity Radar + Sandbox Portfolio: Curated discovery feed for emerging narratives (early-stage crypto, momentum equities, thematic plays) — but every exploratory position lives in a capital-capped sandbox that physically cannot bleed into core capital.

The Three Behavioral Modes

The product is architected around three deliberately separated capital behaviors. Each mode has its own discipline contract, its own UI surface, and its own color language so the user always knows which behavioral mode they are operating in.

• GuardFlow — Protect (red): Capital protection layer. Free tier. Enforces user-defined rules and prevents capital destruction through structurally enforced discipline.
• PrimeFlow — Grow (cyan): Strategy layer. Premium tier. Helps users build deliberate, thesis-driven portfolios across multiple asset classes with allocation discipline.
• EdgeFlow — Explore (purple): Exploration layer. Premium tier. Lets users chase emerging trends without contaminating their core portfolio. The sandbox cap is enforced — overflow attempts trigger GuardFlow alerts.

The Architecture

Production-grade infrastructure. Built on Next.js 16 (App Router) and React 19, deployed to Vercel Edge. Behavioral state lives in Supabase PostgreSQL with Row-Level Security on every user-data table — user A cannot read user B's data, period. Authentication uses Supabase Auth with PKCE flow and SSR-aware cookies. Stripe 22.0 powers freemium subscriptions with checkout, webhook handling, and subscription state syncing. AI workloads run through the Anthropic SDK and Google Generative AI for the Learn Hub content engine. Cloudflare R2 holds MDX assets behind the AWS S3 SDK contract.

What's Built (Verified 2026-05-06)

• 29 pages spanning public marketing surfaces (landing, pricing, Learn Hub with mode/compare/reviews/capital-behavior taxonomies, risk calculator) and the authenticated dashboard (GuardFlow, PrimeFlow, EdgeFlow, analytics, performance, history, assets, content management, settings).
• 37 API route handlers across 13 functional domains — auth, GuardFlow, PrimeFlow, EdgeFlow, dashboard, analytics, assets, journal, notifications, user, Stripe, content engine, affiliates.
• 24 PostgreSQL tables with Row-Level Security on all user-data tables. TypeScript types generated for full type safety.
• 81 Vitest unit and integration tests at 89.81 percent coverage.
• 150 Playwright end-to-end tests — full signup → login → CRUD against real Supabase, tier-based auth matrix, axe-core accessibility on every page, visual regression, security tests covering auth bypass, RLS verification, and XSS / SQLi.
• Six quality gates passed (Gates 1, 2, 3a, 3b, 3c, 3d, 3e, 4, 4a, 4b) under a proprietary eight-phase governance framework. Gate 5 (deployment readiness) currently in flight.
• Documentation depth: PRD at 971 lines, Architecture at 1,050 lines, Design OS at 501 lines, 16 page specs, full Mobile Architecture Addendum for Phase 2.

Regulatory Posture

• Read-only by design: Never connects to brokerage write APIs, never executes trades, never holds custody of funds. The architecture enforces this — it is not a policy choice.
• Not an RIA: The platform enforces user-defined rules, not platform-recommended trades. Financial disclaimers ship with every market-data surface.
• Privacy-first: RLS on all user data. No private keys ever stored. Stripe owns all payment data — the platform never sees card numbers.
• Compliance roadmap: Privacy Policy, Terms of Service, Cookie Policy, GDPR data export and deletion endpoints all pre-launch. SOC 2 Type 1 readiness assessment in Year 1. Multi-region data residency for Year 2 international expansion.

Why This Matters for the Platform

CapitalWizards is the financial-domain instance of the same operating thesis that powers every HavenWizards 88 venture: humans need externalized structure to behave well under uncertainty. The same systems lens that built Bayanihan Harvest (60+ deployed agricultural systems), AgriForge (white-label agricultural SaaS), and HW88 Education (governance pedagogy) now lives in the wealth-management category. The product is the natural consequence of a multi-decade systems lifework — not an opportunistic bet on a hot category.

Roadmap

• Phase 1 — Web MVP (current): Database schema, RLS, auth, all three flows, capital dashboard, analytics, behavioral scoring, Stripe freemium, Learn Hub content engine, 81 Vitest plus 150 Playwright tests. Gate 5 (deployment readiness) in flight; production deployment and soft launch next.
• Phase 2 — Mobile and Expansion (Q3–Q4 2026): Native iOS and Android apps via Expo (architectural addendum already written), YieldFlow module for passive-income optimization, MacroFlow macroeconomic overlays, AI-powered behavioral pattern detection, brokerage read-only API integrations, multi-language support across the top 5 markets.
• Phase 3 — Platform and Scale (2027+): Browser extension trading-platform overlay, public API for behavioral data export, opt-in community behavioral challenges, family-office and enterprise tier, partner-led tax reporting integration.
• Out of scope — by design, forever: Trade execution, personalized investment advice, automated trading or signal services, custody of funds. The boundaries are the moat.

Business Model

• Free (GuardFlow): CPAs, basic volatility alerts, behavioral score, capital dashboard. Acquisition surface — designed to surface user behavioral failures so the upgrade trigger is genuine, not paywalled.
• Prime (~$19 / month): Adds the full PrimeFlow strategy suite — allocation planner, thesis tracking, drift alerts, correlation analysis.
• Edge (~$39 / month): Adds EdgeFlow — opportunity radar, sandbox portfolio, complete premium feature set.
• Year 1 targets: 10,000 registered users, 5,000 monthly active, 8 to 12 percent premium conversion, $15,000 MRR by month 12.

Why Now

Retail represents over 25 percent of daily US trading volume post-2020. Multi-asset portfolios — equities plus crypto plus forex in a single user account — are now the norm, not the exception. AI maturity makes behavioral pattern detection, real-time alerting, and personalized risk modeling technically and commercially feasible at scale. Subscription wealth tooling at $19 to $49 per month is now a normal consumer expense. And no major platform manages capital behavior — the category is undefined and undefended.