Skip to content

maintainer reference

Samuel Cavazos edited this page Sep 30, 2026 · 5 revisions

Maintainer reference

User documentation starts with Quick setup and the guide directory. This page holds implementation history, project planning, and documentation maintenance.

Maintain the documentation

Edit the task guide when behavior changes. Add an architecture decision when a trust boundary or significant design choice changes; avoid a new ADR for a routine UI adjustment or bug fix. Keep dated validation evidence in a release or upgrade record. Readers should not need an ADR to complete a user task.

Historical and future references

Architecture decision history

These records explain why decisions were made. Their dates, original UI names, and superseded implementation details remain historical. The Current guide column below is the source for present-day instructions. “Accepted” records can contain details amended by later records; it does not mean every original sentence still describes the current runtime.

We retain the records and their URLs for security/design traceability. In particular, shared workspace trust, ingress authorization, credential ownership, and media isolation remain useful decisions even after the UI changes.

Known amendments: 0002's admin console moved into the desktop in 0004; 0003's shared chat/account and permanent-delete behavior was amended by later privacy, account, and Files work; 0006's authoring restrictions were superseded by 0011; 0013's Team account routing was amended by 0023; 0023's runtime replacement and API-key text-account decisions were superseded by 0028 and 0032; 0033's September 12 amendment permits member manual AI runs while schedule management stays admin-only.

Deployment and access

Decision record Current guide
ADR 0001: Containerize application services behind loopback ingress Deploy your Neural Labs instance
ADR 0002: Embed the control-plane console Authentication and administrator model
ADR 0003: Use one shared developer workspace Sharing and privacy
ADR 0004: Move administrator settings into the workspace desktop Settings
ADR 0009: Run provider MCP inside the trusted shared workspace Workspace-local provider MCP
ADR 0014: Microsoft-bootstrapped passkeys Passkeys

AI accounts and conversations

Decision record Current guide
ADR 0007: Make Alshival conversations private by default Alshival desktop app
ADR 0008: Store Team Chats as explicit control-plane channels Team Chats
ADR 0013: Bind interactive Alshival to personal OpenAI accounts AI accounts and models
ADR 0018: Relay generated Alshival media with short-lived capabilities Alshival desktop app
ADR 0019: Scope Alshival voice by private and team chat boundaries AI accounts and models
ADR 0020: Isolated managed browser for Alshival QA Alshival desktop app
ADR 0023: Scoped model connections and versioned workload defaults AI accounts and models
ADR 0026: Explicitly save chat attachments into the shared workspace Files desktop app
ADR 0028: Unmodified upstream OpenClaw runtime Updating the OpenClaw runtime
ADR 0032: Restrict the workspace OpenAI API key to audio AI accounts and models

Files, terminals, and desktop

Decision record Current guide
ADR 0010: Embed code-server in the authenticated desktop VS Code desktop app
ADR 0015: WebRTC Team Terminal voice Terminal desktop app
ADR 0016: Scope Team Chat terminals to channel membership Terminal desktop app
ADR 0017: Launch static-site previews inside the authenticated desktop Files desktop app
ADR 0021: Recoverable Files operations and isolated image editing Files desktop app
ADR 0025: Alshival participation in interactive terminals Terminal desktop app
ADR 0027: Team Terminal GIF reactions and browser media access Terminal desktop app

Skills, automations, and integrations

Decision record Current guide
ADR 0005: Give the desktop Automations app a dedicated admin ingress Run and manage automations
ADR 0006: Split Skills reads from administrator mutations Skills and graphical builder
ADR 0011: Direct personal and team skills Skills and graphical builder
ADR 0012: Collaborative skill builder and automation read model Skills and graphical builder
ADR 0022: Private profile phone verification Settings
ADR 0024: Global Twilio SMS/MMS channel Settings
ADR 0029: Settings-managed provider credentials Workspace-local provider MCP
ADR 0030: Preference-aware automation notifications Run and manage automations
ADR 0031: Authorized saved-item context actions Skills and graphical builder
ADR 0033: Personal accounts for manual automation runs Run and manage automations
ADR 0034: Owner-scoped Claude connections AI accounts and models

Clone this wiki locally