GRID-GUIDE-001 Rev A.3

The Guide

The first complete written reference to Agent Space, ArcGrid, the Grid, the Surface, and every component, product, and sister business around them. 40 chapters authored from the design record through October 2026. Rev A.3 is unverified against the running system - Rev B (with verification) is the next milestone.

40 Chapters Rev A.3 Draft - unverified 210+ capabilities tracked 2026-10-04

Overview

GRID-GUIDE-001 is the platform's founding written record. Charles authored it from the design conversations, handoff packages, and decision records produced through October 4, 2026. It runs top-down: the company and doctrine first, then infrastructure, then every Surface area, then extensions, products, and sister businesses.

The guide was written from the design record, not from the running system. That distinction is intentional. The Grid has been building from these designs and knows what actually shipped. The role of the assimilation process (Rev B) is to reconcile the two: verify every capability row, overwrite anything that changed, fill the gaps, and produce the authoritative reference.

Precedence rule: The running system wins over this guide for facts about what exists and how it behaves. A ratified decision in the handoff registry wins over this guide for questions of intent. This guide wins over unratified drafts only where it records a later decision by Charles.

40
Chapters
210
Capabilities
9
Parts
20
Open Qs
30+
Gating items

Chapter structure

Every chapter follows the same skeleton so the Grid can parse and update it mechanically. Section 9 is the verification block - the Grid fills in what is actually true today with evidence.

  • 1. What it is
  • 2. Why it exists (the business reason)
  • 3. What makes it up (components and sub-parts)
  • 4. How team members use it
  • 5. How the agentic infrastructure shows up in it
  • 6. Technical underpinnings
  • 7. Governing packages and records
  • 8. Open decisions
  • 9. Live in the UI vs. not live (the verification block - Grid completes this)
LIVE - Shipped and in use
PARTIAL - Subset live
SPEC - Package exists, not built
CONCEPT - Discussed, no package
UNKNOWN - Grid must determine

Chapters

Part I The Company and Platform
CH01
Agent Space, LLC
Iowa LLC, ownership map, ArcGrid Atlas, Brain licensing structure
LIVE
CH02
ArcGrid, the Platform
Surface + Harness halves, what can be sold, deployment models
LIVE
CH03
The Doctrines
Human Approval Gate, Pack Doctrine, Toll Doctrine, Clean Room, VSG rigor ladder, Assay Doctrine
PARTIAL
CH04
The Operating Surface Thesis
Intent bar, signal taxonomy, five-tier consequence ladder, Active Vault view
UNKNOWN
CH05
The Commercial Model
Retainer billing, feature matrices, Brain license revenue, pack revenue, microdatacenter billing
LIVE
Part II The Engine
CH06
The Grid (Infrastructure)
ArcRig fleet, ArcHelm, network phases, ArcNode, microdatacenter, cloud production
PARTIAL
CH07
The Harness (Agent Execution)
Named agent roster, n8n factories, ArcFlow, ArcCycle, Plays, actuation lane, autonomous build
PARTIAL
CH08
The Brain (ArcBrain)
ArcRouter, ArcCharter, ArcHub, ArcGraph, Noema models, ArcWitness, memory architecture, Brain SDK
PARTIAL
CH09
The Vault (ArcVault) and the Ledger
SOPS/age secrets, classification ladder, Ledger receipts, Vault SDK, DATACLASS, OpenBao
PARTIAL
Part III The Surface (15 areas)
CH10
The Surface, Overview
Left nav, design system, workspace switcher, living UI, Selection Loop, PWA track
PARTIAL
CH11
Home
Agent-authored summary band, interim hub, daily signal cards
LIVE
CH12
Curate (1:1 Agent Sessions)
Session object, artifact tray, promotion with provenance, conversational cycle intake
UNKNOWN
CH13
Chat (formerly Discourse)
Channels, agents in channels, Discord-style permissions, CHATPERM-001 Rev B
LIVE
CH14
Work (Engagements, Work Items, Plays, Flows, Cycles)
Groups/items/sub-items, flows, projects, reports, Plays, ArcCycle, Monday migration
LIVE
CH15
Time (ArcTime)
Signal and manual entries, week expectation bar, Clockify parity, team migration
LIVE
CH16
Calendar
Google Calendar sync, pre-call briefs, Iris attaching artifacts to events
LIVE
CH17
Clients (the Client Record and Lifecycle)
Client record, dashboards, LIFECYCLE-001 Rev B, Unified Organization record, lifecycle plays
LIVE
CH18
Audience
CRM-type lens on person graph, consent doctrine, GHL still in use for sending
CONCEPT
CH19
Wire
Intelligence monitoring pipeline, posting topics, graded intel briefs
UNKNOWN
CH20
Studio (and the Demo Suite)
Agents in Studio, ArcAtelier, Demo Suite, render pipeline, design reference library
LIVE
CH21
Whiteboard
ArcFigure engine, graph-backed canvas, group thinking surface
SPEC
CH22
Code (Development Management)
ArcAware, Surface Bridge, PRAuto, ArcQA, autonomous build loop, mobile view, CODE-001 Rev D
PARTIAL
CH23
Console and the Operator Console
Health and cost views, Operator Console workspace, fleet control, workspace switcher
LIVE
CH24
Findings (Flagin inside the Surface)
Flag widget, Findings board, FLAGIN-001 v0.1
SPEC
Part IV Extensions and Products
CH25
Client Portals and clientportals.vip
19 tenants live, portal template, feedback toolbar, IDENTITY-001 gate replacement
LIVE
CH26
Surface Editor
Code-OSS based editor, workspace launcher, gated phase
CONCEPT
CH27
Flagin
Standalone feedback and flagging product; flagin.app; SDK
SPEC
CH28
Flugin (Figma Bridge)
Browser extension, Figma layers to code, Webflow push, CLI/SDK/GitHub App, FLUGIN-DS-001 Rev D
PARTIAL
CH29
Iris (In-Meeting Agent)
Joins Meet and speaks, interruption handling, post-meeting artifacts, ArcFlow writes
LIVE
CH30
Field Units
Command/Steward/Portal/Relay variants, PFU hardware, ArcField for Ag Express
SPEC
CH31
Grid Packs and SDKs
Ten provisional capability packs, Brain SDK, manifest validator, pack marketplace
PARTIAL
Parts V - IX Factories, Offers, Sister Businesses, Backbone, Reference
CH32
Factories and Engines
Integration Fabric, CIE/Larder, GEO Factory, Bindery, Patent Factory, Studio-as-CMS, Gaming Line
PARTIAL
CH33
Offers Built on the Platform
Trades websites, GOV-001, government bids (4 live), Crewline, Ag Express, FinMo
PARTIAL
CH34
Sister Businesses and DBAs
ArcGrid, GreyTrace, Flugin, Castin, Flagin; portfolio entities; Team Resources
UNKNOWN
CH35
How the Grid Absorbs Outside Value
Assimilation doctrine, 90/10 rule, visual grounding, clean-room practice
UNKNOWN
CH36
The Engineering Backbone
Handoff registry, QA factory, coverage eval, autonomous build, arcproof
PARTIAL
CH37
End-to-End Journeys
Client onboarding, demo to engagement, render pipeline, memory lifecycle, build loop
SPEC
CH38
A Day in the Life, by Role
How each role (owner, account lead, designer, developer) moves through the Surface in a working day
SPEC
CH39
Naming History and Retired Names
Every renamed area, deprecated code name, and the canonical name that replaced it
LIVE
CH40
Epilogue - Where It Is Going
Brain licensing, microdatacenter scale, portfolio strategy, trades market, government, Ag Express
SPEC

Status ledger summary

The full ledger is in docs/guide/GRID-GUIDE-001/03-STATUS-LEDGER.md (210 rows). Rev A.3 last-known status is shown here. The Verified Status column is blank until the GUIDE.1 verification pass runs against the actual system.

~40
LIVE
~35
PARTIAL
~75
SPEC
~25
CONCEPT
~35
UNKNOWN

The UNKNOWN count is high by design. These are capabilities Charles named in conversation where the design record does not say what shipped. GUIDE.1 closes that gap by inspecting the running system.

Open decisions

20 questions for Charles (only he can answer) and 30+ gating ratification items across packages. Full list in docs/guide/GRID-GUIDE-001/06-OPEN-DECISIONS.md. Key items:

IDQuestionChapter
Q-01Gray Trace: which entity is its parent, what does it do, and how does it relate to the platform?34
Q-02Name the seven layers of ArcBrain.8
Q-03Swift's contractual role in Brain licensing: affiliate, reseller, or both?1, 8
Q-04Is Atlas a customer-facing brand, and what is its final name?1
Q-05Final name and boundary for Audience vs. Clients.18
Q-06Native Surface mobile app: now, later, or never?10
Q-10Should guests ever have Chat channels in Surface?13
Q-14ArcPet vs. Roar: one pet vertical or two?31
Q-17Code area: CI server budget and merge queue choice.22
Q-18Self-hosted workspace (mail, docs, meetings): pursue as a package or park?6

Assimilation plan (GUIDE phases)

The Assimilation Directive (01-ASSIMILATION-DIRECTIVE.md) defines the full procedure. Roadmap phases below follow it.

0
Ingest and register
Store chapter files in docs/guide/GRID-GUIDE-001/. Register GRID-GUIDE-001 Rev A.3 in the seeding registry with status draft and provenance authored-from-design-record. Add this page to the internal hub. (Complete with this PR.)
GUIDE.0 - complete
1
Verification pass
For every row in the Status Ledger (210 rows across all chapters): inspect the running Surface, the repo routes and components, the Grid services, and the deployment manifests. Fill Verified Status + Evidence columns. Document real route paths, not "observed in UI" alone.
GUIDE.1 - not started
2
Fill gaps and answer Charles's questions
Resolve every [GRID TO COMPLETE] marker in chapter text. Answer Q-01 through Q-20 where the system can answer them. Add any remaining questions to 06-OPEN-DECISIONS.md for Charles. Overwrite chapter text where the running system contradicts Rev A.3.
GUIDE.2 - blocked on GUIDE.1
3
Produce Rev B
Updated chapter files. For every LIVE or PARTIAL area: add How-to subsection (3-10 most common tasks against the real UI) and Roles subsection. Regenerate COMPLETE.md and docx. Write CHANGELOG-RevB.md. Registry record for GRID-GUIDE-001 Rev B with status draft pending Charles's ratification.
GUIDE.3 - blocked on GUIDE.2
4
Publish (human approval gate)
Charles reviews and ratifies Rev B. Publish to internal hub with verified status. Do not share externally without Charles's sign-off - this is an internal document, and external rendering requires the outward copy rule (Swift is the subject; ArcGrid is evidence of delivery capacity).
GUIDE.4 - blocked on GUIDE.3 + Charles approval

File index

All files live in docs/guide/GRID-GUIDE-001/ in the repo.

  • 00-README.md - Orientation, status vocabulary, standing conventions
  • 01-ASSIMILATION-DIRECTIVE.md - Full procedure for Rev B
  • 02-REVISION-PROTOCOL.md - How to produce and version later revisions
  • 03-STATUS-LEDGER.md - 210+ capability rows with last-known and verified status
  • 04-CHAPTER-MANIFEST.yaml - Machine-readable chapter index with source packages
  • 05-GLOSSARY.md - Every proper noun and package ID
  • 06-OPEN-DECISIONS.md - Consolidated ratification and decision queue
  • 07-build-docx.js - Script to regenerate the Word edition from COMPLETE.md
  • chapters/ch00-ch40.md - The 40 chapter files (canonical source)
  • diagrams/ - SVG sources and PNG renders (stack, ownership, surface-areas, lifecycle, memory)
  • GRID-GUIDE-001-RevA3-COMPLETE.md - All chapters concatenated for single-file ingestion
  • GRID-GUIDE-001-RevA3.docx - Human-readable Word edition
  • CHANGELOG-RevA1.md / RevA2.md / RevA3.md - What changed each revision