Braxton Core

Private Next.js App Router foundation for Braxton Core — the command brain for DrH / LightGod / IPXS and manager of the owned IPXS Agent Roster infrastructure.

Braxton MVP Overview

Braxton Core is an internal executive command center with protected dashboard routes, Supabase Auth, mock task APIs, and Supabase-ready schema.

Stack

• Next.js (App Router) + TypeScript
• Tailwind CSS (premium dark theme)
• Supabase Auth (email/password)
• Supabase-ready schema + server-side API routes

Environment Variables

Create .env.local from .env.example:

cp .env.example .env.local

Required values:

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY (server-only, never expose in client)
• OPENAI_API_KEY (reserved for future server-side generation)
• NEXT_PUBLIC_SITE_URL (default http://localhost:3000)
• BRAXTON_APP_ENV (default development)

Supabase Auth Setup

1. Create a Supabase project.
2. In Authentication → Providers, enable Email provider.
3. In Authentication → URL Configuration, set site URL to your local/dev URL.
4. Run supabase/schema.sql in SQL editor.
5. Create first user:
   • Option A: use Authentication → Users → Add user in Supabase dashboard.
   • Option B: use the app /login Create account button.

MVP security note: current RLS policies are per-user owner access only. Tighten role-based policies before collaborator access.

Auth + Route Protection

Protected routes include:

• /dashboard
• /dashboard/tasks
• /dashboard/approvals
• /dashboard/memory
• /dashboard/outputs
• /dashboard/settings
• /dashboard/agents
• /dashboard/agents/factory
• /dashboard/agents/roster
• /dashboard/agents/skill-packs
• /dashboard/agents/applications
• /dashboard/agents/recruiter
• /dashboard/agents/moltbook
• /braxton

Behavior:

• Logged-out users are redirected to /login.
• Logged-in users visiting /login are redirected to /dashboard.
• Dashboard topbar shows authenticated user email and supports sign out.

Agent Factory + IPXS Agent Roster Overview

Braxton Core includes a mock-first architecture for managing specialist agents through:

• Agent Factory (categories, templates, and mock deployment planning)
• IPXS Agent Roster (owned roster profiles and hiring-readiness structure)
• Skill Pack Library from RUN GPT Source Library conversion
• Recruiter Agent rubric-based application review
• Subscription-readiness table/layout placeholders
• Optional Moltbook Identity Bridge fields only (never required)

RUN GPT → Skill Pack Concept

RUN GPT (legacy family of 70+ custom GPTs) is represented as source capability inventory and converted into categorized Skill Packs that can be attached to reusable Agent Blueprints (templates) and deployable agents.

Agent categories and starter templates

• Categories: see lib/agents/agent-categories.ts
• Starter templates: see lib/agents/agent-templates.ts

Optional Moltbook bridge

Moltbook is optional external identity/reputation metadata only. Braxton Core and the IPXS Agent Roster remain system-of-record for agents, approvals, subscriptions, logs, and hiring workflows.

Mock API routes

• POST /api/braxton/task — mock Braxton task output.
• POST /api/agents/create — mock agent profile generation from selected template/category/skill packs.
• POST /api/agents/recruiter-review — mock rubric scoring for applications.
• POST /api/moltbook/mock-verify — mock optional identity verification payload.

What remains mocked

• Agent creation execution is planning output only.
• Recruiter decisions are simulated.
• No real OpenAI generation or autonomous agent execution.
• No real public onboarding flow.
• No real payments or subscriptions.
• No real Moltbook API calls.

Future live integration would require

• Auth-aware CRUD APIs with RLS policies for new agent tables.
• Billing provider integration for subscription tiers.
• Verified external identity sync adapters (including optional Moltbook connector).
• Real execution runtime for specialist agents and audited approval gates.

Local Development

npm install
npm run dev

Validation

npm run lint
npm run build