THE LAB
Private command center for SKITZO LABS agent operations, skills, web app, and desktop app.
SKITZO LABS
Step: Build Path
Step 1 of 8: Build Path
13%
Server
Online
A clean map of the build path. One step at a time, with locked actions clearly marked.
Build path
Start with one clear idea. THE LAB will turn it into a build plan.
Approval still protects providers, agent execution, deploy, wallet, desktop control, raw output, workspace reads, and secrets.
Live integrations
1
Only verified live surfaces count.
Local surfaces
3
Repo-backed or local-session only.
Blocked gates
7
Credentials, approval, or deployment setup.
Primary operating surfaces and launch readiness.
Private command center for SKITZO LABS agent operations, skills, web app, and desktop app.
Typed directory of THE LAB agent lanes, capabilities, memory scopes, and approvals.
Desktop companion shell for approved local automation, operator control, and saved connection profiles.
Curated local and repo-owned Codex skills with validation metadata.
Typed lanes, capabilities, runtimes, memory scopes, and approval gates.
orchestrator lane / codex / interactive
builder lane / codex / interactive
research lane / manual / approval_gated
deployment lane / manual / approval_gated
orchestrator lane / local_script / batch
review lane / local_script / approval_gated
Every provider is marked local, pending, credential gated, approval gated, broken, mocked, or live.
live
1
local
3
mocked
0
pending
3
broken
0
needs credentials
3
needs approval
1
agent
Available only through the active local Codex session.
Local session: Current Codex execution context.
auth
Client/server helpers exist, but credentials are not present in the repo.
Credentials: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY
Supabase helper: src/utils/supabase/server.ts
agent
Groq key intake is modeled for free-model routing, but no Groq endpoint is called and no runtime adapter is live.
Credentials: 12 credential names tracked in the vault inventory
Required key names: GROQ_API_KEY_01 through GROQ_API_KEY_12
agent
ElevenLabs key, agent, and voice values are encrypted in the VDS vault, but the replacement app does not load them or call ElevenLabs.
Credentials: 78 credential names tracked in the vault inventory
Secret preservation manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
agent
LiveKit values are encrypted in the VDS vault. No realtime voice path is wired into THE LAB replacement app.
Credentials: LIVEKIT_API_KEY, LIVEKIT_API_SECRET, LIVEKIT_TOKEN_TTL_SECONDS, LIVEKIT_URL
Runtime secret manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
browser
VAPID values are encrypted in the VDS vault. Push is not wired in the new app.
Credentials: VAPID_CLAIMS_EMAIL, VAPID_PRIVATE_KEY, VAPID_PUBLIC_KEY
Runtime secret manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
repository
No remote or GitHub connector state is established in the repo.
Credentials: GITHUB_TOKEN
Git status: No commits yet on main.
deployment
Root SSH access is verified and nginx routes public root traffic to THE LAB Next production candidate. The legacy FastAPI app remains active for rollback.
Credentials: VDS_SSH_HOST, VDS_SSH_USER, VDS_SSH_PRIVATE_KEY
VDS host IP: VDS_SSH_HOST=95.111.231.21
browser
Can validate local UI after the dev server starts.
Dev script: package.json#scripts.dev
desktop
GUI bridges require explicit macOS Accessibility approval.
Bridge docs: AGENT_HUB_README.md
desktop
Tauri v2 is selected, a minimal read-only native scaffold exists, and desktop credential profiles are redacted vault references only. Native builds, signing, notarization, runtime credential use, and automation remain pending or approval-gated.
Desktop runtime model: src/lib/desktop/runtime.ts
A typed node graph for intake, routing, build, memory, approval, validation, and deployment.
input
Captures the user prompt, project goal, files, brand rules, image references, video references, and product constraints before the pipeline is planned.
planner_agent
Breaks one idea into connected tasks, model tiers, parallel lanes, approval gates, and the best node-wire map for the product.
research_agent
Gathers references, docs, trends, competitors, and source material only after external research approval exists.
image_agent
Plans visual assets, UI mockups, textures, icons, product images, and style frames from prompt and references. Generation is not wired live yet.
video_agent
Plans motion, trailers, b-roll, previews, and product walkthrough clips. Video generation remains approval-gated.
three_d_agent
Plans Three.js scenes, models, lighting, shaders, materials, and 3D interaction states. 3D execution remains gated.
code_agent
Builds frontend, backend, components, API routes, Three.js scenes, and integration scaffolds through the existing Build Mission and Review Lane controls.
memory_skill
Captures reusable workflows, skills, decisions, and architecture notes after the run. Durable writes remain approval-gated.
approval
Reviews risky actions before provider calls, generation runtimes, runner pickup, durable memory, desktop automation, wallets, or deployment mutation.
qa_agent
Tests design, responsiveness, bugs, performance, type safety, and build health. Failed checks route into Fix Agent.
fix_agent
Repairs failed steps, routes fixes back to Code Agent, and requires validation evidence before the deploy gate.
deploy_agent
Ships through VDS/GitHub runbooks after validation and gates. Public root is live, but new deployment mutation remains separately controlled.
Repo and plugin skill inventory with lifecycle state.
repo / draft
Repo-owned operating skill is scaffolded locally; distribution and linting are not wired.
.agents/skills/skitzo-labs-agent-system/SKILL.md
Skill file: .agents/skills/skitzo-labs-agent-system/SKILL.md
repo / ready
Default shipping loop skill is local and ready for operator use; it pushes build-first execution, quick validation, blocker repair, and risk logging.
Depends on skitzo-labs-agent-system
skills/ship-first-autonomy.md
Skill file: skills/ship-first-autonomy.md
repo / ready
Default model routing skill is local and ready for operator use; it defines tiered model use, escalation rules, de-escalation, and safe parallel worker patterns.
Depends on ship-first-autonomy
skills/model-router-autonomy.md
Skill file: skills/model-router-autonomy.md
repo / ready
Automatic skill evolution guide is local and ready for operator use; it creates or upgrades skills, workflows, checklists, scripts, and routing rules when the impact score is high enough.
Depends on ship-first-autonomy, model-router-autonomy
skills/skill-generator-autonomy.md
Skill file: skills/skill-generator-autonomy.md
repo / ready
Compression skill is local and ready for operator use; it turns long repo context, validation output, and handoffs into compact state vectors without hiding approvals, risks, or secrets policy.
Depends on model-router-autonomy, skill-generator-autonomy
skills/context-compression.md
Skill file: skills/context-compression.md
repo / ready
Coordination skill is local and ready for operator use; it splits large work into disjoint ownership lanes, worker briefs, review passes, and validation checkpoints without bypassing approval gates.
Depends on context-compression, model-router-autonomy
skills/parallel-agent-coordination.md
Skill file: skills/parallel-agent-coordination.md
repo / ready
Worklog memory skill is local and ready for operator use; it keeps concise repo-local build memory, risk routing, validation state, and next-step continuity without exposing secrets or enabling durable external memory writes.
Depends on context-compression, ship-first-autonomy
skills/worklog-memory.md
Skill file: skills/worklog-memory.md
repo / ready
Risk log management skill is local and ready for operator use; it classifies deferred issues, blocks critical risk deferral, links risks to release gates, and keeps approval or credential gates truthful.
Depends on ship-first-autonomy, worklog-memory
skills/risk-log-management.md
Skill file: skills/risk-log-management.md
plugin / ready
Available in the local Codex environment; not a production runtime dependency.
Build Web Apps plugin
Skill availability: Listed in current Codex skills.
repo / ready
Repo-owned visual polish skill for THE LAB Studio; it enforces prompt-first creation, spacious canvas hierarchy, liquid-glass surfaces, clean Node/Visual toggles, and no redundant boxed dashboard clutter.
Depends on ship-first-autonomy, model-router-autonomy, frontend-app-builder
skills/premium-studio-visual-polish.md
Skill file: skills/premium-studio-visual-polish.md
repo / draft
Docs structure exists after scaffold; examples and lint rules are not complete.
Depends on skitzo-labs-agent-system
docs/skills/README.md
Skills docs: docs/skills/README.md
repo / draft
Planned but not scaffolded in this pass.
Depends on skitzo-labs-agent-system
.agents/skills/deployment-review/SKILL.md
Backlog: Add after deployment model is persisted.
repo / draft
Planned but not scaffolded in this pass.
Depends on skitzo-labs-agent-system
.agents/skills/integration-triage/SKILL.md
Backlog: Add after provider credential map is approved.
Project, agent, workflow, integration, and deployment memory scopes.
project / manual_doc / project / internal
project / manual_doc / long_term / internal
agent / typescript_seed / project / internal
workflow / typescript_seed / project / internal
deployment / database / long_term / sensitive
Server-side secret preservation without exposing values or pretending integrations are live.
credential_manifest / server_side_only / not wired
Protected archive and manifest were created on the VDS. Secret values remain server-side and are not committed to this repo.
Keys: No key names required
Backup archive: /root/the-lab-backups/latest-secret-config.tar.gz
api_key / server_side_only / not wired
Key values were imported into the encrypted VDS control-plane vault after approval. THE LAB replacement app does not call ElevenLabs yet.
Keys: ELEVEN_KEY_ANTIGRAVITY, ELEVEN_KEY_CL_BREAKER, ELEVEN_KEY_CL_CHALLENGER + 23 more
Key manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
agent_id / server_side_only / not wired
Agent ID values were imported into the encrypted VDS control-plane vault after approval. Agent runtime wiring is not live yet.
Keys: ELEVEN_AGENT_ANTIGRAVITY, ELEVEN_AGENT_CL_BREAKER, ELEVEN_AGENT_CL_CHALLENGER + 23 more
Agent manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
voice_id / server_side_only / not wired
Voice ID values were imported into the encrypted VDS control-plane vault after approval. No voice synthesis integration is wired into THE LAB replacement app.
Keys: ELEVEN_VOICE_ANTIGRAVITY, ELEVEN_VOICE_CL_BREAKER, ELEVEN_VOICE_CL_CHALLENGER + 23 more
Voice manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
service_config / server_side_only / not wired
Hub, LiveKit, and web push values were imported into the encrypted VDS control-plane vault after approval. Runtime integrations are not live yet.
Keys: HUB_ADMIN_PASSWORD, HUB_ANTIGRAVITY_MODE, HUB_CODEX_MODE + 21 more
Runtime manifest: /root/the-lab-backups/latest-secret-config-manifest.txt
connection / not_collected / not wired
Root SSH is verified from this machine, but the new app needs named deployment credentials in an approved vault before automated deploys.
Keys: VDS_SSH_HOST, VDS_SSH_USER, VDS_SSH_PRIVATE_KEY + 1 more
Required names: docs/deployment/VDS.md#required-credential-names
api_key / not_collected / not wired
Groq is planned as a free-model provider with 12 key slots. Keys must be imported through Secure API Key Intake; no Groq runtime or health call is wired live.
Keys: GROQ_API_KEY_01, GROQ_API_KEY_02, GROQ_API_KEY_03 + 9 more
Required key names: GROQ_API_KEY_01 through GROQ_API_KEY_12
Human gates for deployments, memory, external research, and desktop automation.
Public release can expose unfinished local-only surfaces.
Incorrect DNS can break the public domain.
Promotion can move agent-written changes into the visible build. It must not expose raw output, raw workspace files, secrets, provider calls, wallet actions, desktop automation, or public deploy authority.
Desktop automation can paste or operate local apps.
Incorrect import could expose, rotate, or misroute existing API keys, VPS connections, or voice IDs.
Uncontrolled execution could run provider calls, leak operational context, mutate production, or cross the wallet/provider/desktop boundaries.
Provider generation can spend credits, expose prompts or references to third parties, and return unsafe or unusable assets if not scoped to staging.
Desktop packaging can create local binaries and artifacts; it must not silently enable automation permissions or secret storage.
Memory records may contain sensitive operational context.
External requests may disclose intent or depend on unstable third-party state.
Validation model and commands that must run before promotion.
npm run typecheck
npm test
npm run build
npm run dev -- --hostname 127.0.0.1 --port 3000; curl http://127.0.0.1:3000
npm run automation:vds:verify-staging
npm run automation:plan; npm run automation:validate; npm run automation:vds:deploy-staging; npm run automation:vds:verify-staging
manual credential audit
Local, VDS staging, and VDS production tracks with promotion policies.
Next dev server
Local server only; not a public deployment.
Policy manual / Commit working-tree
VDS staging slot
Replacement Next app is live on an isolated VDS staging route. Public root is now cut over to the production candidate.
Policy manual / Commit pending
skitzolabsagents.com
Approved production cutover is complete; nginx routes public root traffic to the Next production candidate and legacy service remains available for rollback.
Policy manual / Commit pending
Safe automation is executable now; production, secret import, durable memory, and desktop control stay approval-gated.
npm run automation:validate
Runs the local typecheck, test suite, and production build in sequence.
npm run automation:vds:backup
Creates a protected server-side archive and manifest without printing or copying secret values.
npm run automation:vds:deploy-staging
Deploys the replacement Next app to the isolated VDS staging route without touching the production root app.
npm run automation:vds:verify-staging
Checks the staging health endpoint, THE LAB rendered route, current symlink, and public production cutover state.
npm run automation:vds:setup-control-plane
Installed and configured the VDS-hosted control plane for automation state. It does not import preserved secret values or cut over production.
npm run automation:staging
Runs the safe automation chain end to end for local validation, VDS backup, staging deploy, and staging verification.
npm run automation:vds:production-preflight
Read-only VDS preflight confirms production candidate health, nginx/TLS presence, and provider readiness metadata without changing DNS or services.
npm run automation:vds:production-cutover
Approved cutover automation completed and nginx routes public root traffic to the Next production candidate.
npm run automation:vds:import-secrets
Secret import ran after explicit approval and encrypted 102 values into the VDS control-plane vault. Secret values are never returned to the browser.
npm run desktop:native:inspect
Inspects the native scaffold without running a Tauri build, starting desktop automation, or reading secrets.
not implemented: approval-gated
Desktop runtime path is selected, but local automation remains blocked until explicit macOS Accessibility approval and a desktop audit policy exist.
not implemented: needs credentials
The schema and storage target still need credentials before automated writes can exist.