Core Platform
| Term | Definition |
|---|---|
| Adom | The platform and company. Never say "Gallia" or "Hydrogen" to users — those are internal codenames. |
| Adom App Workspace | The full web app: toolbar, panels, VS Code, profile, workcell picker. "Workspace" emphasizes the persistent panel layout stored in Docker container layout files. |
| Adom Viewer (AV) | The AI GUI panel inside the Adom App. This is where Views live. A single AV server (port 8770) can serve multiple independent AV panels — each is an AV instance with its own tabs, state, and content. |
| AV Instance | A single AV panel running inside a Web View panel. Each instance has a unique ID via URL param (?instance=<id>). Instances are independent — own tabs, nav history, dropdown state. Default instance (no param) is the general-purpose AV. |
| Panel | A rectangular area in the Adom App layout — like a window pane. Each panel has a tab with a name and icon. Can be split, resized, moved, closed. Types: VS Code, Web View, 3D Viewer, cameras, sensors, etc. AV runs inside Web View panels. |
| AV2 deprecated | Was a second AV on separate ports (8790/8791/8792). Replaced by AV instances — just open another Web View panel with ?instance=<id>. |
Views
| Term | Definition |
|---|---|
| View | A mini-app/tab inside AV. Each View has a View ID. Views are like apps on a desktop OS — each has its own icon, author, and real interactive content. |
| View ID | The short identifier for a View (e.g., SymView, Fp3dView, DkSearch). Used in code and the dropdown. |
| real-view keyword | Enforcement rule: always use the ACTUAL running view/app, never a fake mockup, placeholder, or approximation. Applies everywhere — dropdown landing pages, wiki submissions, demos, screenshots. If you're about to create HTML that looks like a view but isn't the real app, STOP. Use the real app with sample data instead. |
| fake-view BANNED | Any static SVG/HTML/screenshot that approximates a real view but doesn't run the actual app code. Examples: hand-drawn SVG of a symbol, placeholder with "Ask Claude to..." text, generated mockup that looks similar. |
View IDs Reference
| View ID | Name | Description |
|---|---|---|
| SymView | Symbol Creator | Interactive KiCad schematic symbol viewer with hover tooltips |
| FpView | Footprint Creator | 2D KiCad footprint viewer |
| Fp3dView | Footprint 3D | 3D Babylon.js pad geometry viewer (from fp-to-3d.js) |
| 3dView | 3D Component | STEP/GLB 3D model viewer with pad overlays and camera tours |
| Basic3dView | Basic 3D | Minimal GLB viewer — renders exactly as-is, no fixups |
| LibView | Library Review | Three-pane view: symbol + footprint + 3D side by side |
| SchView | Schematic Creator | Interactive schematic visualization with net highlighting |
| BoardView | Board Creator | Interactive board layout (2D SVG or 3D GLB) |
| DkSearch | DigiKey Search | Component search against DigiKey API |
| MsrSearch | Mouser Search | Component search against Mouser API |
| JlcSearch | JLCPCB Search | Component search against JLCPCB catalog |
| DeskConduit | Desktop Conduit | Bridge to user's local desktop (KiCad, Fusion 360, file transfer) |
| ContConduit | Container Conduit | Manage satellite containers (shell, files, monitoring) |
| GChat | Google Chat | Send/receive Google Chat messages as Kel |
| InstrView | Instrument Viewer | Live oscilloscope/DAQ waveform display |
| InstaPCB | InstaPCB | PCB fabrication quotes and DFM checks |
| MovieMaker | Movie Maker | Record narrated video walkthroughs |
| SkillsMap | Skills Map | Visual map of all available skills |
| Definitions | Definitions | This glossary — canonical Adom terminology |
Creators and Services
| Term | Definition |
|---|---|
| Creator | A service or skill that generates artifacts (symbols, footprints, 3D models, schematics, boards). |
| symbol-creator | Service at port 8781 that generates .kicad_sym files, metadata, SVG, branded viewer HTML. |
| footprint-creator | Skill that generates .kicad_mod files and viewer HTML. |
| fp-to-3d.js | CLI script that generates Babylon.js 3D pad viewer HTML from .kicad_mod files. |
| 3dcomponent-creator | Generates STEP/GLB 3D component models. |
| library-creator | Creates all three artifacts (symbol + footprint + 3D) and shows them in LibView. |
Infrastructure
| Term | Definition |
|---|---|
| Skill | A Markdown document (SKILL.md) that teaches Claude Code how to perform a specialized task. Lives in gallia repo, deployed to ~/.claude/skills/. |
| Conduit | WebSocket bridge between containers or between container and desktop. Two types: Desktop Conduit (DeskConduit) and Container Conduit (ContConduit). |
| MCP | Model Context Protocol — the tool interface that connects Claude to services (viewer, DigiKey, Mouser, etc.). |
| Sample data | Pre-generated real view HTML files in viewer/samples/ used for dropdown landing pages. Ensures real-view compliance when no user data is available. |
3D Coordinate System
| Term | Definition |
|---|---|
| Z-up | Adom 3D convention: Z is always up. Ground plane is XY at z=0. Babylon.js scenes use zUp: true. |
| KiCad Y flip | KiCad Y points down; negate Y when converting to Adom 3D coordinates. |
| GLB 1000x scale | glTF uses meters, Adom uses mm. GLB models are scaled 1000x. Overlay meshes need positions multiplied by 1000. |
Internal Codenames never use with users
| Codename | Real Name |
|---|---|
| Gallia | Adom (the platform), also the repo name adom-inc/gallia |
| Hydrogen | Adom App / Workspace |
| GV | Adom Viewer (AV) |