@hybridlabor-api/aos 4.4.2-beta.5 → 4.4.2-beta.7

package/CLAUDE.md

@@ -668,6 +668,58 @@ must not do.
 
 ## Headless timeouts
 
+A trivial headless `agy` prompt was measured at **605s** in 2026-09.
+`agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
+reports an empty body while the answer is still arriving. Pass `--timeout 15m`
+for anything non-trivial. A short timeout does not read as "slow", it reads as
+"broken".
+
+# AOS — Antigravity / Gemini
+
+**Read [AGENTS.md](AGENTS.md) first.** It holds every rule that applies to all
+harnesses: the non-negotiables, the release gate, Conventional Commits, the
+skill contract and category routing, the pipeline variants, and the delegation
+policy. Nothing from it is repeated here — a rule that lives in two files is a
+rule that will eventually disagree with itself.
+
+This file covers only what is specific to running AOS under Antigravity.
+
+## Nothing enforces the gate here — you are the enforcement
+
+`.claude/hooks/go-gate.mjs` is a Claude Code hook and does not run on this
+harness. Not one of the four release commands is mechanically blocked for you,
+and neither is anything else.
+
+So the full rule in AGENTS.md applies here in its entirety, not just its
+hook-enforced subset: when the user asks for a plan, review, audit or
+multi-step action, you are read-only until they answer with the literal **GO**
+— including file writes and `git commit`. On Claude Code a hook would catch the
+four worst cases if discipline failed. Here there is no backstop, which makes
+this the harness where the rule matters most, not least.
+
+## Model routing
+
+The tier names in `agy-delegate` map to models that go stale — the built-in
+`flash` still points at Gemini 3.7 while 3.8 ships. Re-check against
+`agy models` after every upgrade; the id carries both the version and the
+effort suffix.
+
+| Work | Model |
+|---|---|
+| Media, fast or mechanical coding, boilerplate | `Gemini 3.8 Flash (Medium)` |
+| Trivial one-liners | `Gemini 3.8 Flash (Low)` |
+| Review, architecture, hard reasoning | `Claude Sonnet 4.6 (Thinking)` |
+
+Set these once via `CLAUDE_PLUGIN_OPTION_TIER_{FLASH,FLASH_LO,PRO}` in
+`~/.zshenv` — **not** `~/.zshrc`, which non-interactive tool shells never
+source.
+
+Adversarial review is the case that most repays the stronger model: a Flash
+tier tends to agree with what it is shown, which is the one thing a reviewer
+must not do.
+
+## Headless timeouts
+
 A trivial headless `agy` prompt was measured at **605s** in 2026-09.
 `agy-delegate` defaults to `--print-timeout 5m`, so it aborts at 300s and
 reports an empty body while the answer is still arriving. Pass `--timeout 15m`

package/README.de.md

@@ -20,10 +20,10 @@
 [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
 [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![skills](https://img.shields.io/badge/skills-154%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
+[![skills](https://img.shields.io/badge/skills-183%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
 [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
 
-> **Supercharging von KI-Coding-Agenten mit 154 hochkuratierten Skills, 21 lokalen MCP Wrappern und tiefgreifenden Integrationen für die Creative-Technology-Branche.**
+> **Supercharging von KI-Coding-Agenten mit 183 hochkuratierten Skills, 19 lokalen MCP Wrappern und tiefgreifenden Integrationen für die Creative-Technology-Branche.**
 
 Willkommen im **BDB DEV Skills & MCP Configuration** Repository. Dieses Projekt dient als Rückgrat unseres Entwicklungs-Ecosystems für Creative & Full-Stack Development. Es erweitert KI-Agenten um hochspezialisierte Fähigkeiten, die speziell auf die Event- und Medientechnologie-Branche sowie auf allgemeine Software-Entwicklung zugeschnitten sind.
 
@@ -52,9 +52,11 @@ Der Installer verfügt jetzt über eine vollautomatische Universal Sync Engine.
 - **Tier 9 - Local Project Harness:** Anstatt global in `$HOME` zu installieren, können Entwickler den `.agents` Contract und die Hooks nun direkt in isolierte Projektordner injizieren.
 
 ### 🧩 Ecosystem-Integrationen (v4.0.0)
-Dieses Paket dient als Brücke zu zwei gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
-- **BDB OS Agent Workspace:** Die Orchestrierungsschicht für parallele KI-Agenten. Starten Sie mehrere isolierte Agenten-Sitzungen über Git-Worktrees mit Live-Terminalsteuerung, automatischen CI/CD-Feedbackschleifen und PR-Review-Routing.
+Dieses Paket dient als Brücke zu vier gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
+- **BDB AO — Agent Orchestrator:** Die Orchestrierungsschicht für parallele KI-Agenten. Starten Sie mehrere isolierte Agenten-Sitzungen über Git-Worktrees mit Live-Terminalsteuerung, automatischen CI/CD-Feedbackschleifen und PR-Review-Routing. Ships mit einem vorkompilierten Binary (macOS, Apple Silicon); andere Plattformen bauen aus Quellcode. Setzt die jetzt archivierte `bdb-os-agent-workspace` Vorversion außer Kraft — installieren Sie die alte nicht.
 - **BDB Creator Extension:** Die leistungsstarke Agentic Media Pipeline. Verleiht Agenten lokale ComfyUI MCP-Fähigkeiten (FLUX, SDXL), Image-to-3D-Generierung (TripoSR, TRELLIS) und automatisierte Videoproduktion über OpenMontage und Remotion.
+- **BDB Synapse:** 3D-Codebase-Visualisierung & Agent-Session-Replay. Renderiert Ihr Repository als interaktive Code-Stadt und spielt Agent-Sessions als Lichtspur auf, die anzeigt, welche Dateien gelesen, bearbeitet und wo Friktion auftrat.
+- **BDB Hardware & PCB:** Optionales Electrical-/PCB-Design-Modul. Zwei lokale MCP-Server (KiCad, OpenSCAD) mit 55 Tools, plus 5 Skills für Schaltplan-Capture, Layout/Routing und DFM-Freigabe. Installieren Sie eigenständig oder über den optionalen Modul-Picker des Installers; gekoppelt mit der Core-Persona `godmode-hardware-pcb`.
 
 
 ### 🔗 Empfohlene Companion-Plugins (Claude Code)
@@ -80,14 +82,14 @@ Keines dieser Plugins ist in diesem Paket enthalten — es handelt sich um unabh
 
 Dieses Repo liefert drei Dinge: eine kuratierte Skill-Bibliothek für Coding-Agenten, einen Installer, der diese (plus 21 lokale MCP Wrapper) in das von Ihnen genutzte Harness einbindet, und einen Dispatcher-Graphen, der sie als Multi-Agenten Build-Pipeline orchestriert. Siehe [AOS: Der Dispatcher-Graph](#-aos-der-dispatcher-graph) weiter unten für Details zur Funktionsweise der Pipeline selbst.
 
-## 🌟 ~154+ Optimierte Skills (Aktualisiert für v4.0.0)
+## 🌟 183 Optimierte Skills
 
-Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Nach intensiven Tests, Filterungen und Verfeinerungen haben wir sie zu einem hochkuratierten Set von **154+ Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v4.0.0**).
+Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Nach intensiven Tests, Filterungen und Verfeinerungen haben wir sie zu einem hochkuratierten Set von **183 Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v4.0.0**).
 
 Diese Skills sind präzise optimiert, damit Agenten keine Zeit mit redundanten Aufgaben verschwenden, sondern mit maximaler Autonomie, strengen Architekturvorgaben und robustem Kontextbewusstsein agieren.
 
-### 🛡️ Die 6 Godmodes (Apex Layer)
-Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste Ebene dieses Repositories sechs **Hochkuratierte Godmodes** durch. Diese fungieren als ultimative Wächter für Ihre Codebasis:
+### 🛡️ Die 7 Godmodes (Apex Layer)
+Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste Ebene dieses Repositories sieben **Hochkuratierte Godmodes** durch. Diese fungieren als ultimative Wächter für Ihre Codebasis:
 - **`godmode-engineering`**: Erzwingt Domain-Driven Design, strenge TypeScript-Prüfungen, Clean Architecture und systematisches Debugging.
 - **`godmode-ui-ux`**: Der Frontend-Goldstandard. Erzwingt BDB "Anti-Slop"-Prinzipien, Barrierefreiheit (Accessibility) und fluide Bewegungsdynamiken.
 - **`godmode-shipping`**: Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, Pre-Launch-Prüfungen und sichere Rollbacks.
@@ -580,14 +582,17 @@ tail -f ~/.openwiki/daemon.log
 
 ---
 
-## 🖥️ BDB OS Agent Workspace: Parallele Multi-Agenten-Orchestrierung
+## 🖥️ BDB AO — Agent Orchestrator: Parallele Multi-Agenten-Orchestrierung
 
-[![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
+[![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 
-**BDB OS Agent Workspace** ist der Desktop Meta-Harness und die Orchestrierungsschicht, entwickelt für parallele KI-Agenten. Es ermöglicht Entwicklern, mehrere isolierte Agenten-Sitzungen gleichzeitig über unabhängige Git-Worktrees hinweg zu starten, zu verwalten und zu koordinieren, inklusive Echtzeit-Terminal-Feedback-Schleifen und automatisiertem PR-Review-Routing.
+**BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) ist der Desktop Meta-Harness und die Orchestrierungsschicht, entwickelt für parallele KI-Agenten. Es ermöglicht Entwicklern, mehrere isolierte Agenten-Sitzungen gleichzeitig über unabhängige Git-Worktrees hinweg zu starten, zu verwalten und zu koordinieren, inklusive Echtzeit-Terminal-Feedback-Schleifen und automatisiertem PR-Review-Routing.
+
+> [!NOTE]
+> AO ersetzt den früheren **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). Dieses Repository ist archiviert, und sein letztes Release stammt von vor der Archivierung — es enthält einen bekannten Defekt in seiner CI/CD-Feedback-Schleife. Der AOS-Installer bietet ausschließlich AO an; das alte Repository nicht klonen.
 
 ```mermaid
 flowchart TD
@@ -620,8 +625,9 @@ flowchart TD
 </details>
 
 <details>
-<summary><strong>🔌 Unterstützte Harnesses & Direkter Repository-Link</strong></summary>
+<summary><strong>🔌 Plattform-Support, Unterstützte Harnesses & Direkter Repository-Link</strong></summary>
 
+- **Plattform-Support:** Liefert heute ein vorgebautes Binary — macOS, Apple Silicon (arm64). Windows- und Linux-Quellen liegen im Paket, sind aber nicht vorgebaut; auf diesen Plattformen aus dem Quellcode bauen (`go build`).
 - **Unterstützte Agenten-Harnesses:**
   - **Google Antigravity / AGY CLI**
   - **Claude Desktop & Claude Code**
@@ -629,10 +635,10 @@ flowchart TD
   - **Roo Code & Cline**
   - **ChatGPT Codex / Codex CLI**
   - **Aider & VS Code**
-- **Direktes Repository:** Greifen Sie auf den Workspace-Orchestrator unter [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace) zu.
+- **Direktes Repository:** Greifen Sie auf den Orchestrator unter [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator) zu.
 
 ```bash
-git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
+git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
 ```
 </details>
 

package/README.md

@@ -10,15 +10,17 @@
 [![GitHub stars](https://img.shields.io/github/stars/hybridlabor-api/aos?style=flat&color=gold)](https://github.com/hybridlabor-api/aos/stargazers)
 [![last commit](https://img.shields.io/github/last-commit/hybridlabor-api/aos.svg)](https://github.com/hybridlabor-api/aos/commits/main)
 
-[![skills](https://img.shields.io/badge/skills-169%20curated-brightgreen.svg)](docs/skills_table.md)
-[![MCPs](https://img.shields.io/badge/local%20MCPs-21-brightgreen.svg)](mcps/)
+[![skills](https://img.shields.io/badge/skills-183%20curated-brightgreen.svg)](docs/skills_table.md)
+[![MCPs](https://img.shields.io/badge/local%20MCPs-19-brightgreen.svg)](mcps/)
 [![harnesses](https://img.shields.io/badge/harnesses-9%20supported-blueviolet.svg)](#-installation)
 [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
 [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
 
-> **Supercharging AI coding agents with 169 hyper-curated skills, 21 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
+> **Supercharging AI coding agents with 183 hyper-curated skills, 21 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
 
-Welcome to **BDB Agent OS — AOS v4.0.0**: 169 curated skills, 21 local MCP wrappers, and a dispatcher graph that turns them into a real multi-agent build pipeline, not just a prompt library. Point it at a goal and it plans, builds, reviews, and ships through seven coordinated agent nodes — with a mechanically enforced gate before anything actually goes live.
+Welcome to **BDB Agent OS — AOS**: 183 curated skills, 19 local MCP wrappers, an optional Hardware & PCB design module, and a dispatcher graph that turns all of it into a real multi-agent build pipeline, not just a prompt library. Point it at a goal and it plans, builds, reviews, and ships through seven coordinated agent nodes — with a mechanically enforced gate before anything actually goes live.
+
+**Current release:** `v4.4.2` (beta channel) — see the NPM badge above for the exact published version.
 
 It is harness-neutral by design, not "optimized for one tool with others as an afterthought": the dispatcher graph runs on Claude Code's Dynamic Workflows, the same skills and MCP configuration install natively into **Google Antigravity, ChatGPT Codex / Codex CLI, Claude Desktop, Cursor, Aider, Roo Code, Cline, and Windsurf**, and the lightweight `/startcycle-graph-user` variant falls back to Claude Code's own subagents on any machine that has none of the above installed.
 
@@ -60,10 +62,11 @@ The installer features a fully automated Universal Sync engine. It scans your sy
 - **Local Project Harness:** Instead of installing globally into `$HOME`, drop the `.agents` contract, the gate hooks and the dispatcher workflow directly into a single project — `npx @hybridlabor-api/aos --project-harness`.
 
 ### 🧩 Ecosystem Integrations
-This package acts as the bridge to three major upstream capabilities:
-- **BDB OS Agent Workspace:** The Orchestration Layer for parallel AI agents. Start multiple isolated agent sessions via Git-Worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing.
+This package acts as the bridge to four major upstream capabilities:
+- **BDB AO — Agent Orchestrator:** The orchestration layer for parallel AI agents. Start multiple isolated agent sessions via Git worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing. Ships one prebuilt binary today (macOS, Apple Silicon); other platforms build from source. Supersedes the now-archived `bdb-os-agent-workspace` repository — do not install that one.
 - **BDB Creator Extension:** The heavy-lifting Agentic Media Pipeline. Gives agents local ComfyUI MCP capabilities (FLUX, SDXL), Image-to-3D generation (TripoSR, TRELLIS), and automated video production through OpenMontage and Remotion.
 - **BDB Synapse:** 3D Codebase Visualization & Agent Session Replay. Renders your repository as an interactive code city and replays agent sessions as light trails, showing which files were read, edited, and where friction occurred.
+- **BDB Hardware & PCB:** Optional electrical/PCB design module. Two local MCP servers (KiCad, OpenSCAD) exposing 55 tools, plus 5 skills covering schematic capture, layout/routing, and DFM sign-off. Install standalone or via this installer's optional-module picker; paired with the core `godmode-hardware-pcb` persona.
 
 ### 🔗 Recommended Companion Plugins (Claude Code)
 Neither of these ships inside this package — they are independent, community-maintained
@@ -102,17 +105,17 @@ below for how the pipeline itself works.
 
 ---
 
-## 🌟 169 Optimized Skills
+## 🌟 183 Optimized Skills
 
-We started with a massive pool of over 1,400 raw AI skills. After rigorous testing, filtering, and refinement, we've distilled them down to a hyper-curated set of **169 Optimized Skills** (featuring a native OpenWiki documentation engine, the **memB local semantic memory brain**, and **Universal Agent Harness synchronization**).
+We started with a massive pool of over 1,400 raw AI skills. After rigorous testing, filtering, and refinement, we've distilled them down to a hyper-curated set of **183 Optimized Skills** (featuring a native OpenWiki documentation engine, the **memB local semantic memory brain**, and **Universal Agent Harness synchronization**).
 
 These skills are precision-engineered to ensure agents waste no time on redundant tasks and instead operate with maximum agency, strict architectural constraints, and robust context awareness.
 
 ---
 
-### 🛡️ The 6 Godmodes (Apex Layer)
+### 🛡️ The 7 Godmodes (Apex Layer)
 
-Instead of letting agents wander through generic instructions, the top-tier of this repository enforces six **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other three cover 3D, media and event-tech work the same way.
+Instead of letting agents wander through generic instructions, the top-tier of this repository enforces seven **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other four cover 3D, media, event-tech, and hardware/PCB work the same way.
 
 | Godmode | Purpose |
 |---------|---------|
@@ -122,6 +125,7 @@ Instead of letting agents wander through generic instructions, the top-tier of t
 | **`godmode-eventtech`** | Architectural authority for real-time performance, signal flow, protocol routing, and hardware constraints in live show and event technology environments. |
 | **`godmode-3d-creation`** | MCP-First master orchestration for 3D generation, mesh reconstruction, and parametric CAD engineering. Interfaces with local 3D engines and MCP tools. |
 | **`godmode-media-creation`** | MCP-First master orchestration for all media creation pipelines (Video, Timeline Assembly, Beat Sync, Motion Design). Directly interfaces with local media engines and MCP tools. |
+| **`godmode-hardware-pcb`** | Architectural authority for electrical schematics, PCB layout, and OpenSCAD enclosure co-design. Enforces IPC-standard trace/impedance math and a headless KiCad ERC/DRC/DFM gate before anything ships to fabrication. Ships in core; the KiCad/OpenSCAD skills and MCP servers it drives live in the optional [**BDB Hardware & PCB**](#-bdb-hardware--pcb-electrical--enclosure-design-module) module. |
 
 ### 💻 Beyond Events: Full-Stack Software & Web Agents
 While heavily optimized for the creative tech industry, these skills are deeply rooted in core software engineering:
@@ -627,14 +631,17 @@ tail -f ~/.openwiki/daemon.log
 
 ---
 
-## 🖥️ BDB OS Agent Workspace: Parallel Multi-Agent Orchestration
+## 🖥️ BDB AO — Agent Orchestrator: Parallel Multi-Agent Orchestration
 
-[![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
+[![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 
-**BDB OS Agent Workspace** is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
+**BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
+
+> [!NOTE]
+> AO replaces the earlier **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). That repository is archived and its final release predates the archiving — it ships with a known defect in its CI/CD feedback loop. The AOS installer only ever offers AO; do not clone the old repo.
 
 ```mermaid
 flowchart TD
@@ -667,8 +674,9 @@ flowchart TD
 </details>
 
 <details>
-<summary><strong>🔌 Supported Harnesses & Direct Repository Link</strong></summary>
+<summary><strong>🔌 Platform Support, Supported Harnesses & Direct Repository Link</strong></summary>
 
+- **Platform Support:** Ships one prebuilt binary today — macOS, Apple Silicon (arm64). Windows and Linux sources are in the package but not prebuilt; build from source (`go build`) on those platforms.
 - **Supported Agent Harnesses:**
   - **Google Antigravity / AGY CLI**
   - **Claude Desktop & Claude Code**
@@ -676,10 +684,10 @@ flowchart TD
   - **Roo Code & Cline**
   - **ChatGPT Codex / Codex CLI**
   - **Aider & VS Code**
-- **Direct Repository:** Access the workspace orchestrator at [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace).
+- **Direct Repository:** Access the orchestrator at [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator).
 
 ```bash
-git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
+git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
 ```
 </details>
 
@@ -804,6 +812,64 @@ npx @hybridlabor-api/bdb-os-remote installer
 
 ---
 
+## ⚡ BDB Hardware & PCB: Electrical & Enclosure Design Module
+
+[![Repo](https://img.shields.io/badge/repo-bdb--hardware--pcb-blue.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
+[![tools](https://img.shields.io/badge/MCP%20tools-55-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
+[![KiCad](https://img.shields.io/badge/KiCad-9%20%26%2010-orange.svg)](https://www.kicad.org/)
+[![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+**BDB Hardware & PCB** (`@hybridlabor-api/bdb-hardware-pcb`) brings electrical
+schematic capture, PCB layout/routing, DFM sign-off, and parametric 3D
+enclosure design into the agent loop — governed by the core
+[`godmode-hardware-pcb`](#-the-7-godmodes-apex-layer) persona, which owns the
+IPC-standard trace/impedance math and the headless KiCad ERC/DRC/DFM gate no
+board is allowed to skip on its way to fabrication.
+
+```mermaid
+flowchart LR
+    A[Agent] -->|MCP| B[kicad-mcp-server]
+    A -->|MCP| C[openscad-mcp-server]
+    B --> D[Schematic Capture & ERC]
+    B --> E[PCB Layout & Routing]
+    B --> F[DRC / DFM / Gerber Sign-Off]
+    C --> G[Parametric Enclosure — OpenSCAD/BOSL2]
+    D & E & F & G --> H[Fabrication-Ready Output]
+```
+
+### Two MCP Servers, 55 Tools
+- **`kicad-mcp-server`** — 47 tools over stdio JSON-RPC for schematic capture, ERC, PCB layout, routing, DRC, and Gerber/BOM/CPL export. Targets **KiCad 9 & 10** via `kicad-cli`.
+- **`openscad-mcp-server`** — 8 tools for parametric 3D enclosure and mechanical co-design (OpenSCAD + BOSL2).
+
+### 5 Skills (`category: engineering-hardware`)
+
+| Skill | Description |
+|-------|-------------|
+| `schematic-datasheet-analysis` | Electrical rule auditing, datasheet grounding, pinout validation, power tree tracing, and negative-evidence analysis for KiCad schematics. |
+| `pcb-constraint-definition` | Translates high-level hardware requirements into formal engineering constraints, layer stackup, netclasses, and custom DRC rules for KiCad. |
+| `pcb-layout-routing-automation` | Floorplanning, placement rules, high-speed differential pair routing, return-path continuity, thermal via arrays, and keepout enforcement. |
+| `pcb-validation-dfm-signoff` | Automated DRC/ERC verification, SI/PI screening, fab-house DFM/DFA compliance, and production release sign-off. |
+| `code-first-hardware-design` | Programmatic schematic capture and circuit synthesis (SKiDL, text netlists, S-expressions) plus parametric 3D enclosure co-design. |
+
+### Install
+
+Same optional-module mechanism as `bdb-synapse` and
+`bdb-dev-creator-extension` — the main AOS installer downloads and runs it for
+you, or install it standalone on macOS, Linux, or Windows:
+
+```bash
+npx @hybridlabor-api/bdb-hardware-pcb
+```
+
+Supported harnesses: **Claude Code**, **OpenAI Codex**, and **Google
+Antigravity (Gemini)**. Verify a local install with:
+
+```bash
+./scripts/test_mcp_connection.sh --all
+```
+
+---
+
 ## 🧠 memB: Custom Semantic Brain
 
 BDB OS introduces a fully integrated local, offline-first semantic memory brain based on **memB**. It provides zero-compute context for SLMs and an AI-first flat-file vault architecture.

package/README.pt.md

@@ -20,12 +20,12 @@
 [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
 [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![skills](https://img.shields.io/badge/skills-154%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
+[![skills](https://img.shields.io/badge/skills-183%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
 [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
 
-> **Potencializando agentes de código de IA com 154 skills hipercuradas, 21 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
+> **Potencializando agentes de código de IA com 183 skills hipercuradas, 19 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
 
-Bem-vindo ao **BDB Agent OS — AOS v4.0.0**: 154 skills curadas, 21 wrappers MCP locais e um grafo dispatcher que os transforma em um verdadeiro pipeline de build multi-agente, não apenas uma biblioteca de prompts. Aponte para um objetivo e ele planeja, constrói, revisa e implementa através de sete nós de agentes coordenados — com um portão imposto mecanicamente antes que qualquer coisa vá ao ar.
+Bem-vindo ao **BDB Agent OS — AOS**: 183 skills curadas, 19 wrappers MCP locais e um grafo dispatcher que os transforma em um verdadeiro pipeline de build multi-agente, não apenas uma biblioteca de prompts. Aponte para um objetivo e ele planeja, constrói, revisa e implementa através de sete nós de agentes coordenados — com um portão imposto mecanicamente antes que qualquer coisa vá ao ar.
 
 É neutro em relação ao harness por design, não "otimizado para uma ferramenta com outras como reflexão tardia": o grafo dispatcher é executado no Dynamic Workflows do Claude Code, as mesmas skills e configuração MCP são instaladas nativamente no **Google Antigravity, ChatGPT Codex / Codex CLI, Claude Desktop, Cursor, Aider, Roo Code, Cline e Windsurf**, e a variante leve `/startcycle-graph-user` recorre aos próprios subagentes do Claude Code em qualquer máquina que não tenha nenhum dos acima instalados.
 
@@ -50,10 +50,11 @@ O instalador agora possui um motor Universal Sync totalmente automatizado. Ele v
 - **Local Project Harness:** Em vez de instalar globalmente em `$HOME`, os desenvolvedores podem injetar o contrato `.agents`, os hooks de portão e o workflow do dispatcher diretamente em um único projeto — `npx @hybridlabor-api/aos --project-harness`.
 
 ### 🧩 Integrações do Ecossistema
-Este pacote atua como a ponte para três grandes capacidades upstream:
-- **BDB OS Agent Workspace:** A camada de orquestração para agentes de IA paralelos. Inicie múltiplas sessões de agentes isoladas via Git-Worktrees com controle de terminal ao vivo, loops de feedback CI/CD automáticos e roteamento de revisão de PR.
+Este pacote atua como a ponte para quatro grandes capacidades upstream:
+- **BDB AO — Agent Orchestrator:** A camada de orquestração para agentes de IA paralelos. Inicie múltiplas sessões de agentes isoladas via Git-Worktrees com controle de terminal ao vivo, loops de feedback CI/CD automáticos e roteamento de revisão de PR. Envia um binário pré-compilado hoje (macOS, Apple Silicon); outras plataformas compilam a partir do código-fonte. Substitui o agora arquivado repositório `bdb-os-agent-workspace` — não instale o antigo.
 - **BDB Creator Extension:** O pipeline de mídia agêntica de alta capacidade. Fornece aos agentes capacidades MCP locais do ComfyUI (FLUX, SDXL), geração Image-to-3D (TripoSR, TRELLIS) e produção de vídeo automatizada através do OpenMontage e Remotion.
 - **BDB Synapse:** Visualização de Codebase 3D & Replay de Sessões de Agentes. Renderiza seu repositório como uma cidade de código interativa e repete as sessões de agentes como rastros de luz, mostrando quais arquivos foram lidos, editados e onde ocorreu atrito.
+- **BDB Hardware & PCB:** Módulo de design elétrico/PCB opcional. Dois servidores MCP locais (KiCad, OpenSCAD) expondo 55 ferramentas, mais 5 skills cobrindo captura de esquemas, layout/roteamento e aprovação DFM. Instale de forma isolada ou através do seletor de módulo opcional do instalador; acoplado com a persona central `godmode-hardware-pcb`.
 
 ### 🔗 Plugins Complementares Recomendados (Claude Code)
 Nenhum destes vem dentro deste pacote — são plugins do Claude Code independentes e mantidos pela comunidade que combinam naturalmente com o padrão de delegação `agy` que o [`/startcycle-graph-user`](#-aos-o-grafo-dispatcher) já usa. Instale-os separadamente se quiser o mesmo roteamento disponível fora de uma execução `/startcycle`.
@@ -85,14 +86,14 @@ que você use, e um grafo dispatcher que os orquestra como um pipeline de
 build multi-agente. Veja [AOS: O Grafo Dispatcher](#-aos-o-grafo-dispatcher)
 abaixo para entender como o próprio pipeline funciona.
 
-## 🌟 ~154+ Skills Otimizadas (Atualizado para v4.0.0)
+## 🌟 183 Skills Otimizadas
 
-Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após rigorosos testes, filtragem e refinamento, destilamo-las em um conjunto hipercurado de **154+ Skills Otimizadas** (apresentando um motor nativo de documentação OpenWiki, o **cérebro de memória semântica local memB** e agora a **sincronização Universal Agent Harness na v4.0.0**).
+Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após rigorosos testes, filtragem e refinamento, destilamo-las em um conjunto hipercurado de **183 Skills Otimizadas** (apresentando um motor nativo de documentação OpenWiki, o **cérebro de memória semântica local memB** e agora a **sincronização Universal Agent Harness na v4.0.0**).
 
 Essas skills são projetadas com precisão para garantir que os agentes não percam tempo com tarefas redundantes e, em vez disso, operem com máxima autonomia, restrições arquitetônicas rígidas e robusta consciência de contexto.
 
-### 🛡️ Os 6 Godmodes (Camada Apex)
-Em vez de deixar os agentes vagando por instruções genéricas, o nível superior deste repositório impõe seis **Godmodes Hipercurados**. Eles atuam como os guardiões definitivos para sua base de código:
+### 🛡️ Os 7 Godmodes (Camada Apex)
+Em vez de deixar os agentes vagando por instruções genéricas, o nível superior deste repositório impõe sete **Godmodes Hipercurados**. Eles atuam como os guardiões definitivos para sua base de código:
 - **`godmode-engineering`**: Impõe Domain-Driven Design, verificações rígidas de TypeScript, Clean Architecture e depuração sistemática.
 - **`godmode-ui-ux`**: O padrão de ouro do frontend. Impõe princípios "Anti-Slop" da BDB, acessibilidade e dinâmicas de movimento fluidas.
 - **`godmode-shipping`**: O guardião final para lançamentos em produção. Impõe Spec-Driven Development, verificações pré-lançamento e rollbacks seguros.
@@ -586,14 +587,17 @@ npx @hybridlabor-api/bdb-os-remote installer
 
 ---
 
-## 🖥️ BDB OS Agent Workspace: Orquestração Multi-Agente Paralela
+## 🖥️ BDB AO — Agent Orchestrator: Orquestração Multi-Agente Paralela
 
-[![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
-[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
+[![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
+[![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 
-**BDB OS Agent Workspace** é o Meta-Harness de Desktop e a camada de orquestração projetada para agentes de IA paralelos. Ele permite que desenvolvedores criem, gerenciem e coordenem múltiplas sessões de agentes isoladas simultaneamente em Git Worktrees independentes, com loops de feedback de terminal em tempo real e roteamento automatizado de revisão de PR.
+**BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) é o Meta-Harness de Desktop e a camada de orquestração projetada para agentes de IA paralelos. Ele permite que desenvolvedores criem, gerenciem e coordenem múltiplas sessões de agentes isoladas simultaneamente em Git Worktrees independentes, com loops de feedback de terminal em tempo real e roteamento automatizado de revisão de PR.
+
+> [!NOTE]
+> O AO substitui o antigo **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). Esse repositório está arquivado e seu último release é anterior ao arquivamento — ele contém um defeito conhecido em seu loop de feedback de CI/CD. O instalador do AOS só oferece o AO; não clone o repositório antigo.
 
 ```mermaid
 flowchart TD
@@ -626,8 +630,9 @@ flowchart TD
 </details>
 
 <details>
-<summary><strong>🔌 Harnesses Suportados & Link Direto do Repositório</strong></summary>
+<summary><strong>🔌 Suporte de Plataforma, Harnesses Suportados & Link Direto do Repositório</strong></summary>
 
+- **Suporte de Plataforma:** Disponibiliza hoje um binário pré-compilado — macOS, Apple Silicon (arm64). As fontes para Windows e Linux estão no pacote, mas não são pré-compiladas; compile a partir do código-fonte (`go build`) nessas plataformas.
 - **Harnesses de Agentes Suportados:**
   - **Google Antigravity / AGY CLI**
   - **Claude Desktop & Claude Code**
@@ -635,10 +640,10 @@ flowchart TD
   - **Roo Code & Cline**
   - **ChatGPT Codex / Codex CLI**
   - **Aider & VS Code**
-- **Repositório Direto:** Acesse o orquestrador de workspace em [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace).
+- **Repositório Direto:** Acesse o orquestrador em [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator).
 
 ```bash
-git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
+git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
 ```
 </details>
 

package/docs/backups/hub-overview-20260915.html

@@ -0,0 +1,200 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>BDB Fleet Hub • Identity Portal Selection</title>
+  <link rel="icon" type="image/svg+xml" href="/brand/bdb-favicon-white.svg">
+  <link rel="alternate icon" href="/favicon.svg">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;600;700&family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      background-color: #07080c;
+      color: #f1f5f9;
+      font-family: 'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, sans-serif;
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      padding: 24px;
+      position: relative;
+      overflow-x: hidden;
+    }
+    body::before {
+      content: "";
+      position: absolute;
+      top: -20%;
+      left: 50%;
+      transform: translateX(-50%);
+      width: 600px;
+      height: 400px;
+      background: radial-gradient(circle, rgba(155, 48, 196, 0.12) 0%, rgba(14, 165, 233, 0.05) 50%, transparent 70%);
+      filter: blur(80px);
+      pointer-events: none;
+    }
+    .container {
+      width: 100%;
+      max-width: 480px;
+      background: rgba(17, 19, 26, 0.85);
+      border: 1px solid rgba(255, 255, 255, 0.1);
+      border-radius: 24px;
+      padding: 40px 36px;
+      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.7);
+      backdrop-filter: blur(16px);
+      position: relative;
+      z-index: 1;
+    }
+    .badge {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      padding: 4px 12px;
+      border-radius: 9999px;
+      background: rgba(255, 255, 255, 0.05);
+      border: 1px solid rgba(255, 255, 255, 0.1);
+      font-size: 11px;
+      font-family: 'JetBrains Mono', monospace;
+      color: #38bdf8;
+      margin-bottom: 20px;
+    }
+    .pulse {
+      width: 6px;
+      height: 6px;
+      border-radius: 50%;
+      background: #38bdf8;
+      box-shadow: 0 0 8px #38bdf8;
+    }
+    h1 {
+      font-size: 24px;
+      font-weight: 800;
+      letter-spacing: -0.02em;
+      margin-bottom: 8px;
+      color: #ffffff;
+    }
+    p.desc {
+      font-size: 13px;
+      color: #94a3b8;
+      line-height: 1.5;
+      margin-bottom: 32px;
+    }
+    .choice-group {
+      display: flex;
+      flex-direction: column;
+      gap: 14px;
+    }
+    .choice-btn {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 16px 20px;
+      border-radius: 16px;
+      text-decoration: none;
+      transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
+      cursor: pointer;
+      position: relative;
+    }
+    .choice-aws {
+      background: rgba(155, 48, 196, 0.12);
+      border: 1px solid rgba(155, 48, 196, 0.35);
+    }
+    .choice-aws:hover {
+      background: rgba(155, 48, 196, 0.22);
+      border-color: rgba(155, 48, 196, 0.6);
+      transform: translateY(-2px);
+      box-shadow: 0 10px 25px -5px rgba(155, 48, 196, 0.3);
+    }
+    .choice-gcp {
+      background: rgba(14, 165, 233, 0.08);
+      border: 1px solid rgba(14, 165, 233, 0.3);
+    }
+    .choice-gcp:hover {
+      background: rgba(14, 165, 233, 0.18);
+      border-color: rgba(14, 165, 233, 0.55);
+      transform: translateY(-2px);
+      box-shadow: 0 10px 25px -5px rgba(14, 165, 233, 0.25);
+    }
+    .choice-info {
+      text-align: left;
+    }
+    .choice-title {
+      font-size: 14px;
+      font-weight: 700;
+      color: #ffffff;
+      margin-bottom: 3px;
+    }
+    .choice-sub {
+      font-size: 11px;
+      font-family: 'JetBrains Mono', monospace;
+      color: #94a3b8;
+    }
+    .arrow {
+      font-size: 18px;
+      color: #ffffff;
+      opacity: 0.6;
+      transition: transform 0.2s ease, opacity 0.2s ease;
+    }
+    .choice-btn:hover .arrow {
+      transform: translateX(3px);
+      opacity: 1;
+    }
+    .footer {
+      margin-top: 32px;
+      padding-top: 20px;
+      border-top: 1px solid rgba(255, 255, 255, 0.06);
+      font-size: 11px;
+      color: #64748b;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+    }
+    .footer a {
+      color: #94a3b8;
+      text-decoration: none;
+      transition: color 0.15s ease;
+    }
+    .footer a:hover {
+      color: #38bdf8;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="badge">
+      <span class="pulse"></span>
+      <span>BDB Zero-Trust Perimeter</span>
+    </div>
+
+    <h1>Select Identity Realm</h1>
+    <p class="desc">
+      The Fleet Operations Hub is protected by central single-sign-on. Choose your assigned identity provider to continue:
+    </p>
+
+    <div class="choice-group">
+      <a href="https://auth.awsbdb.rcentry.pro/?rd=https://hub.awsbdb.rcentry.pro/" class="choice-btn choice-aws">
+        <div class="choice-info">
+          <div class="choice-title">BDB Dev Intern (AWS)</div>
+          <div class="choice-sub">auth.awsbdb.rcentry.pro</div>
+        </div>
+        <div class="arrow">&rarr;</div>
+      </a>
+
+      <a href="https://auth.rcentry.pro/?rd=https://hub.awsbdb.rcentry.pro/" class="choice-btn choice-gcp">
+        <div class="choice-info">
+          <div class="choice-title">rcentry.cloud (GCP / Netcup)</div>
+          <div class="choice-sub">auth.rcentry.pro</div>
+        </div>
+        <div class="arrow">&rarr;</div>
+      </a>
+    </div>
+
+    <div class="footer">
+      <span>Step-CA SSH & TLS Enabled</span>
+      <a href="https://status.awsbdb.rcentry.pro" target="_blank">Status NOC &rarr;</a>
+    </div>
+  </div>
+</body>
+</html>