@hybridlabor-api/aos 4.11.0 → 4.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md CHANGED
@@ -1,659 +1,347 @@
1
1
  ![AOS — BDB Agent OS](assets/header-v4.jpg)
2
2
 
3
- 🌐 **Sprache / Language / Idioma**: [ 🇬🇧 English ](README.md) | **Deutsch** | [ 🇵🇹 Português ](README.pt.md)
3
+ 🌐 **Language / Sprache / Idioma**: [ 🇬🇧 English ](README.md) | **Deutsch** | [ 🇵🇹 Português ](README.pt.md)
4
4
 
5
- ---
6
-
7
- ```text
8
- █████▄ ████▄ █████▄ ▄████▄ ▄████ ██████ ███ ██ ██████ ▄████▄ ▄█████
9
- ██▄▄██ ██ ██ ██▄▄██ ██▄▄██ ██ ▄▄▄ ██▄▄ ██ ▀▄██ ██ ██ ██ ▀▀▀▄▄▄
10
- ██▄▄█▀ ████▀ ██▄▄█▀ ██ ██ ▀███▀ ██▄▄▄▄ ██ ██ ██ ▀████▀ █████▀
11
-
12
- ──────────────────────────── N O D E F O R G E ─────────────────────────────
13
-
14
- BDB AGENT OS · CORE KERNEL · AOS - v4.0.0
15
- ```
5
+ # AOS — BDB Agent OS
16
6
 
17
- # 🚀 AOS — BDB Agent OS · Optimiertes Creative & Full-Stack Skills Pack
18
-
19
- [![CI](https://github.com/hybridlabor-api/aos/actions/workflows/ci.yml/badge.svg)](https://github.com/hybridlabor-api/aos/actions)
20
7
  [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
21
- [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
8
+ [![NPM Downloads](https://img.shields.io/npm/dw/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
9
+ [![GitHub stars](https://img.shields.io/github/stars/hybridlabor-api/aos?style=flat&color=gold)](https://github.com/hybridlabor-api/aos/stargazers)
10
+ [![last commit](https://img.shields.io/github/last-commit/hybridlabor-api/aos.svg)](https://github.com/hybridlabor-api/aos/commits/main)
11
+ [![CI](https://github.com/hybridlabor-api/aos/actions/workflows/ci.yml/badge.svg)](https://github.com/hybridlabor-api/aos/actions)
22
12
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
23
- [![skills](https://img.shields.io/badge/skills-184%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
13
+ [![node](https://img.shields.io/badge/node-%3E%3D20-blue.svg)](package.json)
14
+ [![skills](https://img.shields.io/badge/skills-213%20curated-brightgreen.svg)](#skills)
15
+ [![MCPs](https://img.shields.io/badge/local%20MCPs-21-brightgreen.svg)](#mcp-server)
16
+ [![harnesses](https://img.shields.io/badge/harnesses-9%20supported-blueviolet.svg)](#unterstützte-harnesses)
24
17
  [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
25
18
 
26
- > **Supercharging von KI-Coding-Agenten mit 184 hochkuratierten Skills, 19 lokalen MCP Wrappern und tiefgreifenden Integrationen für die Creative-Technology-Branche.**
19
+ AOS installiert eine kuratierte Skill-Bibliothek, ein Subagent-Verzeichnis, Gate-Hooks und eine ausführbare Multi-Agent-Build-Pipeline in jeden auf deinem Rechner installierten Coding-Agent-Harness.
20
+
21
+ ```bash
22
+ npx -y @hybridlabor-api/aos@latest
23
+ ```
27
24
 
28
- 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.
25
+ Entwickelt für Nutzer, die bereits **Claude Code, Google Antigravity, Codex CLI, OpenCode, Cursor, Windsurf, Roo Code / Cline oder Aider** verwenden und möchten, dass alle gleich funktionieren.
29
26
 
30
- Obwohl für **Google Antigravity** optimiert, ist dieses Skill-Paket und die MCP-Konfiguration **100% universell** und funktioniert nahtlos mit allen modernen KI-Agenten und Entwickler-Schnittstellen, einschließlich **ChatGPT Codex / Codex CLI, Claude Desktop, Claude Code, Cursor, Aider, Roo Code, Cline und Windsurf**.
27
+ Nach der Installation hast du:
31
28
 
32
- > 🎙 **Audio Deep Dive: "Give AI Agents Control of Creative Software"**
33
- > <video src="assets/Give_AI_Agents_Control_of_Creative_Software.mp4" controls></video>
29
+ - **<!-- count:skills -->213<!-- /count --> Skills** in sechs Kategorien, von jedem Harness als `<name>/SKILL.md` auffindbar.
30
+ - **<!-- count:agents -->13<!-- /count --> Subagents** (Architect, TechLead, Reviewer, die Godmodes, Security- und Silent-Failure-Reviewer) als natives Agenten-Format jedes Harness kompiliert.
31
+ - **<!-- count:mcps -->21<!-- /count --> MCP-Server** für Creative Software, Betriebssystemsteuerung, Memory und Harness-übergreifende Delegation.
32
+ - **Drei Pipelines** — `/startcycle`, `/startcycle-graph`, `/startcycle-graph-user` — und ein **GO-Gate**, das `git push`, `npm publish`, `npm version` und rekursive `rm` mechanisch blockiert.
33
+ - **Tools:** Plan Canvas, agenttrail, archify, der AOS Store, das Launchpad Dashboard und `aos doctor`.
34
34
 
35
35
  ---
36
36
 
37
- ![BDB v3 Core Tools Overview](assets/bdb_v3_4_0_core_tools_overview_sketch.jpg)
37
+ ## Der Dispatcher-Graph
38
38
 
39
- ### 🔨 Was sich in v4.0.0 "AOS" ändert
39
+ Der Graph ist Harness-neutral und läuft auf Claude Codes Dynamic Workflows, Antigravitys paralleler Ausführung und jedem kompatiblen Agent Harness.
40
40
 
41
- Dieses Release wandelt die Multi-Agenten-Pipeline von einer Textbeschreibung in eine ausführbare State Machine um und härtet den Installer darum herum.
41
+ ```mermaid
42
+ flowchart LR
43
+ U(["👤 User"])
44
+ A["<b>Architect</b><br/><span>System Plan</span>"]
45
+ T["<b>TechLead</b><br/><span>Capability Map</span>"]
46
+ UX["<b>UI_UX</b><br/><span>Frontend</span>"]
47
+ EN["<b>Engineering</b><br/><span>Backend</span>"]
48
+ ME["<b>Media_EventTech</b><br/><span>Creative</span>"]
49
+ R["<b>Reviewer</b><br/><span>QA</span>"]
50
+ S["<b>Shipping</b><br/><span>Gate</span>"]
42
51
 
43
- - **Ein Dispatcher-Graph, der tatsächlich läuft.** Sieben Knoten, explizite Kanten-Prädikate, eine Reviewer-Reparaturschleife mit "No-Progress"-Schutz und eine automatische Eskalation an einen Menschen, wenn die Schleife keine Fortschritte mehr macht. [Details unten](#-aos-der-dispatcher-graph).
44
- - **Drei Pipeline-Varianten** (`/startcycle`, `/startcycle-graph`, `/startcycle-graph-user`), damit die Maschinerie zur Aufgabe passt, anstatt vollen Aufwand für eine Zwei-Dateien-Änderung zu erzwingen.
45
- - **Ein mechanisch erzwungenes GO-Gate.** `git push`, `npm publish`, `npm version` und rekursives `rm` werden durch einen `PreToolUse` Hook blockiert, es sei denn, Ihre unmittelbar vorhergehende Nachricht ist buchstäblich das Wort **GO** — eine Durchsetzung, die auch Änderungen im Berechtigungsmodus übersteht, da es sich um einen Hook handelt und nicht um eine Regel, die ein Agent befolgen soll.
46
- - **Verifizierter Daemon-Start.** Der Installer meldet "service started" nicht mehr auf gut Glück; er verbindet sich mit dem Port und warnt Sie, falls der Daemon nie gestartet wurde. Gleiches gilt für die Ecosystem-Status-Tabelle, die nun Versionen mit echter Semver-Präzedenz über jeden Dist-Tag hinweg vergleicht, anstatt nur auf String-Ungleichheit gegen `latest` zu prüfen.
47
- - **Getrennte MCP-Speicher pro Harness.** Claude Desktop und Claude Code lesen unterschiedliche Dateien; die Installation für das eine überspringt das andere nicht mehr stillschweigend. Vorhandene Server in beiden Dateien werden zusammengeführt, nicht überschrieben.
48
- - **Skriptbare, nicht-interaktive Installationen.** `--platforms=<n[,n]>` wählt Ziele ohne das Menü aus, sodass eine Maschine, auf der nur Claude Code läuft, über CI provisioniert werden kann, ohne eine Antigravity-First-Vorgabe zu erben.
52
+ U --> A --> T
53
+ T --> UX & EN & ME
54
+ UX & EN & ME --> R
55
+ R --> S
49
56
 
50
- ### 🪐 Universal Agent Harness (v4.0.0)
51
- Der Installer verfügt jetzt über eine vollautomatische Universal Sync Engine. Er scannt Ihr System nach **Claude Desktop, Cursor, Windsurf, Aider, Roo/Cline** und injiziert die kuratierte MCP-Konfiguration sowie die Godmode-Regeln gleichzeitig in alle Umgebungen.
52
- - **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.
57
+ T -.->|reject| A
58
+ R -.->|findings| UX
59
+ S -.->|gate fail| EN
60
+ R -.->|escalate| U
61
+ ```
53
62
 
54
- ### 🧩 Ecosystem-Integrationen (v4.0.0)
55
- Dieses Paket dient als Brücke zu vier gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
56
- - **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.
57
- - **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.
58
- - **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.
59
- - **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`.
63
+ ---
60
64
 
65
+ ## Installation
61
66
 
62
- ### 🔗 Empfohlene Companion-Plugins (Claude Code)
63
- Keines dieser Plugins ist in diesem Paket enthalten — es handelt sich um unabhängige, von der Community gepflegte Claude Code-Plugins, die sich natürlich in das `agy`-Delegationsmuster einfügen, das [`/startcycle-graph-user`](#-aos-der-dispatcher-graph) bereits verwendet. Installieren Sie diese separat, wenn Sie dasselbe Routing außerhalb eines `/startcycle`-Laufs nutzen möchten.
67
+ Anforderungen: Node.js >= 20. macOS, Linux und Windows (PowerShell).
64
68
 
65
- - **[antigravity-for-claude-code](https://github.com/yuting0624/antigravity-for-claude-code)**
66
- — führt die Antigravity CLI (`agy`, Gemini) als kooperierenden Subagenten aus, mit intelligentem Modell-Routing über den gesamten SDLC hinweg.
67
- ```bash
68
- claude plugin marketplace add yuting0624/antigravity-for-claude-code
69
- claude plugin install antigravity@antigravity-for-claude-code
70
- ```
71
- - **[opencode-plugin-cc](https://github.com/tasict/opencode-plugin-cc)** — fügt
72
- `/opencode:review` / `/opencode:adversarial-review` Slash-Befehle hinzu, womit Claude Code einen asynchronen Job an OpenCode delegieren kann und ein Review-Gate einrichtet, das den Fortschritt blockiert, bis OpenCode einen sauberen Review zurückmeldet.
73
- ```bash
74
- claude plugin marketplace add https://github.com/tasict/opencode-plugin-cc.git
75
- claude plugin install opencode@tasict-opencode-plugin-cc
76
- ```
69
+ ```bash
70
+ npx -y @hybridlabor-api/aos@latest
71
+ ```
77
72
 
78
- > [!CAUTION]
79
- > Wenn Sie auch ein älteres `antigravity-plugin-cc` Marketplace-Plugin installiert haben, deaktivieren Sie dieses und leeren Sie zuerst den Plugin-Cache — zwei gleichzeitig aktive `agy`-Routing-Plugins verursachen einen Doppel-Aktivierungs-Konflikt, bei dem keines sauber initialisiert wird.
73
+ **Erste Ausführung.** Das Installationsprogramm erkennt, welche Harnesses vorhanden sind, fragt, welche Ziele und welche Tier (Pro MEDIA oder Basic) gewünscht sind, kopiert die Skills in das Skill-Verzeichnis jedes Harness, kompiliert die Subagents, verbindet die Hooks, fügt die MCP-Konfiguration in die eigene Konfigurationsdatei jedes Harness ein (vorhandene Einträge bleiben erhalten) und bietet die unten aufgeführten optionalen Module an.
80
74
 
81
- ## Übersicht
75
+ **Bei jeder späteren Ausführung** öffnet sich stattdessen ein Menü:
82
76
 
83
- Dieses Repo liefert drei Dinge: eine kuratierte Skill-Bibliothek für Coding-Agenten, einen Installer, der diese (plus 19 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.
77
+ | Menüpunkt | Was es tut |
78
+ |---|---|
79
+ | Quick Update | Aktualisiert Skills, Templates, Hooks und installierte Module auf die gerade ausgeführte Version |
80
+ | Run System Checkup / Doctor | Führt `aos doctor` aus: Abhängigkeiten, Dateiplatzierung, Daemons, Hooks |
81
+ | Drop Local Project Harness | Kopiert den Dispatcher-Vertrag ins aktuelle Verzeichnis (siehe unten) |
82
+ | Reconfigure System | Ändere Ziele, Tier oder Optionen |
83
+ | Uninstall AOS | Entfernt, was das Installationsprogramm platziert hat; deine Daten bleiben |
84
84
 
85
- ## 🌟 184 Optimierte Skills
85
+ ### Nicht-interaktiv
86
86
 
87
- 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 **184 Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v4.0.0**).
87
+ ```bash
88
+ npx -y @hybridlabor-api/aos@latest -y --platforms=2 # Claude only, all defaults
89
+ npx -y @hybridlabor-api/aos@latest -y --platforms=1,5 --mcps=none
90
+ npx -y @hybridlabor-api/aos@latest --dry-run # print what would change
91
+ ```
88
92
 
89
- Diese Skills sind präzise optimiert, damit Agenten keine Zeit mit redundanten Aufgaben verschwenden, sondern mit maximaler Autonomie, strengen Architekturvorgaben und robustem Kontextbewusstsein agieren.
93
+ `--platforms=` Werte: `0` universal (alle erkannt), `1` Antigravity, `2` Claude Desktop / Claude Code, `3` Cursor, `5` Codex CLI, `6` Windsurf, `7` Roo Code / Cline, `8` Aider, `10` AOS CLI. `4` (benutzerdefinierte Pfade) benötigt das interaktive Menü. `--mcps=<name,name>|all|none` wählt die MCP-Teilmenge. `--verbose` und `--no-intro` tun, was sie sagen.
90
94
 
91
- ### 🛡️ Die 7 Godmodes (Apex Layer)
92
- 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:
93
- - **`godmode-engineering`**: Erzwingt Domain-Driven Design, strenge TypeScript-Prüfungen, Clean Architecture und systematisches Debugging.
94
- - **`godmode-ui-ux`**: Der Frontend-Goldstandard. Erzwingt BDB "Anti-Slop"-Prinzipien, Barrierefreiheit (Accessibility) und fluide Bewegungsdynamiken.
95
- - **`godmode-shipping`**: Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, Pre-Launch-Prüfungen und sichere Rollbacks.
96
- - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 19 Creative-Tech MCP Wrappern steuert.
97
- - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 19 Creative-Tech MCP Wrappern steuert.
98
- - **`godmode-3d-creation`**: Steuert die Agentic-3D-Pipeline (TripoSR, TRELLIS) für generative Modelle und CAD-Strukturen.
99
- - **`godmode-media-creation`**: Orchestriert automatisierte Videoproduktion, Storytelling und ComfyUI-Generierungsschleifen.
95
+ ### Lokales Projekt-Harness
100
96
 
101
- ### 💻 Jenseits von Events: Full-Stack Software & Web Agenten
102
- Obwohl stark für die Kreativtechnologie-Branche optimiert, sind diese Skills tief in der Kern-Softwareentwicklung verwurzelt:
103
- - **Autonome Web-Operationen**: Vollständige Suite von Firecrawl-basierten spezialisierten Agenten für strukturierte Datenextraktion, automatisierte Web-Interaktion und komplexe Scraping-Operationen.
104
- - **Full-Stack Entwicklung**: Erstellen von Next.js App Router Boilerplates, Aufbau skalierbarer Node.js Microservices und Gestaltung interaktiver Frontends.
105
- - **App-Entwicklung**: Datenbankarchitektur mit Prisma/Drizzle, Design von REST/GraphQL-APIs und Erstellung von Standard-Web- und Mobilanwendungen von Grund auf.
106
- - **Design & Qualitätssicherung**: Auditierung von UI/UX-Mustern (unter Verwendung von `ui-ux-pro-max`), Durchsetzung von Clean-Code-Prinzipien und Einrichten strenger CI/CD-Pipelines.
97
+ Statt in `$HOME` zu installieren, platziere nur den Dispatcher-Vertrag (`.agents/`, die Gate-Hooks, die Agent-Definitionen, den `/startcycle-graph` Workflow, das OpenCode Plugin) in ein Repository:
98
+
99
+ ```bash
100
+ cd your-project && npx -y @hybridlabor-api/aos@latest --project-harness -y
101
+ ```
107
102
 
108
103
  ---
109
104
 
110
- ## 🗂️ Die Umfassende Skill-Bibliothek
111
-
112
- Nachfolgend finden Sie die vollständige Übersicht aller in diesem Paket enthaltenen kuratierten Agent-Skills. Diese werden durch den interaktiven Installer automatisch in den Workspace Ihres Agenten einsortiert.
113
-
114
- <details>
115
- <summary><strong>👑 Core Godmodes</strong></summary>
116
-
117
- | Skill-Name | Beschreibung |
118
- |------------|-------------|
119
- | `godmode-3d-creation` | Orchestrierungs-Master-Skill für alle 3D-Generierungs-, Modellierungs- und Rekonstruktionsaufgaben. Agiert als 3D-Gehirn für die BDB Creator Extension. |
120
- | `godmode-engineering` | BDB Engineering Godmode. Erzwingt strenges Domain-Driven Design, TypeScript-Striktheit, Clean Architecture und systematisches 5-Stufen-Debugging. |
121
- | `godmode-eventtech` | BDB EventTech Godmode. Das oberste Regelwerk für die BDB Creator Engine, das Godmode-3D, Godmode-Media und die 19 Creative-Tech MCP Wrappern steuert. |
122
- | `godmode-media-creation` | Orchestrierungs-Master-Skill für alle Medienerstellungsaufgaben (Video, Audio, Bild, Motion Design). Agiert als Gehirn für die BDB Creator Extension. |
123
- | `godmode-shipping` | BDB Shipping Godmode. Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, strenge Pre-Launch-Prüfungen, Feature Flags und Rollback-Strategien. |
124
- | `godmode-ui-ux` | BDB UI/UX Godmode. Der absolute Goldstandard für Frontend-Design. Erzwingt Anti-Slop-Prinzipien, Enterprise-Barrierefreiheit, fluide Bewegungsdynamiken und datengestützte Design-Generierung über alle Agent-Harnesses hinweg. |
125
-
126
- </details>
127
-
128
- <details>
129
- <summary><strong>⚙️ System & Konfiguration</strong></summary>
130
-
131
- #### 🤖 Agenten & Automatisierung
132
- | Skill-Name | Beschreibung |
133
- |------------|-------------|
134
- | `agent-manager-skill` | Manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling. |
135
- | `agent-memory-mcp` | A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions). |
136
- | `agent-orchestrator` | Meta-skill que orquestra todos os agentes do ecossistema. Scan automatico de skills, match por capacidades, coordenacao de workflows multi-skill e registry management. |
137
- | `agent-pipeline` | Referenz für den BDB-Lebenszyklus (define → plan → build → verify/review → ship), den der Dispatcher-Graph von `/startcycle-graph` tatsächlich ausführt. |
138
- | `agent-tool-builder` | Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary. This skill covers tool design from schema to error handling. |
139
- | `ai-agent-development` | AI agent development workflow for building autonomous agents, multi-agent systems, and agent orchestration with CrewAI, LangGraph, and custom agents. |
140
- | `apify-lead-generation` | Scrape leads from multiple platforms using Apify Actors. |
141
- | `apify-ultimate-scraper` | AI-driven data extraction from 55+ Actors across all major platforms. This skill automatically selects the best Actor for your task. |
142
- | `bdbrainstorm` | Combines multi-agent brainstorming, the /grill-me slash command, subagent-driven-development, and ui-ux-pro-max to force a comprehensive, multi-agent ideation and UI/UX design workflow. |
143
- | `browser-automation` | Browser automation powers web testing, scraping, and AI agent interactions. The difference between a flaky script and a reliable system comes down to understanding selectors, waiting strategies, and anti-detection patterns. |
144
- | `crewai` | Expert in CrewAI - the leading role-based multi-agent framework used by 60% of Fortune 500 companies. |
145
- | `documentation` | Documentation generation workflow covering API docs, architecture docs, README files, code comments, and technical writing. |
146
- | `git-advanced-workflows` | Master advanced Git techniques to maintain clean history, collaborate effectively, and recover from any situation with confidence. |
147
- | `github-actions-templates` | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. |
148
- | `github-repo` | Standards and workflows for writing, formatting, sanitizing, and publishing high-quality GitHub repositories, complementing openwiki-skill. |
149
- | `github-workflow-automation` | Patterns for automating GitHub workflows with AI assistance, inspired by [Gemini CLI](https://github.com/google-gemini/gemini-cli) and modern DevOps practices. |
150
- | `go-playwright` | Expert capability for robust, stealthy, and efficient browser automation using Playwright Go. |
151
- | `n8n-code-javascript` | Write JavaScript code in n8n Code nodes. Use when writing JavaScript in n8n, using $input/$json/$node syntax, making HTTP requests with $helpers, working with dates using DateTime, troubleshooting Code node errors, or choosing between Code node modes. |
152
- | `n8n-code-python` | Write Python code in n8n Code nodes. Use when writing Python in n8n, using _input/_json/_node syntax, working with standard library, or need to understand Python limitations in n8n Code nodes. |
153
- | `n8n-expression-syntax` | Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors, or working with webhook data in workflows. |
154
- | `n8n-mcp-tools-expert` | Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. |
155
- | `n8n-workflow-patterns` | Proven architectural patterns for building n8n workflows. |
156
- | `notion-automation` | Automate Notion tasks via Rube MCP (Composio): pages, databases, blocks, comments, users. Always search tools first for current schemas. |
157
- | `os-scripting` | Operating system and shell scripting troubleshooting workflow for Linux, macOS, and Windows. Covers bash scripting, system administration, debugging, and automation. |
158
- | `rag-implementation` | RAG (Retrieval-Augmented Generation) implementation workflow covering embedding selection, vector database setup, chunking strategies, and retrieval optimization. |
159
- | `slack-automation` | Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit. |
160
- | `subagent-driven-development` | Use when executing implementation plans with independent tasks in the current session |
161
- | `tdd-workflow` | Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle. |
162
- | `tmux` | Expert tmux session, window, and pane management for terminal multiplexing, persistent remote workflows, and shell scripting automation. |
163
-
164
- #### 🎨 Frontend & UI/UX
165
- | Skill-Name | Beschreibung |
166
- |------------|-------------|
167
- | `mcp-manage` | Manages the BDB specialized MCP servers including Unreal Engine, Rhino 7/8, DaVinci Resolve, grandMA3, Resolume, GitHub, Chrome DevTools, and TouchDesigner. |
168
- | `api-design-principles` | Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time. |
169
- | `api-patterns` | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. |
170
- | `database-design` | Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases. |
171
- | `design-taste-frontend` | Use when building high-agency frontend interfaces with strict design taste, calibrated color, responsive layout, and motion rules. |
172
- | `drizzle-orm-expert` | Expert in Drizzle ORM for TypeScript — schema design, relational queries, migrations, and serverless database integration. Use when building type-safe database layers with Drizzle. |
173
- | `frontend-design` | You are a frontend designer-engineer, not a layout generator. |
174
- | `frontend-dev-guidelines` | You are a senior frontend engineer operating under strict architectural and performance standards. Use when creating components or pages, adding new features, or fetching or mutating data. |
175
- | `landing-page-generator` | Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO. |
176
- | `llm-application-dev-ai-assistant` | You are an AI assistant development expert specializing in creating intelligent conversational interfaces, chatbots, and AI-powered applications. Design comprehensive AI assistant solutions with natur |
177
- | `nextjs-app-router-patterns` | Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development. |
178
- | `nextjs-best-practices` | Next.js App Router principles. Server Components, data fetching, routing patterns. |
179
- | `openapi-spec-generation` | Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance. |
180
- | `postgres-best-practices` | Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations. |
181
- | `postgresql` | Design a PostgreSQL-specific schema. Covers best-practices, data types, indexing, constraints, performance patterns, and advanced features |
182
- | `prisma-expert` | You are an expert in Prisma ORM with deep knowledge of schema design, migrations, query optimization, relations modeling, and database operations across PostgreSQL, MySQL, and SQLite. |
183
- | `programmatic-seo` | Design and evaluate programmatic SEO strategies for creating SEO-driven pages at scale using templates and structured data. |
184
- | `react-best-practices` | Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Use when writing new React components or Next.js pages, implementing data fetching (client or server-side), or reviewing code for performance issues. |
185
- | `react-component-performance` | Diagnose slow React components and suggest targeted performance fixes. |
186
- | `react-patterns` | Modern React patterns and principles. Hooks, composition, performance, TypeScript best practices. |
187
- | `schema-markup` | Design, validate, and optimize schema.org structured data for eligibility, correctness, and measurable SEO impact. |
188
- | `senior-frontend` | Frontend development skill for React, Next.js, TypeScript, and Tailwind CSS applications. Use when building React components, optimizing Next.js performance, analyzing bundle sizes, scaffolding frontend projects, implementing accessibility, or reviewing frontend code quality. |
189
- | `shadcn` | Manages shadcn/ui components and projects, providing context, documentation, and usage patterns for building modern design systems. |
190
- | `software-architecture` | Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development. |
191
- | `spline-3d-integration` | Use when adding interactive 3D scenes from Spline.design to web projects, including React embedding and runtime control API. |
192
- | `tailwind-patterns` | Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture. |
193
- | `tanstack-query-expert` | Expert in TanStack Query (React Query) — asynchronous state management. Covers data fetching, stale time configuration, mutations, optimistic updates, and Next.js App Router (SSR) integration. |
194
- | `ui-component` | Generate a new UI component that follows StyleSeed Toss conventions for structure, tokens, accessibility, and component ergonomics. |
195
- | `ui-page` | Scaffold a new mobile-first page using StyleSeed Toss layout patterns, section rhythm, and existing shell components. |
196
- | `ui-pattern` | Generate reusable UI patterns such as card sections, grids, lists, forms, and chart wrappers using StyleSeed Toss primitives. |
197
- | `ui-review` | Review UI code for StyleSeed design-system compliance, accessibility, mobile ergonomics, spacing discipline, and implementation quality. |
198
- | `ui-tokens` | List, add, and update StyleSeed design tokens while keeping JSON sources, CSS variables, and dark-mode values in sync. |
199
- | `ui-ux-pro-max` | Comprehensive design guide for web and mobile applications. Use when designing new UI components or pages, choosing color palettes and typography, or reviewing code for UX issues. |
200
- | `ux-audit` | Audit screens against Nielsen's heuristics and mobile UX best practices using the StyleSeed Toss design language as the implementation context. |
201
- | `ux-feedback` | Add loading, empty, error, and success feedback states to StyleSeed components and pages with practical mobile-first rules. |
202
- | `ux-flow` | Design user flows and screen structure using StyleSeed UX patterns such as progressive disclosure, hub-and-spoke navigation, and information pyramids. |
203
- | `ux-persuasion-engineer` | One sentence - what this skill does and when to invoke it |
204
- | `vercel-ai-sdk-expert` | Expert in the Vercel AI SDK. Covers Core API (generateText, streamText), UI hooks (useChat, useCompletion), tool calling, and streaming UI components with React and Next.js. |
205
- | `wcag-audit-patterns` | Comprehensive guide to auditing web content against WCAG 2.2 guidelines with actionable remediation strategies. |
206
- | `web-artifacts-builder` | To build powerful frontend claude.ai artifacts, follow these steps: |
207
- | `zustand-store-ts` | Create Zustand stores following established patterns with proper TypeScript types and middleware. |
208
-
209
- #### 🗄️ Backend & Datenbanken
210
- | Skill-Name | Beschreibung |
211
- |------------|-------------|
212
- | `gemini-api-dev` | The Gemini API provides access to Google's most advanced AI models. Key capabilities include: |
213
- | `gemini-api-integration` | Use when integrating Google Gemini API into projects. Covers model selection, multimodal inputs, streaming, function calling, and production best practices. |
214
- | `github` | Use the `gh` CLI for issues, pull requests, Actions runs, and GitHub API queries. |
215
- | `go-concurrency-patterns` | Master Go concurrency with goroutines, channels, sync primitives, and context. Use when building concurrent Go applications, implementing worker pools, or debugging race conditions. |
216
- | `golang-pro` | Master Go 1.22+ with modern patterns, advanced concurrency, performance optimization, and production-ready microservices. |
217
- | `llm-structured-output` | Get reliable JSON, enums, and typed objects from LLMs using response_format, tool_use, and schema-constrained decoding across OpenAI, Anthropic, and Google APIs. |
218
- | `microservices-patterns` | Master microservices architecture patterns including service boundaries, inter-service communication, data management, and resilience patterns for building distributed systems. |
219
- | `neon-postgres` | Expert patterns for Neon serverless Postgres, branching, connection pooling, and Prisma/Drizzle integration |
220
- | `python-patterns` | Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying. |
221
- | `python-performance-optimization` | Profile and optimize Python code using cProfile, memory profilers, and performance best practices. Use when debugging slow Python code, optimizing bottlenecks, or improving application performance. |
222
- | `python-pro` | Master Python 3.12+ with modern features, async programming, performance optimization, and production-ready practices. Expert in the latest Python ecosystem including uv, ruff, pydantic, and FastAPI. |
223
- | `rag-engineer` | Expert in building Retrieval-Augmented Generation systems. Masters embedding models, vector databases, chunking strategies, and retrieval optimization for LLM applications. |
224
- | `using-neon` | Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres. |
225
- | `vector-database-engineer` | Expert in vector databases, embedding strategies, and semantic search implementation. Masters Pinecone, Weaviate, Qdrant, Milvus, and pgvector for RAG applications, recommendation systems, and similar |
226
- | `web-scraper` | Web scraping inteligente multi-estrategia. Extrai dados estruturados de paginas web (tabelas, listas, precos). Paginacao, monitoramento e export CSV/JSON. |
227
- | `webapp-testing` | To test local web applications, write native Python Playwright scripts. |
228
-
229
- #### 🚀 DevOps & Infrastruktur
230
- | Skill-Name | Beschreibung |
231
- |------------|-------------|
232
- | `bash-linux` | Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems. |
233
- | `cloudflare-workers-expert` | Expert in Cloudflare Workers and the Edge Computing ecosystem. Covers Wrangler, KV, D1, Durable Objects, and R2 storage. |
234
- | `docker-expert` | You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices. |
235
- | `git-pr-review` | Generate a concise and structured PR description from commit history with minimal token usage |
236
- | `llm-app-patterns` | Production-ready patterns for building LLM applications, inspired by [Dify](https://github.com/langgenius/dify) and industry best practices. |
237
- | `local-llm-expert` | Master local LLM inference, model selection, VRAM optimization, and local deployment using Ollama, llama.cpp, vLLM, and LM Studio. Expert in quantization formats (GGUF, EXL2) and local AI privacy. |
238
- | `posix-shell-pro` | Expert in strict POSIX sh scripting for maximum portability across Unix-like systems. Specializes in shell scripts that run on any POSIX-compliant shell (dash, ash, sh, bash --posix). |
239
- | `turborepo-caching` | Configure Turborepo for efficient monorepo builds with local and remote caching. Use when setting up Turborepo, optimizing build pipelines, or implementing distributed caching. |
240
- | `vercel-deployment` | Expert knowledge for deploying to Vercel with Next.js |
241
-
242
- #### 🧠 KI & LLM
243
- | Skill-Name | Beschreibung |
244
- |------------|-------------|
245
- | `ai-product` | Every product will be AI-powered. The question is whether you'll build it right or ship a demo that falls apart in production. |
246
- | `llm-prompt-optimizer` | Use when improving prompts for any LLM. Applies proven prompt engineering techniques to boost output quality, reduce hallucinations, and cut token usage. |
247
- | `openwiki-skill` | Direkte, Gemini-native Integration von OpenWiki für autonomes, hochgradig eigenverantwortliches Dokumentationsmanagement und Release Notes-Pflege. |
248
- | `prompt-engineer` | Transforms user prompts into optimized prompts using frameworks (RTF, RISEN, Chain of Thought, RODES, Chain of Density, RACE, RISE, STAR, SOAP, CLEAR, GROW) |
249
- | `prompt-engineering-patterns` | Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability. |
250
-
251
- #### 📝 Dokumentation & Planung
252
- | Skill-Name | Beschreibung |
253
- |------------|-------------|
254
- | `architect-review` | Master software architect specializing in modern architecture |
255
- | `concise-planning` | Use when a user asks for a plan for a coding task, to generate a clear, actionable, and atomic checklist. |
256
- | `copywriting` | Write rigorous, conversion-focused marketing copy for landing pages and emails. Enforces brief confirmation and strict no-fabrication rules. |
257
- | `deep-research` | Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports. |
258
- | `executing-plans` | Use when you have a written implementation plan to execute in a separate session with review checkpoints |
259
- | `linear-claude-skill` | Manage Linear issues, projects, and teams |
260
- | `memb-skill` | BDB Local-First-Langzeitgedächtnis-Engine (memB). Erfragen, merken und anpassen von Präferenzen, Code-Architekturen und Entwicklermustern über alle Aufgaben hinweg. |
261
- | `modern-javascript-patterns` | Comprehensive guide for mastering modern JavaScript (ES6+) features, functional programming patterns, and best practices for writing clean, maintainable, and performant code. |
262
- | `planning-with-files` | Work like Manus: Use persistent markdown files as your "working memory on disk." |
263
- | `product-manager-toolkit` | Essential tools and frameworks for modern product management, from discovery to delivery. |
264
- | `readme` | You are an expert technical writer creating comprehensive project documentation. Your goal is to write a README.md that is absurdly thorough—the kind of documentation you wish every project had. |
265
- | `test-driven-development` | Use when implementing any feature or bugfix, before writing implementation code |
266
- | `writing-plans` | Use when you have a spec or requirements for a multi-step task, before touching code |
267
-
268
- #### 🧊 3D & Motion
269
- | Skill-Name | Beschreibung |
270
- |------------|-------------|
271
- | `remotion` | Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays |
272
- | `threejs-skills` | Create 3D scenes, interactive experiences, and visual effects using Three.js. Use when user requests 3D graphics, WebGL experiences, 3D visualizations, animations, or interactive 3D elements. |
273
-
274
- #### 📈 SEO & Marketing
275
- | Skill-Name | Beschreibung |
276
- |------------|-------------|
277
- | `geo-fundamentals` | Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity). |
278
- | `seo` | Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO. Use as the umbrella skill when the user asks for a full SEO analysis or strategy. |
279
- | `seo-audit` | Diagnose and audit SEO issues affecting crawlability, indexation, rankings, and organic performance. |
280
- | `seo-technical` | Audit technical SEO across crawlability, indexability, security, URLs, mobile, Core Web Vitals, structured data, JavaScript rendering, and related platform signals like robots.txt and AI crawler access. |
281
-
282
- #### 🔧 Core Programmierung & Debugging
283
- | Skill-Name | Beschreibung |
284
- |------------|-------------|
285
- | `clean-code` | This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean." |
286
- | `debugger` | Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues. |
287
- | `playwright-skill` | IMPORTANT - Path Resolution: This skill can be installed in different locations (plugin system, manual installation, global, or project-specific). Before executing any commands, determine the skill directory based on where you loaded this SKILL.md file, and use that path in all commands below. |
288
- | `simplify-code` | Review a diff for clarity and safe simplifications, then optionally apply low-risk fixes. |
289
- | `systematic-debugging` | Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes |
290
- | `typescript-pro` | Master TypeScript with advanced types, generics, and strict type safety. Handles complex type systems, decorators, and enterprise-grade patterns. |
291
-
292
- #### 📦 Weitere Utilities
293
- | Skill-Name | Beschreibung |
294
- |------------|-------------|
295
- | `bdb-updater` | Proactively check for and install updates to the BDB Antigravity Skills package via NPM. |
296
- | `monorepo-management` | Build efficient, scalable monorepos that enable code sharing, consistent tooling, and atomic changes across multiple packages and applications. |
297
- | `obsidian-markdown` | Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes. |
298
- | `token-saver-config` | Context window output compression engine for CLI commands (60-99% token reduction). |
299
- | `web-performance-optimization` | Optimize website and web application performance including loading speed, Core Web Vitals, bundle size, caching strategies, and runtime performance |
300
-
301
- </details>
302
-
303
- <details>
304
- <summary><strong>🌀 BDB Ökosystem & Methodiken</strong></summary>
305
-
306
- | Skill-Name | Beschreibung |
307
- |------------|-------------|
308
- | `bdbmediastorm` | The ultimate creative-tech and show-control brainstorming engine. Orchestrates multi-agent ideation focused on signal flow, hardware constraints, protocols, and BDB MCP integrations. Now strictly governed by the 3 Core Godmodes (engineering, ui-ux, shipping). |
309
- | `bdbrainstorm` | Combines multi-agent brainstorming, the /grill-me slash command, and the 3 Core Godmodes (godmode-engineering, godmode-ui-ux, godmode-shipping) to force a comprehensive, multi-agent ideation and technical design workflow. |
310
- | `github-repo` | Standards and workflows for writing, formatting, sanitizing, and publishing high-quality GitHub repositories, complementing openwiki-skill. |
311
- | `memb-ingest` | Deep scan and ingest project files (.md, .json, AGENTS.md, .openwiki) and past conversation logs into the local memB vector memory engine. |
312
-
313
- </details>
314
-
315
- <details>
316
- <summary><strong>🔥 Spezialisierte Workspace-Agenten</strong></summary>
317
-
318
- #### 🤖 Agenten & Automatisierung
319
- | Skill-Name | Beschreibung |
320
- |------------|-------------|
321
- | `firecrawl-agent` | AI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, product listings, directory entries, or any data as JSON with a schema. Triggers on "extract structured data", "get all the products", "pull pricing info", "extract as JSON", or when the user provides a JSON schema for website data. More powerful than simple scraping for multi-page structured extraction. |
322
- | `firecrawl-build-onboarding` | Get Firecrawl credentials and SDK setup into a project. Use when an application needs `FIRECRAWL_API_KEY`, when an agent should add Firecrawl to `.env`, when the user wants to authenticate Firecrawl for app code, or when choosing the first SDK and docs for a new Firecrawl integration. This skill includes its own browser auth flow, so it does not depend on the website onboarding skill. |
323
- | `firecrawl-build-search` | Integrate Firecrawl `/search` into product code and agent workflows. Use when an app needs discovery before extraction, when the feature starts with a query instead of a URL, or when the system should search the web and optionally hydrate result content. |
324
-
325
- #### 🗄️ Backend & Datenbanken
326
- | Skill-Name | Beschreibung |
327
- |------------|-------------|
328
- | `firecrawl-build` | Integrate Firecrawl into product code for web scraping, crawling, searching, and interaction. Use this skill when an application needs to access web data, extract content, or automate web interactions. |
329
- | `firecrawl-build-interact` | Integrate Firecrawl `/interact` into product code for dynamic pages and browser actions after scraping. Use when a feature needs clicks, form fills, pagination, authentication-aware flows, or other multi-step interactions that plain `/scrape` cannot complete. |
330
- | `firecrawl-download` | Download an entire website as local files — markdown, screenshots, or multiple formats per page. Use this skill when the user wants to save a site locally, download documentation for offline use, bulk-save pages as files, or says "download the site", "save as local files", "offline copy", "download all the docs", or "save for reference". Combines site mapping and scraping into organized local directories. |
331
- | `firecrawl-interact` | Control and interact with a live browser session on any scraped page — click buttons, fill forms, navigate flows, and extract data using natural language prompts or code. Use when the user needs to interact with a webpage beyond simple scraping: logging into a site, submitting forms, clicking through pagination, handling infinite scroll, navigating multi-step checkout or wizard flows, or when a regular scrape failed because content is behind JavaScript interaction. Also useful for authenticated scraping via profiles. Triggers on "interact", "click", "fill out the form", "log in to", "sign in", "submit", "paginated", "next page", "infinite scroll", "interact with the page", "navigate to", "open a session", or "scrape failed". |
332
-
333
- #### 🚀 DevOps & Infrastruktur
334
- | Skill-Name | Beschreibung |
335
- |------------|-------------|
336
- | `firecrawl` | Search, scrape, and interact with the web via the Firecrawl CLI. Use this skill whenever the user wants to search the web, find articles, research a topic, look something up online, scrape a webpage, grab content from a URL, get data from a website, crawl documentation, download a site, or interact with pages that need clicks or logins. Also use when they say "fetch this page", "pull the content from", "get the page at https://", or reference external websites. This provides real-time web search with full page content and interact capabilities — beyond what Claude can do natively with built-in tools. Do NOT trigger for local file operations, git commands, deployments, or code editing tasks. |
337
-
338
- #### 🧠 KI & LLM
339
- | Skill-Name | Beschreibung |
340
- |------------|-------------|
341
- | `firecrawl-scrape` | Extract clean markdown from any URL, including JavaScript-rendered SPAs. Use this skill whenever the user provides a URL and wants its content, says "scrape", "grab", "fetch", "pull", "get the page", "extract from this URL", or "read this webpage". Handles JS-rendered pages, multiple concurrent URLs, and returns LLM-optimized markdown. Use this instead of WebFetch for any webpage content extraction. |
342
-
343
- #### 📝 Dokumentation & Planung
344
- | Skill-Name | Beschreibung |
345
- |------------|-------------|
346
- | `firecrawl-crawl` | Bulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction. |
347
-
348
- #### 📦 Weitere Utilities
349
- | Skill-Name | Beschreibung |
350
- |------------|-------------|
351
- | `firecrawl-build-scrape` | Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level. |
352
- | `firecrawl-map` | Discover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", or "list all pages". Essential when the user knows which site but not which exact page. |
353
- | `firecrawl-search` | Web search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "search for", "find me", "look up", "what are people saying about", or "find articles about". Returns real search results with optional full-page markdown — not just snippets. Provides capabilities beyond Claude's built-in WebSearch. |
354
-
355
- </details>
105
+ ## Unterstützte Harnesses
356
106
 
107
+ Was das Installationsprogramm für jedes Ziel schreibt. Pfade sind die Standardwerte; das Installationsprogramm schreibt nur in Harnesses, die tatsächlich erkannt werden.
357
108
 
358
- ---
109
+ | Harness | Skills | Subagents | Hooks | Plugin / rules |
110
+ |---|---|---|---|---|
111
+ | Claude Code / Claude Desktop | `~/.claude/skills` | `~/.claude/agents` | `~/.claude/hooks` + `settings.json` (GO gate, graph gate, env-file protection, Conventional Commits, memB inject, trail relay) | `.claude-plugin/` manifest ships in the repo (see Contributing) |
112
+ | Google Antigravity | `~/.gemini/config/skills` | `~/.gemini/config/agents` | `~/.gemini/config/hooks.json` and `~/.gemini/antigravity-cli/hooks.json` | — |
113
+ | Codex CLI | `~/.codex/skills` | `~/.codex/agents` | `~/.codex/hooks` + `config.toml` | `.codex-plugin/` |
114
+ | OpenCode | `~/.config/opencode/skills` | `~/.opencode/agents` | via plugin | `bdb-aos.js` plugin + `/startcycle-graph` command, registered in `opencode.jsonc`; keeps a `/startcycle-graph` run moving on `session.idle` |
115
+ | Cursor | `~/.cursor/skills` | — | — | `.cursor/rules` (project) |
116
+ | Windsurf | `~/.windsurf/bdb-skills` | — | — | `mcp.json` |
117
+ | Roo Code / Cline | `~/.roo/skills` | — | — | `.roomodes` (project) |
118
+ | Aider | `~/.aider/bdb-skills` | — | — | — |
119
+ | AOS CLI (`pi`) | reads `~/.agents/skills` | `~/.agents/AGENTS.md` as system prompt | — | no MCP; separate install, Node >= 22.19 — see [packages/aos-cli](packages/aos-cli/README.md) |
359
120
 
360
- ## 🔄 AOS: Der Dispatcher-Graph
121
+ Jede Installation schreibt auch die universelle Kopie zu `~/.agents/skills`, die von AOS CLI und der `skills` CLI gelesen wird.
361
122
 
362
- v4.0.0 ersetzt die alte lineare "5-Agenten-Pipeline"-Textbeschreibung durch eine echte, ausführbare
363
- State Machine. Der Contract liegt in [`.agents/graph.md`](.agents/graph.md),
364
- das Knoten-Verzeichnis in [`.agents/nodes.json`](.agents/nodes.json), und der
365
- ausführbare Dispatcher in
366
- [`.claude/workflows/startcycle-dispatch.mjs`](.claude/workflows/startcycle-dispatch.mjs).
123
+ ---
367
124
 
368
- **Die eine Regel, der alles andere folgt: Knoten rufen sich niemals gegenseitig auf.** Ein
369
- einzelner Dispatcher liest `production_artifacts/state.json` nachdem jeder Knoten
370
- zurückkehrt und entscheidet, was als Nächstes läuft. Es gibt keine Übergabekette, keinen Agenten,
371
- der einem anderen Agenten den Startbefehl gibt — genau das verhindert den Prompt-Drift, der lange Agenten-Pipelines vom Kurs abkommen lässt.
125
+ ## Die Pipelines
372
126
 
373
- ```mermaid
374
- flowchart LR
375
- U(["👤 Benutzer"])
376
- A["<b>Architect</b><br/><span>Systemplan (00)</span>"]
377
- T["<b>TechLead</b><br/><span>Capability-Freigabe</span>"]
378
- UX["<b>Godmode_UI_UX</b><br/><span>Frontend-Spezifikation (01)</span>"]
379
- EN["<b>Godmode_Engineering</b><br/><span>Backend-Schema (02)</span>"]
380
- ME["<b>Godmode_Media</b><br/><span>EventTech (03)</span>"]
381
- R["<b>Reviewer</b><br/><span>Doubt-Driven QA</span>"]
382
- S["<b>Shipping</b><br/><span>GO-Gate</span>"]
127
+ Der Vertrag lebt in [`.agents/graph.md`](.agents/graph.md), das Knoten-Register in [`.agents/nodes.json`](.agents/nodes.json), der ausführbare Dispatcher in [`.claude/workflows/startcycle-dispatch.mjs`](.claude/workflows/startcycle-dispatch.mjs).
383
128
 
384
- U --> A --> T
385
- T --> UX & EN & ME
386
- UX & EN & ME --> R
387
- R --> S
129
+ **Eine Regel: Knoten rufen sich gegenseitig nie auf.** Ein Dispatcher liest `production_artifacts/state.json` nach jeder Knotenrückkehr und entscheidet, was als nächstes ausgeführt wird. Es gibt keine Hand-off-Kette und keinen Agent, der einen anderen Agent auffordert zu gehen. Dieses Design gewährleistet Kontext-Treue, zentrale Nachverfolgbarkeit der Routing-Logik und Portabilität über Harnesses.
388
130
 
389
- T -.->|TechLead Ablehnung · Capability Map fehlt| A
390
- R -.->|Reviewer Findings · Reparaturschleife| UX
391
- S -.->|Gate fehlgeschlagen · Shipping benennt den Besitzer| EN
392
- R -.->|needs_human · No-Progress-Schutz| U
131
+ Jeder Knoten liest den Plan und seinen eigenen früheren Zustand, führt seine Arbeit aus, schreibt sein Artefakt und State-Fragmente und gibt zurück. Der Dispatcher verschmilzt Pro-Knoten-State-Fragmente (`state.d/<node>.json`), wertet Kanten-Prädikate aus und leitet zum nächsten Knoten weiter — oder eskaliert zum Benutzer, wenn ein No-Progress-Guard auslöst (gleicher blockierender Finding im zweiten Reparaturzyklus) oder die Iterations-Decke erreicht wird.
393
132
 
394
- classDef box fill:#161b26,stroke:#3a4560,stroke-width:1.5px,color:#e8edf7
395
- classDef user fill:#1a2436,stroke:#4a6fa5,stroke-width:1.5px,color:#dbeafe
396
- class A,T,UX,EN,ME,R,S box
397
- class U user
398
- linkStyle 8,9,10,11 stroke:#7d8799,stroke-width:1px,color:#9aa4b8
133
+ ```mermaid
134
+ flowchart LR
135
+ U(["User"]) --> A["Architect"] --> T["TechLead"]
136
+ T --> UX["Godmode_UI_UX"] & EN["Godmode_Engineering"] & ME["Godmode_Media"]
137
+ UX & EN & ME --> R["Reviewer"] --> S["Shipping"]
138
+ T -.->|reject| A
139
+ R -.->|findings| UX
140
+ R -.->|needs_human| U
399
141
  ```
400
142
 
401
- ### Was das Ganze zusammenhält
143
+ | Befehl | Maschinerie | Nutze wenn |
144
+ |---|---|---|
145
+ | `/startcycle` | Lineare Kette, Datei-Übergaben in `production_artifacts/`. Keine State Machine, keine Reparatur-Schleife. `/startcycle --skill=<name> <goal>` zwingt einen Skill in jeden Knoten. | Ein einfacher Build mit dem Agent-Verzeichnis, aber ohne die Zeremonie. |
146
+ | `/startcycle-graph` | Der vollständige Graph: dauerhaftes `state.json`, Reviewer-Reparaturschleife, automatisierte Quality-Gate, menschliche Eskalation. | Feature-Work, bei dem Korrektheit wichtiger ist als Geschwindigkeit und du eine Audit-Spur möchtest. |
147
+ | `/startcycle-graph-user` | Verwerfbare 2–4 Knoten-Ausfächerung. Nichts dauerhaft. Modell-gestaffelt pro Rolle; verwendet Antigravity, OpenCode oder Codex, falls installiert, sonst Claude Code Subagents. | Ein einmaliger "spawne ein paar Worker" in jedem Projekt. |
402
148
 
403
- | Mechanismus | Was er verhindert |
404
- |---|---|
405
- | **Reviewer-Isolation** | Der Reviewer liest Build-Artefakte und den Contract des Plans — niemals das ursprüngliche `goal`, niemals die Argumentation eines Build-Knotens oder dessen Behauptung, die Arbeit sei erledigt. Die Behauptung des Implementierers weiterzugeben, verleitet einen Reviewer zur Zustimmung; sie zurückzuhalten, macht das Review erst adversariell statt zu einem reinen Abnicken. |
406
- | **No-Progress-Schutz** | Wenn ein Reparaturzyklus dieselbe blockierende Finding-ID wie der vorherige meldet, wird de facto nichts repariert. Der Durchlauf eskaliert an einen Menschen, anstatt Iterationen durch das erneute Ausführen einer identischen Schleife zu verschwenden. |
407
- | **Knotenspezifische State-Fragmente** | Build-Knoten laufen parallel und jeder schreibt sein eigenes `state.d/<node>.json`-Fragment, die danach zusammengeführt werden — sie schreiben niemals direkt in `state.json`. Parallele Schreibvorgänge in eine JSON-Datei führen zu Lost-Update-Race-Conditions; Fragmente verhindern dieses Race by Design. |
408
- | **Iterations-Obergrenze** | `max_iterations` (Standard 3) stoppt die Schleife bedingungslos, absichtlich niedriger angesetzt als Claude Codes eigener 8-maliger Stop-Hook-Override, damit die eigene Eskalationsnachricht des Laufs Sie zuerst erreicht. |
409
- | **Eingebetteter menschlicher Eingriff** | Jeder Knoten kann `needs_human: true` setzen und den Lauf stoppen. Volle Autonomie klingt gut, bis ein Knoten auf etwas stößt, das nur ein Mensch entscheiden kann — dies ist eine explizite Kante im Graphen, keine Unterbrechung. |
410
- | **GO-geschütztes Shipping** | Das Erreichen von `ready_to_ship` bedeutet noch kein Shipping. `git push`, `npm publish`, `npm version` und rekursives `rm` werden durch einen `PreToolUse`-Hook blockiert ([`.claude/hooks/go-gate.mjs`](.claude/hooks/go-gate.mjs)), es sei denn, Ihre unmittelbar vorhergehende Nachricht ist buchstäblich das Wort **GO**. Es ist ein Hook, keine Regel, die ein Agent liest und zu befolgen versucht — er feuert vor jeglicher Berechtigungsmodus-Prüfung und lässt sich nicht wegdiskutieren. |
149
+ Was den vollständigen Graph ehrlich hält:
411
150
 
412
- ### Drei Varianten — wählen Sie danach, wie viel Maschinerie die Aufgabe erfordert
151
+ | Mechanismus | Was es verhindert |
152
+ |---|---|
153
+ | Reviewer isolation | Der Reviewer liest Artefakte und den Plan-Vertrag, nie die Begründung des Build-Knotens oder dessen Behauptung, fertig zu sein. |
154
+ | No-progress guard | Eine Reparaturzyklus, der die gleiche blockierende Finding-ID wie der vorherige meldet, eskaliert zu einem Menschen statt Iterationen zu verschwenden. |
155
+ | Per-node state fragments | Parallele Build-Knoten schreiben `state.d/<node>.json`; der Dispatcher führt zusammen. Kein Lost-Update Race auf einer Datei. |
156
+ | Iteration ceiling | `max_iterations` (Standard 3) stoppt die Schleife bedingungslos. |
157
+ | In-loop human edge | Jeder Knoten kann `needs_human: true` setzen und den Lauf stoppen. |
413
158
 
414
- | Befehl | Maschinerie | Wann nutzen |
415
- |---|---|---|
416
- | **`/startcycle`** | Lineare Kette, Dateiübergaben in `production_artifacts/`. Keine State Machine, keine Reparaturschleife. | Ein unkomplizierter Build, bei dem Sie das Agenten-Team, aber nicht die Zeremonie benötigen. |
417
- | **`/startcycle-graph`** | Der vollständige obige Graph: persistentes `state.json`, Reviewer-Reparaturschleife, Quality-Gate, automatisierte Eskalation. | Echte Feature-Arbeit, bei der Korrektheit wichtiger ist als Geschwindigkeit und Sie ein Audit-Protokoll des Geschehens wünschen. |
418
- | **`/startcycle-graph-user`** | Wegwerfbares 2–4-Knoten Fan-out. Nichts Dauerhaftes — kein `.agents/` Bootstrap, kein `state.json`. Modell-abgestuft nach Rolle (Opus plant, Sonnet reviewt, Haiku oder eine externe CLI übernimmt die mechanische Arbeit). | Ein einmaliges "starte ein paar Worker für diese Aufgabe" in *jedem* Projekt, einschließlich solchen, die noch nie von diesem Repo gehört haben. |
159
+ ## Das GO-Gate
419
160
 
420
- Die dritte Variante setzt bewusst nichts über Ihre Maschine voraus: Sie erkennt,
421
- ob Antigravity, OpenCode oder Codex vorhanden sind, und fällt auf Claude
422
- Codes eigene Subagenten zurück, wenn keines davon existiert. Modell-Stufen werden pro Rolle erzwungen, anstatt
423
- aus Ihrer Sitzung vererbt zu werden, sodass ein mechanischer Worker-Schritt nicht stillschweigend auf
424
- Opus läuft, nur weil Sie dieses zufällig ausgewählt hatten.
161
+ Das Erreichen von `ready_to_ship` ist kein Versand. [`.claude/hooks/go-gate.mjs`](.claude/hooks/go-gate.mjs) ist ein `PreToolUse` Hook, der `git push`, `npm publish`, `npm version` und rekursive `rm` blockiert, wenn deine unmittelbar vorherige Nachricht nicht das Wort **GO** ist. Es ist ein Hook, nicht eine Regel, die ein Agent respektieren soll: es wird vor jeder Berechtigungs-Modus-Prüfung ausgelöst und kann nicht diskutiert werden. Der Installer verbindet das gleiche Gate in Antigravity, Codex und OpenCode; auf Harnesses ohne Hook-Unterstützung gilt die Regel in [AGENTS.md](AGENTS.md) und der Agent ist die Durchsetzung. Ein Subagent erbt niemals das GO des Orchestrators, und ein fehlgeschlagener Release-Befehl benötigt einen neuen.
425
162
 
426
163
  ---
427
164
 
428
- ## 🧠 BDBrainstorm: Die Ultimative Ideations-Engine
165
+ ## Tools
166
+
167
+ ![BDB system components overview](assets/bdb_v3_4_0_core_tools_overview_sketch.jpg)
429
168
 
430
- Teil dieses optimierten Arsenals ist unsere proprietäre **BDBrainstorm**-Skill.
169
+ *Konzeptübersicht aus v3.4.0. Die Komponenten sind seitdem gewachsen; die folgenden Abschnitte sind aktuell.*
431
170
 
432
- BDBrainstorm kombiniert Multi-Agenten-Brainstorming, den Slash-Befehl `/grill-me`, Subagenten-Entwicklung und extrem hochstehende UI/UX-Design-Workflows, um einen umfassenden Multi-Agenten-Ideationsprozess zu erzwingen. Es unterzieht Designs einem Stresstest, architekturiert die dahinterstehenden Systeme und liefert umsetzbare, hochpräzise Entwicklungspläne.
171
+ | Tool | Befehl | Was es tut |
172
+ |---|---|---|
173
+ | Plan Canvas | `aos-plan-canvas open <file>` (skill `plan-canvas`) | Öffnet einen Plan oder HTML-Artefakt in einer lokalen Browser-Canvas, wo du Elemente annotierst, chattest und Änderungen genehmigst oder anforderst. Pläne aus den Pipelines öffnen sich hier standardmäßig. |
174
+ | agenttrail | `aos-trail` (skill `agenttrail`, port 5330) | Live-Board einer Multi-Agent-Build: welche Komponente, welcher Agent oder Harness, was ist fertig, was ist stecken geblieben. Gespeist von den Trail-Relay-Hooks und von `mcsc`. |
175
+ | archify | `aos-archify` (skill `archify`) | Validierte Architektur-, Sequenz-, Datenfluss- und State-Diagramme als eigenständige HTML mit SVG-Export; akzeptiert Mermaid. |
176
+ | AOS Store | `aos store list \| search <q> \| install <name> [--project]`, `aos store ui` (auch `aos-store`, slash command `/aos-store`) | Durchsuche und installiere AOS Core und ECC Skills und Agents. Die Web-UI auf `http://127.0.0.1:4322` zeigt, was installiert ist, zeigt die genauen Zielpfade in der Vorschau an und installiert nur nach deiner Bestätigung. Multi-Datei-Skills werden komplett installiert. `list` und `search` lesen einen angehefteten Offline-Index. |
177
+ | Launchpad | `aos-dashboard [--port 7900] [--no-open]` | Eine Seite mit jedem lokalen BDB-Service (memB, Synapse, OpenWiki, AO, Remote, AOS Store): Status, Start/Stop, Logs. Registriert als Autostart-Eintrag. |
178
+ | Doctor | `aos doctor [--json] [--net]` (auch `aos-doctor`) | Überprüft Abhängigkeiten, Skill-Platzierung pro Harness, Daemons, Hooks und Module; beendet sich mit 1, wenn etwas Aufmerksamkeit benötigt. Das erste, das zu laufen ist, wenn etwas nicht funktioniert. |
179
+ | Config | `aos-config show \| propose \| set <key> <value>` | Maschinenebene `~/.agents/aos-config.json`: Workspace-Root, Domänen, Benutzer-ID. |
180
+ | mcsc | MCP tools `delegate_agy`, `delegate_opencode`, `delegate_codex`, `delegate_smart` (skill `mcsc`) | Delegiert eine Aufgabe an einen anderen installierten CLI-Harness und streamt seine Tool-Aufrufe zu agenttrail. Bevorzugt gegenüber dem Aufruf der CLI. |
433
181
 
434
182
  ---
435
183
 
436
- ## 🔌 19 Lokale MCP Wrapper
184
+ ## AOS CLI
437
185
 
438
- ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
186
+ Ein leichtes CLI-Harness, das auf [pi](https://github.com/earendil-works/pi) aufgebaut ist, ein Coding-Agent, der im Terminal läuft. AOS CLI liest `~/.agents/skills` (vom Installationsprogramm geschrieben) und `~/.agents/AGENTS.md` (der Dispatcher-Graph als Systeminstruktion), führt keine eigenen MCP-Server aus und benötigt **Node >= 22.19** (pi's Basis, höher als der Haupt-AOS-Installer).
439
187
 
440
- Anstatt sich auf rudimentäre Python-Mocks oder fehlerhafte Remote-APIs zu verlassen, bündelt dieses Repository **19 eigene, lokale MCP-Wrapper** (im Ordner `mcps/`). Diese werden automatisch erstellt/aufgewärmt und ermöglichen Ihrem KI-Assistenten das Lesen, Schreiben und Ausführen von Befehlen in der führenden Kreativsoftware der Branche.
188
+ ```bash
189
+ aos-cli "what is the fastest way to fix this bug"
190
+ aos-cli --continue # resume the previous session
191
+ ```
441
192
 
442
- <details>
443
- <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>
193
+ Der CLI-Launcher (`packages/aos-cli/bin/aos-cli.mjs`) bringt ein dunkles AOS-Theme (`aos.json`), die zehn Kern-Skills aus `core-skills.json` (ask-tim, aos-setup, systematic-debugging, archify, etc.) und zwei In-Session-Nur-Lese-Befehlen (`/aos` zeigt das Install-Menü; `/aos-status` führt die Health-Überprüfung aus).
444
194
 
445
- Wir bieten eine Dual-Engine-Architektur, die für macOS- und Windows-Umgebungen optimiert ist:
446
- - **Direct OS-Native Bridge (`bdb_adobe_mcp`)**: Führt Skripte ohne Installation aus.
447
- - **macOS:** Spricht Anwendungs-Bundle-IDs direkt über AppleScript `do javascript` / `DoScript`-Befehlsstreams an.
448
- - **Windows:** Fragt lokale COM-Objekte über PowerShell-Wrapper-Skripte automatisch ab, instanziiert sie und führt temporären `.jsx` ExtendScript-Code aus.
449
- - **Cross-Platform UXP WebSocket Bridge (`bdb_adobe_uxp_mcp`)**: Ein Drei-Stufen-WebSocket-Proxy (Node.js-Server auf Port 8080 + native UXP-Entwickler-Plugins) für tiefe DOM-Manipulation und persistente WebSocket-Sitzungen in Photoshop und Premiere Pro, der auf Windows und macOS identisch läuft.
450
- </details>
195
+ Installiere es durch den AOS Installer mit dem AOS CLI Target: `npx -y @hybridlabor-api/aos@latest -y --platforms=10`. Das Paket ist privat und wird nicht auf npm veröffentlicht, daher funktioniert `npm i -g @hybridlabor-api/aos-cli` nicht.
451
196
 
452
- <details>
453
- <summary><strong>🎬 DaVinci Resolve (Dreifachabdeckung)</strong></summary>
454
197
 
455
- - **Hauptserver: `bdb_davinci_mcp`**: Funktioniert sowohl in der **Free- als auch Studio-Version** über eine Skript-Menüschleife im Workspace. Stellt 162 Tools bereit (Timeline, Clips, Marker, Color Grades, Fusion) und enthält lokale CPU-basierte KI-Modelle (Meta Demucs v4 für Stimmisolierung, faster-whisper für Auto-Untertitel und rembg für Hintergrundentfernung).
456
- - **Studio: `bdb_davinci_mcp_studio`**: Der offizielle Node.js-Server (basiert auf samuelgursky) für fortgeschrittenes, direktes Timeline- und Projektmanagement in Resolve Studio.
457
- - **Fallback: `bdb_davinci_mcp_fallback`**: Professioneller Hoyt-Harness-Python-Server für Studio-Scripting.
458
- </details>
198
+ ---
459
199
 
460
- <details>
461
- <summary><strong>📐 Rhino 3D & Grasshopper (Twin-Engine)</strong></summary>
200
+ ## Plugins und Marketplace
462
201
 
463
- - **Hauptserver: `bdb_rhino_mcp`**: Offizieller McNeel-Konnektor (verwaltet über Yak-Router) zum nativen Lesen/Schreiben von Rhino-Geometrielayouts.
464
- - **Fallback: `bdb_rhino_mcp_fallback`**: Der GOLEM 3D-Server mit 105 Tools zur dynamischen Manipulation von Rhino 8 Assets, Skriptausführung und Lösung von Grasshopper-Definitionen.
465
- </details>
202
+ **Plugin-Manifest:** `.claude-plugin/plugin.json` + `marketplace.json` (erzeugt mit `npm run plugin:build`). Der Installationsweg über den Claude-Marketplace wird noch finalisiert; bis dahin ist der oben beschriebene npm-Installer der unterstützte Weg.
466
203
 
467
- <details>
468
- <summary><strong>🏗️ Weitere Spezialisierte Integrationen (Unreal, TouchDesigner, Vectorworks etc.)</strong></summary>
204
+ **Skills discovery:** Jeder Harness findet Skills in seinem nativen Verzeichnis (`~/.claude/skills`, `~/.agents/skills`, `~/.codex/skills`, `~/.roo/skills`, etc.). Um nach der Installation weitere Skills zu durchsuchen und zu installieren:
469
205
 
470
- ### 🏗️ Vectorworks
471
- - **Hauptserver: `bdb_vectorworks_mcp`**: Semantischer RAG-basierter Suchindex über VectorScript- und Vectorworks-API-Dokumentation (Port 8765) für automatisiertes CAD-Drafting.
206
+ ```bash
207
+ npx skills add hybridlabor-api/aos
208
+ ```
472
209
 
473
- ### 🎮 Unreal Engine
474
- - **Hauptserver: `bdb_unreal_mcp`**: Verbindet sich über die Unreal Engine 5 Web Remote Control API (Port 30010) und das `gimmeDG`-Toolset. Ermöglicht dem Agenten das Abfragen, Spawnen von Actoren, Bearbeiten von Materialien, Schreiben von Blueprints und Automatisieren von Level/Sequencer-Steuerungen.
210
+ Dies entdeckt alle <!-- count:skills -->213<!-- /count --> kuratierten Skills und installiert sie in das universelle `~/.agents/skills` Verzeichnis (verwendet von allen Harnesses und dem AOS CLI).
475
211
 
476
- ### 🧊 Blender (Twin-Engine)
477
- - **Hauptserver: `bdb_blender_mcp`**: BlenderMCP Socket-Integration für Szenenlayout, Mesh-Generierung und Viewport-Steuerung.
478
- - **Fallback: `bdb_blender_mcp_fallback`**: djeadas Python-Server zur Verwaltung von Blender TCP-Verbindungen und rohem Python-Scripting.
212
+ ---
479
213
 
480
- ### 🎛️ TouchDesigner (Twin-Engine)
481
- - **Hauptserver: `bdb_touchdesigner_mcp`**: MindDesigner-Bridge (`tdmcp`) auf Port 9980 zum Lesen und Schreiben von Netzwerken über eigene `.tox`-Strukturen.
482
- - **Fallback: `bdb_touchdesigner_mcp_fallback`**: Fallback-TCP-basierte Knotenabfrage und Inspector.
214
+ ## Speicher und Wissen
483
215
 
484
- ### 💡 grandMA3 & Resolume
485
- - **grandMA3**: `bdb_ma3_mcp` sendet OSC/UDP-Befehlsstreams direkt an Ihre grandMA3-Konsole (Port 8000), um Cues, Makros und Fixture-Patching zu automatisieren.
486
- - **Resolume**: `bdb_resolume_mcp` bindet Arenas REST-API ein (Port 8080), um Ebenen zu steuern, Status abzufragen und Clips auszulösen.
216
+ Installiert als optionale Module durch das Installationsprogramm; `aos doctor` überprüft sie und das Launchpad zeigt sie.
487
217
 
488
- ### 🖥️ OS Control (Dual-Engine)
489
- - **macOS/Linux: `zavora_computer_use`**: Ausgeliefert mit vorkompilierten nativen Rust NAPI-Binärobjekten (macOS arm64/x64, Linux) zur Steuerung von Maus, Tastatur, Fenstern und Apps ohne Laufzeit-Kompilierungsfehler.
490
- - **Windows: `bdb_windows_computer_use`**: Nativer Python-basierter Win32 / COM / UIAutomation-Controller mit lokaler OCR-Unterstützung (Tesseract) für fortgeschrittene Windows GUI-Automatisierung.
218
+ - **memB** (`@hybridlabor-api/memb`) — lokal, offline Vektor-Memory mit einem MCP-Server (`add_memory`, `search_memory`, `list_memories`, `delete_memory`), WebUI auf Port 8088 und ein Ambient-Hook, der relevante Memories in Claude Code Sessions einfügt. Skills: `memb-skill`, `memb-ingest`, `bdb-memb-mcp`.
219
+ - **deja** (`@vshulcz/deja-vu`, mit memB installiert) — indiziert deine Agent-Transkripte lokal mit bereinigten Geheimnissen; `deja fix` bei einem Fehler, `deja wip` beim Fortsetzen, `deja search` für vergangene Sessions. Skill: `deja-memory`.
220
+ - **OpenWiki** (`openwiki` CLI) — erzeugt und aktualisiert ein fundiertes Wiki eines Codebase mit Visualizer auf Port 4321 und einem Background-Daemon. Skill: `openwiki-skill`; das eigene Wiki dieses Repos ist unter [`.openwiki/`](.openwiki/quickstart.md).
221
+ - **Synapse** (`@hybridlabor-api/bdb-synapse`) — rendert ein Repository als 3D-Code-Stadt und spielt Agent-Sessions darin ab. Skill: `synapse-integration-skill`.
491
222
 
492
- ### 🧠 Local Semantic Brain (memB)
493
- - **`memb_mcp`**: Stellt Standard-Langzeitgedächtnis-Tools (`add_memory`, `search_memory`, `delete_memory`, `list_memories`) über eine vollständig lokale, Offline-First Vektor-Engine bereit (angetrieben von einem mitgelieferten 30MB ONNX-Modell und SQLite).
494
- </details>
223
+ `aos-setup` bringt einen Rechner in einen geprüften Zustand für alle vier; `aos-project-init` bindet ein Projekt an sie (slug, wiki, memory, `AGENTS.md`).
495
224
 
496
225
  ---
497
226
 
498
- ## 📖 14 Spezialisierte System-Skills
499
-
500
- Dieses Repository enthält außerdem 14 Tiefensystem-Konfigurationen und Dokumentationsrichtlinien, die automatisch zugewiesen werden. Wenn ein KI-Agent dieses Paket importiert, liest er sofort diese Markdown-Dateien, um Tool-Signaturen, erwartete Argumente, ExtendScript-Hooks und häufige Fehlerbehebungsschritte für jede Anwendung zu lernen.
501
-
502
- <details>
503
- <summary><strong>System-Skill-Liste anzeigen</strong></summary>
504
-
505
- - [`bdb-unreal-mcp`](skills/global_config/bdb-unreal-mcp/SKILL.md)
506
- - [`bdb-rhino-mcp`](skills/global_config/bdb-rhino-mcp/SKILL.md)
507
- - [`bdb-davinci-mcp`](skills/global_config/bdb-davinci-mcp/SKILL.md)
508
- - [`bdb-blender-mcp`](skills/global_config/bdb-blender-mcp/SKILL.md)
509
- - [`bdb-after-effects-mcp`](skills/global_config/bdb-after-effects-mcp/SKILL.md)
510
- - [`bdb-vectorworks-mcp`](skills/global_config/bdb-vectorworks-mcp/SKILL.md)
511
- - [`bdb-touchdesigner-mcp`](skills/global_config/bdb-touchdesigner-mcp/SKILL.md)
512
- - [`bdb-computer-use-mcp`](skills/global_config/bdb-computer-use-mcp/SKILL.md)
513
- - [`bdb-grandma3-mcp`](skills/global_config/bdb-grandma3-mcp/SKILL.md)
514
- - [`bdb-resolume-mcp`](skills/global_config/bdb-resolume-mcp/SKILL.md)
515
- - [`bdb-adobe-suite-mcp`](skills/global_config/bdb-adobe-suite-mcp/SKILL.md)
516
- - [`bdb-memb-mcp`](skills/global_config/bdb-memb-mcp/SKILL.md)
517
- - [`openwiki-skill`](skills/global_config/openwiki-skill/SKILL.md): Direkte, Gemini-native Integration von OpenWiki für autonomes, hochgradig eigenverantwortliches Dokumentationsmanagement und Release Notes-Pflege.
518
- - [`memb-skill`](skills/global_config/memb-skill/SKILL.md): BDB Local-First-Langzeitgedächtnis-Engine (memB). Erfragen, merken und anpassen von Präferenzen, Code-Architekturen und Entwicklermustern über alle Aufgaben hinweg.
519
- </details>
520
-
521
- ---
227
+ ## Was enthalten ist
522
228
 
523
- ## 🌐 OpenWiki & RepoGraph Code Health Engine (v4.0.0)
229
+ ### Die <!-- count:agents -->13<!-- /count --> Subagents
524
230
 
525
- Die **OpenWiki Engine** verwaltet autonom lebendige Codebasis-Dokumentation, Architektur-Spezifikationen, ADRs, Release Notes und Echtzeit-Code-Health-Analysen über alle Ihre aktiven Projekte hinweg.
231
+ Der Dispatcher-Graph kompiliert diese Agents, verfügbar als Claude Code Subagents und ladbar in Antigravity, Cursor, Codex, OpenCode und andere:
526
232
 
527
- ### 📚 Dokumentation & Dashboard
528
- - **Entrypoint & Setup:** [.openwiki/quickstart.md](.openwiki/quickstart.md)
529
- - **Architecture & Ecosystem:** [.openwiki/architecture.md](.openwiki/architecture.md)
530
- - **Design Decisions (ADRs):** [.openwiki/decisions.md](.openwiki/decisions.md)
531
- - **Changelog & History:** [.openwiki/release_notes.md](.openwiki/release_notes.md)
532
- - **Code Health Report:** [.openwiki/code_health.md](.openwiki/code_health.md)
533
- - **Interactive Live Dashboard:** [.openwiki/code_health_dashboard.html](.openwiki/code_health_dashboard.html)
534
-
535
- <details>
536
- <summary><strong>🧠 Multi-Provider LLM & Zero-Token RepoGraph Architektur</strong></summary>
233
+ | Agent | Zweck |
234
+ |---|---|
235
+ | **Architect** | Wandelt das Ziel des Benutzers in einen Systemplan um. Liest vorhandene Architektur, bevor Änderungen vorgeschlagen werden. |
236
+ | **TechLead** | Überprüft den Plan auf eine Fähigkeitskarte (Modulgrenzen, Abhängigkeitsrichtung, Build-Reihenfolge), bevor ein Build-Knoten startet. Genehmigt oder lehnt zurück zu Architect ab. |
237
+ | **UI_UX** | Lead Frontend Designer. Setzt Anti-Slop-Prinzipien durch, DTCG-Design-Tokens, hochwertigen Frontend-Geschmack und flüssige Motion-Dynamik. |
238
+ | **Engineering** | Senior Fullstack & Backend Engineer. Setzt Domain-Driven Design, Clean Architecture, TDD-Zyklen und Datenbankbest Practices durch. |
239
+ | **Media_EventTech** | Creative-Tech & Show-Control Spezialist. Beherrscht 3D-Modellierung, TouchDesigner-Netzwerke, DaVinci Resolve, Lighting und Resolume. |
240
+ | **Reviewer** | Adversarische Überprüfung der Build-Knoten-Ausgabe gegen den Plan-Vertrag. Modelliert nach Doubt-Driven-Development Disziplin. |
241
+ | **Shipping** | Release Gatekeeper & QA Auditor. Führt das automatisierte Quality Gate (Lint, Typecheck, Tests, a11y, seo) aus und setzt das GO Gate durch. |
242
+ | **Database Reviewer** | PostgreSQL Spezialist für Query Optimierung, Schema-Design, Sicherheit und Performance. |
243
+ | **Security Reviewer** | Sicherheitslücken-Erkennung und Remediation. Flaggt Geheimnisse, SSRF, Injection, unsicheres Crypto und OWASP Top 10. |
244
+ | **Silent-Failure Hunter** | Überprüft Code auf stille Ausfallmöglichkeiten, verschluckte Fehler, schlechte Fallbacks und fehlende Fehler-Propagation. |
245
+ | **Go-Build Resolver** | Löst Go Build-, Vet- und Compilierungsfehler mit minimalen Änderungen. |
246
+ | **Opensource Forker** | Forkt ein Projekt zum Open-Sourcing — entfernt Geheimnisse, ersetzt interne Referenzen, generiert `.env.example`. |
247
+ | **Opensource Sanitizer** | Verifiziert, dass ein Open-Source-Fork vollständig bereinigt ist. Scannt auf durchgesickerte Geheimnisse, PII, interne Referenzen. |
248
+
249
+ ### Skills nach Kategorie
250
+
251
+ <!-- count:skills -->213<!-- /count --> kuratierte Skills, von jedem Harness auffindbar:
252
+
253
+ - **bdb-core** (30 Skills): Core AOS Infrastruktur, Pipelines, Tools und Utilities — `startcycle`, `startcycle-graph`, `startcycle-graph-user`, `agent-orchestrator`, `agenttrail`, `plan-canvas`, `aos-doctor`, `aos-store`, `bdb-dev-os-skill` und mehr.
254
+ - **design-ui-ux** (19 Skills): Frontend, UI Design, Barrierefreiheit, Tokens, Motion, Anti-Slop — `senior-frontend`, `ui-component`, `ui-review`, `tailwind-patterns`, `shadcn`, `wcag-audit-patterns` und mehr.
255
+ - **engineering-method** (46 Skills): Architektur, Testing, Debugging, CI/CD, Code-Qualität — `software-architecture`, `test-driven-development`, `systematic-debugging`, `ci-pipeline`, `github-actions-generator`, `dockerfile-validator` und mehr.
256
+ - **library** (98 Skills): Language/Framework-Spezifika — TypeScript, Node.js, Python, React, Postgres, Prisma, Next.js, Drizzle ORM, Go und mehr.
257
+ - **media-eventtech** (19 Skills): 3D, Video, Show Control, Spatial Design — `godmode-eventtech`, `synapse-integration-skill`, `threejs-skills`, `blender-expert` und mehr.
258
+ - **engineering-hardware** (1 Skill): PCB und Electrical Design — `godmode-hardware-pcb`.
259
+
260
+ Der vollständige Katalog mit detaillierten Beschreibungen: [docs/skills_table.md](docs/skills_table.md) — Hinweis: Diese Datei ist veraltet und listet 164 von 213 Skills auf.
537
261
 
538
- 1. **Multi-Provider LLM Agility:** Entkoppelt von Herstellerabhängigkeiten (Vendor Lock-in). Konfigurieren Sie jedes beliebige LLM-Backend über Umgebungsvariablen:
539
- - **Google GenAI:** `gemma-4-26b-a4b-it` (Standard via `google-genai` SDK, mit automatischem Modell-Discovery-Fallback)
540
- - **Groq:** `llama-3.3-70b-versatile` (ultra-low latency)
541
- - **Grok / xAI:** `grok-2-latest`
542
- - **Nvidia NIM:** `meta/llama-3.3-70b-instruct`
543
- - **OpenRouter:** `anthropic/claude-3.5-sonnet` (200+ models)
544
- - **OpenAI:** `gpt-4o-mini` / `gpt-4o`
545
- - **Offline / Lokal:** Ollama (`llama3`), LM Studio, oder jeder OpenAI-kompatible Endpunkt.
546
- 2. **RepoGraph Zero-Token Git Analytics:** Analysiert 90-Tage-Hotspot-Geschwindigkeit, Bus-Faktor-Risiko von Einzelautoren und Wartbarkeitsindex rein durch deterministische lokale Git-Analyse — was genau **0 LLM tokens**.
547
- 3. **Repowise-Grade Live HTML Dashboard:** `.openwiki/code_health_dashboard.html` bietet 6 visuelle SVG-Panels (Galaxy Cluster Map, Risk Donut, Bus Factor Matrix, Commit Velocity Churn, Hotspot Leaderboard, Architecture Health Radar) mit **60-second live auto-refresh** und integrierter memB ADR-Telemetrie.
548
- </details>
262
+ ---
549
263
 
550
- <details>
551
- <summary><strong>⚙️ Einrichten des Hintergrund-Daemons</strong></summary>
264
+ ## Skills
552
265
 
553
- Um sicherzustellen, dass Ihre Projektdokumentation und Code-Health-Dashboards niemals veralten, konfigurieren Sie den Hintergrund-Daemon:
266
+ <!-- count:skills -->213<!-- /count --> Skills, kuratiert aus Open-Source- und proprietären Sammlungen, die die gesamte Software-Entwicklung und Creative-Pipeline abdecken. Jeder Skill ist ein Verzeichnis mit einem `SKILL.md` Frontmatter, das `name`, `description` und eine `category` erklärt: `bdb-core`, `design-ui-ux`, `engineering-method`, `engineering-hardware`, `media-eventtech`, `library`.
554
267
 
555
- #### On macOS (LaunchAgent)
556
- ```bash
557
- bash ~/.gemini/config/skills/openwiki-skill/scripts/install_daemon.sh
558
- ```
268
+ **Persona Layer:** Die **Godmode** Skills sind spezialisierte Personas, die direkt den Build- und Shipping-Knoten des Dispatcher-Graphs zugeordnet sind:
559
269
 
560
- #### On Windows (Task Scheduler)
561
- ```powershell
562
- powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.gemini\config\skills\openwiki-skill\scripts\install_daemon.ps1"
563
- ```
564
-
565
- #### Für alle Plattformen: Projekte registrieren & überwachen
566
- **Projekte registrieren:** Fügen Sie Workspace-Pfade zu Ihrer Konfigurationsdatei unter `~/.openwiki/projects.json` hinzu:
567
- ```json
568
- {
569
- "projects": [
570
- "~/dev/bdb-dev/aos",
571
- "~/Projects/your-active-project"
572
- ],
573
- "interval_seconds": 3600
574
- }
575
- ```
270
+ | Godmode | Besitzt | Zugeordnet zu |
271
+ |---|---|---|
272
+ | `godmode-engineering` | Domain-Driven Design, Clean Architecture, striktes TypeScript/Python, systematisches Debugging, Datenbankbest Practices. | **Engineering** Knoten |
273
+ | `godmode-ui-ux` | Anti-Slop Frontend Prinzipien, DTCG Design Tokens, Motion Dynamik, Barrierefreiheit (WCAG), hochwertigen Geschmack. | **UI_UX** Knoten |
274
+ | `godmode-shipping` | Pre-Launch Checks, automatisierte Quality Gates, sichere Rollback-Prozeduren, Go-Gate Durchsetzung. | **Shipping** Knoten |
275
+ | `godmode-eventtech` | Show Control, Signalfluss, DMX Lighting, TouchDesigner Netzwerke, Resolume Media Server, Live-Event Hardware. | **Media_EventTech** Knoten |
276
+ | `godmode-3d-creation` | MCP-first 3D Generierung, Mesh Rekonstruktion, parametrisches CAD, räumliche Modellierung. | Optionaler Spezialist |
277
+ | `godmode-media-creation` | Video Produktion, Timeline Assembly, Motion Design Pipelines, OpenMontage, Remotion. | Optionaler Spezialist |
278
+ | `godmode-hardware-pcb` | Elektrische Schemata, PCB Layout und Routing, KiCad ERC/DRC/DFM Gate, Gehäuse Co-Design, OpenSCAD. | Optionaler Spezialist |
279
+
280
+ **Einstiegspunkte & Navigation:**
281
+ - **`ask-tim`** — Skill Empfehlung nach Beschreibung
282
+ - **`bdbrainstorm`** und **`bdbmediastorm`** — Multi-Agent Ideation Sessions, die in einem ausführbaren Plan enden
283
+ - **`teamwork-preview`** — Prompt Crafting, Rollen-Delegation, Collaboration Setup
284
+ - **Grilling Familie** — `grill-me` (allgemeine Überprüfung), `grill-with-docs` (dokumentations-fundiert), `triage` (Priorisierung)
285
+ - **CI/CD & Generators** — `ci-pipeline`, `github-actions-generator`, `dockerfile-generator`, `makefile-generator`
286
+ - **Code Qualität** — `bdb-security-audit`, `systematic-debugging`, `silent-failure-hunter`, `bdbresilience`
287
+ - **Framework Spezialisten** — Vollständige Abdeckung von TypeScript, React, Next.js, Drizzle ORM, Prisma, Python, Go und mehr
288
+
289
+ Der vollständige Katalog mit Beschreibungen und Details: [docs/skills_table.md](docs/skills_table.md) (Hinweis: listet derzeit 164 von 213).
290
+
291
+ Die Bibliothek ist auch durch die `skills` CLI lesbar:
576
292
 
577
- **Ausführung überwachen:** Verfolgen Sie die aktiven Logs, um den Rebuild-Status der Hintergrund-Dokumentation zu prüfen:
578
293
  ```bash
579
- tail -f ~/.openwiki/daemon.log
294
+ npx skills add hybridlabor-api/aos
580
295
  ```
581
- </details>
582
296
 
583
297
  ---
584
298
 
585
- ## 🖥️ BDB AO — Agent Orchestrator: Parallele Multi-Agenten-Orchestrierung
299
+ ## MCP-Server
586
300
 
587
- [![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
588
- [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
589
- [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
590
- [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
301
+ [`mcp_config.json`](mcp_config.json) definiert <!-- count:mcps -->21<!-- /count --> Server, vom Installer aus `mcps/` gebaut oder gewärmt und in jedes Harness MCP-Konfiguration zusammengeführt. Jeder Server stellt Tools für eine spezifische Domäne bereit; jeder Harness sieht den gleichen Satz, wodurch per-Tool Inkompatibilität vermieden wird.
591
302
 
592
- **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.
303
+ **Creative Software Integrationen** (Primär- und Fallback-Paare für Redundanz):
304
+ - **Unreal Engine** — `bdb_unreal_mcp` (Web Remote Control API auf Port 30010), Skill: `bdb-unreal-mcp`
305
+ - **Rhino 3D & Grasshopper** — `bdb_rhino_mcp` (McNeel's Yak Router) + `bdb_rhino_mcp_fallback` (GOLEM 3D, 105 Tools), Skill: `bdb-rhino-mcp`
306
+ - **DaVinci Resolve** — `bdb_davinci_mcp` (Workspace Scripts, 162 Tools) + `bdb_davinci_mcp_studio` (Node.js für Studio) + `bdb_davinci_mcp_fallback`, Skill: `bdb-davinci-mcp`
307
+ - **Blender** — `bdb_blender_mcp` (Socket Integration) + `bdb_blender_mcp_fallback`, Skill: `bdb-blender-mcp`
308
+ - **After Effects** — `bdb_after_effects_mcp` + `bdb_after_effects_mcp_fallback`, Skill: `bdb-after-effects-mcp`
309
+ - **TouchDesigner** — `bdb_touchdesigner_mcp` (MindDesigner Bridge auf Port 9980) + `bdb_touchdesigner_mcp_fallback`, Skill: `bdb-touchdesigner-mcp`
310
+ - **Zusätzliche:** grandMA3 (OSC/UDP auf Port 8000), Resolume (REST API auf Port 8080), Vectorworks (semantisches RAG auf Port 8765), Adobe UXP Bridge, Open Design
593
311
 
594
- > [!NOTE]
595
- > 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.
312
+ **OS Steuerung & System Automation:**
313
+ - **macOS/Linux** — `zavora_computer_use` (native Rust NAPI Binary, keine Runtime Compile), Skill: `bdb-computer-use-mcp`
314
+ - **Windows** — `bdb_windows_computer_use` (Win32 / COM / UIAutomation, lokales OCR mit Tesseract)
596
315
 
597
- ```mermaid
598
- flowchart TD
599
- A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
600
- B --> C[Agent Session 1: Feature Build]
601
- B --> D[Agent Session 2: Refactoring]
602
- B --> E[Agent Session N: Test & Verification]
603
- C --> F[Live Terminal Control & Process Monitor]
604
- D --> F
605
- E --> F
606
- F --> G[Automatic CI/CD Feedback Loops]
607
- G --> H[PR Review & Merge Routing]
608
- H --> I[Central Git Repository]
609
- ```
610
-
611
- <details>
612
- <summary><strong>⚙️ Architektur & Worktree-Orchestrierung</strong></summary>
316
+ **Memory, Delegation & Infrastruktur:**
317
+ - **memB** — `memb_mcp` (lokales offline Vektor Memory, SQLite + ONNX Model)
318
+ - **deja** — lokale Transkript-Indexierung (Geheimnisse bereinigt)
319
+ - **mcsc** — Multi-Harness Task Delegation
320
+ - **GitHub** — native MCP Tools für Issues, PRs, Workflows
321
+ - **Chrome DevTools** — Browser Automation & Debugging
322
+ - **RemoteOS** — Multi-Cloud Execution Gateway mit 4-Augen-Genehmigungssystem
613
323
 
614
- - **Git-Worktree-Isolation:** Instanziiert dedizierte, saubere Arbeitsbäume für jede Subagenten-Sitzung, was die Beschädigung von Dateizuständen und Lockfile-Kollisionen bei gleichzeitigen Bearbeitungen verhindert.
615
- - **Desktop Meta-Harness:** Koordiniert Multi-Workspace-Konfigurationen, Umgebungsvariablen und lokale Serverports über gleichzeitig laufende Entwicklungsumgebungen hinweg.
616
- - **Parallele Agenten-Ausführung:** Startet autonome Agenten, die gleichzeitig an getrennten Modulen, Features oder Bugfixes arbeiten, ohne den primären Workspace-Branch zu stören.
617
- </details>
324
+ ---
618
325
 
619
- <details>
620
- <summary><strong>🔬 Technische Spezifikationen & Automatisiertes Routing</strong></summary>
326
+ ## Optionale Module
621
327
 
622
- - **Live-Terminal-Kontrolle:** Erfasst stdout/stderr-Streams von Subagenten mit aktiver Prozessüberwachung, Sitzungslebenszyklus-Steuerung und Echtzeit-Statusberichten.
623
- - **Automatische CI/CD-Feedback-Schleifen:** Überwacht Testausgaben und Build-Aufgaben und leitet Fehler-Traces direkt in den Kontext des ausführenden Subagenten zur sofortigen Reparatur zurück.
624
- - **PR-Review-Routing:** Verpackt abgeschlossene Features, führt automatisierte Sicherheits- und Code-Health-Checks durch und leitet generierte Pull Requests zur menschlichen Überprüfung oder zum automatisierten Mergen weiter.
625
- </details>
328
+ Das Installationsprogramm bietet sie zur Auswahl an, und Quick Update hält sie aktuell. Alle sind optional; AOS funktioniert standalone ohne eines von ihnen.
626
329
 
627
- <details>
628
- <summary><strong>🔌 Plattform-Support, Unterstützte Harnesses & Direkter Repository-Link</strong></summary>
330
+ ### memB — Lokaler Vektor-Speicher
629
331
 
630
- - **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`).
631
- - **Unterstützte Agenten-Harnesses:**
632
- - **Google Antigravity / AGY CLI**
633
- - **Claude Desktop & Claude Code**
634
- - **Cursor & Windsurf**
635
- - **Roo Code & Cline**
636
- - **ChatGPT Codex / Codex CLI**
637
- - **Aider & VS Code**
638
- - **Direktes Repository:** Greifen Sie auf den Orchestrator unter [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator) zu.
332
+ `@hybridlabor-api/memb`: offline, lokales Vektor-Memory mit einem MCP-Server, WebUI auf Port 8088 und ein Ambient-Hook, der relevante Memories in Claude Code Sessions einfügt. Skill: `memb-skill`, `memb-ingest`, `bdb-memb-mcp`.
639
333
 
640
- ```bash
641
- git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
642
- ```
643
- </details>
334
+ ### deja — Transkript-Indexierung
644
335
 
645
- ---
336
+ `@vshulcz/deja-vu`: indiziert deine Agent-Transkripte lokal (Geheimnisse bereinigt), mit `deja fix` bei einem Fehler, `deja wip` zum Fortsetzen, `deja search` für vergangene Sessions. Mit memB installiert. Skill: `deja-memory`.
646
337
 
647
- ## 🧿 BDB Synapse: 3D Codebase-Visualisierung & Agenten-Sitzungs-Replay
338
+ ### OpenWiki — Lebende Dokumentation
648
339
 
649
- [![Repo](https://img.shields.io/badge/repo-bdb--synapse-blue.svg)](https://github.com/hybridlabor-api/bdb-synapse)
650
- [![3D Engine](https://img.shields.io/badge/3D-Three.js%20%7C%20WebGL-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-synapse)
651
- [![Go](https://img.shields.io/badge/Go-1.22+-00ADD8.svg)](https://github.com/hybridlabor-api/bdb-synapse)
652
- [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/hybridlabor-api/bdb-synapse/blob/main/LICENSE)
340
+ `openwiki` CLI: erzeugt und aktualisiert ein fundiertes Wiki eines Codebase mit Visualizer auf Port 4321 und einem Background-Daemon. Skill: `openwiki-skill`. Dieses Repos Wiki: [.openwiki/](.openwiki/quickstart.md).
653
341
 
654
- **BDB Synapse** rendert Ihr Repository als eine interaktive **3D-Code-Stadt** und spielt Sitzungen von Coding-Agenten als Lichtspuren ab, die sich hindurchbewegen — und zeigt so, welche Dateien gelesen oder bearbeitet wurden und wo Reibung auftrat. Ein einziges Go-Binary, komplett lokal, null Telemetrie.
342
+ ### Synapse — 3D-Code-Stadt
655
343
 
656
- Inspiriert von und geforkt aus [cosmtrek/mindwalk](https://github.com/cosmtrek/mindwalk) (MIT-Lizenz).
344
+ `@hybridlabor-api/bdb-synapse`: rendert ein Repository als 3D-Code-Stadt und spielt Agent-Sessions als Lichtspuren ab. Skill: `synapse-integration-skill`.
657
345
 
658
346
  ```mermaid
659
347
  flowchart LR
@@ -665,39 +353,27 @@ flowchart LR
665
353
  G --> H[Interactive 3D Code City]
666
354
  ```
667
355
 
668
- ### Unterstützte Agenten
669
-
670
- | Agent | Log-Quelle | Status |
671
- |-------|-----------|--------|
672
- | **Claude Code** | `~/.claude/projects/` | ✅ Nativ |
673
- | **Codex CLI** | `~/.codex/sessions/` | ✅ Nativ |
674
- | **Pi Agent** | `~/.pi/agent/sessions/` | ✅ Nativ |
675
- | **Antigravity (agy)** | `~/.gemini/antigravity-cli/brain/` | ✅ BDB Extension |
356
+ ### AO — Agent-Orchestrator
676
357
 
677
- ### Hauptmerkmale
678
- - **Tree- & Terrain-Ansichten:** Repository als radialer Baum oder Treemap — das Leuchten ist proportional dazu, wie tiefgreifend eine Datei bearbeitet wurde.
679
- - **Berührungszustände:** Gesehen (moosgrün), Gelesen (mondlichtblau), Bearbeitet (warmes Bernstein), Unbesucht (dunkel).
680
- - **Playback-Deck:** Spulen oder spielen Sie die Sitzung über ein geclustertes Histogramm ab. Beobachtungen bleiben kühl, Mutationen leuchten warm.
681
- - **Agenten-Linsen:** Wenn eine Sitzung Subagenten gestartet hat, wählen Sie eine Linse, um die Spur eines beliebigen Subagenten auf derselben Karte abzuspielen.
682
- - **Sitzungs-Evaluierung:** Bitten Sie eine lokale Agenten-CLI, den Verlauf der Sitzung anhand von Kriterien zu beurteilen, die aus Ihrer eigenen Anfrage abgeleitet wurden.
358
+ `@hybridlabor-api/bdb-agent-orchestrator`: parallele Agents in Git Worktrees mit Live Terminal Steuerung und automatisierten CI/CD Feedback Loops. Skill: `agent-orchestrator`.
683
359
 
684
- ```bash
685
- synapse # alle Agenten-Verzeichnisse scannen, Browser öffnen
686
- synapse open <session.jsonl> # eine spezifische Sitzung abspielen
687
- synapse map <repo> # eine Repository-Karte rendern, keine Sitzung nötig
360
+ ```mermaid
361
+ flowchart TD
362
+ A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
363
+ B --> C[Agent Session 1: Feature Build]
364
+ B --> D[Agent Session 2: Refactoring]
365
+ B --> E[Agent Session N: Test & Verification]
366
+ C --> F[Live Terminal Control & Process Monitor]
367
+ D --> F
368
+ E --> F
369
+ F --> G[Automatic CI/CD Feedback Loops]
370
+ G --> H[PR Review & Merge Routing]
371
+ H --> I[Central Git Repository]
688
372
  ```
689
373
 
690
- ---
374
+ ### Creator-Erweiterung — Medien & 3D
691
375
 
692
- ## 🎨 BDB Creator Extension: Heavy-Lifting Media & 3D Compute Pipeline
693
-
694
- [![Repo](https://img.shields.io/badge/repo-bdb--dev--creator--extension-blue.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
695
- [![compute](https://img.shields.io/badge/compute-CUDA%20%2F%20ML-orange.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
696
- [![3D Engine](https://img.shields.io/badge/3D-TRELLIS%20%7C%20TripoSR-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
697
- [![ComfyUI](https://img.shields.io/badge/ComfyUI-FLUX%20%7C%20SDXL%20%7C%20Wan2.1-red.svg)](https://github.com/hybridlabor-api/bdb-dev-creator-extension)
698
- [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
699
-
700
- **BDB Creator Extension** (`bdb-dev-creator-extension`) ist die leistungsstarke Media-Compute-Pipeline, die entwickelt wurde, um das Kern-Agent-Skills-Paket schnell, leichtgewichtig und responsiv (<25MB) zu halten. Sie kapselt neuronale CUDA/ML-Netzwerke, 3D-Mesh-Synthese, parametrische CAD-Generierung, automatisierte Videobearbeitung und lokale ComfyUI-Rendering-Engines.
376
+ `@hybridlabor-api/bdb-dev-creator-extension`: ComfyUI MCP Fähigkeiten (FLUX, SDXL), Image-to-3D (TripoSR, TRELLIS) und automatisierte Video Production (OpenMontage, Remotion). Skill: `bdb-dev-creator-extension`.
701
377
 
702
378
  ```mermaid
703
379
  flowchart LR
@@ -706,181 +382,76 @@ flowchart LR
706
382
  B --> D[Cinema Video Suite]
707
383
  B --> E[Local ComfyUI MCP Engine]
708
384
  C --> C1[TRELLIS: High-Fidelity 3D]
709
- C --> C2[TripoSR: Fast Mesh <0.5s]
385
+ C --> C2[TripoSR: Fast Mesh]
710
386
  C --> C3[CadQuery: Text-to-CAD]
711
387
  D --> D1[OpenMontage AI Director]
712
388
  D --> D2[Remotion Video-Shotcraft]
713
- D --> D3[Palmier Pro NLE MCP Server]
714
389
  E --> E1[FLUX.1 Image Gen]
715
390
  E --> E2[SDXL Pipeline]
716
- E --> E3[Wan2.1 Video Diffusion]
717
- C1 & C2 & C3 & D1 & D2 & D3 & E1 & E2 & E3 --> F[Rendered Media & Spatial Assets]
391
+ C1 & C2 & C3 & D1 & D2 & E1 & E2 --> F[Rendered Media & Spatial Assets]
718
392
  ```
719
393
 
720
- <details>
721
- <summary><strong>🔷 3D Generation Suite (`engines/3d/`)</strong></summary>
722
-
723
- - **Microsoft TRELLIS:** Hochpräzise Bild-zu-3D-Asset-Generierung, die texturierte 3D-Meshes und NeRF/Gaussian-Splat-Darstellungen erzeugt.
724
- - **Stability AI TripoSR:** Ultraschnelle Einzelbild-zu-3D-Mesh-Generierung (unter 0,5s) für schnelles räumliches Prototyping.
725
- - **CadQuery Parametric Text-to-CAD:** Generiert präzise Ingenieursmodelle und architektonische Geometrie in den Formaten STEP, STL und URDF.
726
- </details>
727
-
728
- <details>
729
- <summary><strong>🎬 Cinema Video Suite (`engines/video/`)</strong></summary>
394
+ ### Hardware & PCB — Elektrische Konstruktion
730
395
 
731
- - **OpenMontage AI Orchestrator:** Automatisches Video-Storytelling, Script-to-Timeline-Montage und Shot-Sequenzierung.
732
- - **Remotion Video-Shotcraft:** Über 100 programmierbare Video-Komponenten und Motion-Graphics-Vorlagen auf Kino-Niveau, erstellt mit React.
733
- - **Palmier Pro NLE MCP Server:** Echtzeit-HTTP-MCP-Brücke (`http://127.0.0.1:19789/mcp`), die native, nicht-lineare macOS-Videobearbeitungsfunktionen verfügbar macht.
734
- </details>
396
+ `@hybridlabor-api/bdb-hardware-pcb`: KiCad und OpenSCAD Design Module, angetrieben durch `godmode-hardware-pcb` Skill. Stellt ERC/DRC Gate, Gerber Sign-Off und parametrisches Gehäuse-Design bereit. Skills: `godmode-hardware-pcb`, `bdb-hardware-pcb`.
735
397
 
736
- <details>
737
- <summary><strong>🎨 Local ComfyUI MCP Engine & Direct Repository Link (`mcps/comfyui-mcp/`)</strong></summary>
738
-
739
- - **Model Context Protocol Integration:** Macht lokale ComfyUI-Workflows direkt als ausführbare Tools für KI-Agenten über MCP verfügbar.
740
- - **Unterstützte Generative Modelle:**
741
- - **FLUX.1:** Hochauflösende Bildsynthese und Prompt-Treue.
742
- - **SDXL:** Latente Diffusions-Workflow-Kontrolle mit benutzerdefinierten LoRAs und ControlNets.
743
- - **Wan2.1:** Generative Video-Diffusionsmodelle zur Erstellung von Clips mit hoher Bildrate.
744
- - **Direktes Repository:** Greifen Sie auf die Extension-Suite unter [github.com/hybridlabor-api/bdb-dev-creator-extension](https://github.com/hybridlabor-api/bdb-dev-creator-extension) zu.
745
-
746
- ```bash
747
- git clone https://github.com/hybridlabor-api/bdb-dev-creator-extension.git
748
- ```
749
- </details>
750
-
751
- <details>
752
- <summary><strong>🌍 BDB OS Remote Gateway & Thin-Client (`mcps/bdb-os-remote/`)</strong></summary>
753
-
754
- - **Zero-Trust SSE Transport:** Führen Sie Claude Desktop auf Ihrem Laptop aus, während Tools nativ auf Ihrer stationären Workstation über einen sicheren Tailscale-Tunnel ausgeführt werden.
755
- - **Asymmetrische Topologie:** Installiert `heimdall-token-saver` lokal auf Ihrem Laptop, um Tokens *vor* dem LLM-Aufruf zu komprimieren, während `memB`, `synapse` und Dateioperationen zur Workstation geroutet werden.
756
- - **Offline Clone-Tool:** Ein-Klick-Projektarchive, nahtlos über Tailscale gestreamt, ohne schweres `node_modules`.
757
- - **Direktes Repository:** Zugriff auf das Gateway unter [github.com/hybridlabor-api/bdb-os-remote](https://github.com/hybridlabor-api/bdb-os-remote) oder Installation via NPX:
758
-
759
- ```bash
760
- npx @hybridlabor-api/bdb-os-remote installer
398
+ ```mermaid
399
+ flowchart LR
400
+ A[Agent] -->|MCP| B[kicad-mcp-server]
401
+ A -->|MCP| C[openscad-mcp-server]
402
+ B --> D[Schematic Capture & ERC]
403
+ B --> E[PCB Layout & Routing]
404
+ B --> F[DRC / DFM / Gerber Sign-Off]
405
+ C --> G[Parametric Enclosure]
406
+ D & E & F & G --> H[Fabrication-Ready Output]
761
407
  ```
762
- </details>
763
-
764
-
765
- ## 🧠 memB: Eigenes Semantisches Gedächtnis (v4.0.0)
766
-
767
- BDB OS führt ein vollständig integriertes, lokales Offline-First Semantisches Gedächtnis auf Basis von **memB** ein. Es bietet Zero-Compute-Kontext für SLMs und eine AI-First Flat-File-Vault-Architektur.
768
-
769
- <details>
770
- <summary><strong>⚙️ Wie das Ökosystem funktioniert (Skills, Vaults & Obsidian)</strong></summary>
771
-
772
- ### 1. Ingestion via the `/memb-ingest` Skill
773
- Das Ökosystem enthält einen tief integrierten Skill (`/memb-ingest`). Wenn ein Agent diesen ausführt, scannt das Skript `memb_ingest.py` rekursiv Ihr Projekt (und liest `.openwiki`, `AGENTS.md`, Transkripte und Architekturdateien).
774
- * **Offline Vector Embeddings:** Es bündelt ein vorquantisiertes 30MB `all-MiniLM-L6-v2` ONNX Modell, um diese Erkenntnisse zu chunking und nativ in einem schnellen SQLite-Vektorspeicher (`~/.MemBDB/memb.db`)zu speichern, ganz ohne externe APIs aufzurufen.
775
-
776
- ### 2. Autonomous AI-First Vault Generation
777
- Sobald die Ingestion abgeschlossen ist, generiert memB nativ einen **physical Markdown Vault** (`~/.MemBDB/memB_Vault`) der um eine strenge radiale "God Mode"-Topologie strukturiert ist:
778
- * **Zero-Compute Context:** Ein universelles `AGENTS.md` und ein übergeordnetes `God_Mode.md` werden im Hauptverzeichnis abgelegt. Kleine 30MB lokale Inferenzmodelle können sich sofort makroskopisch orientieren, indem sie diese physischen Dateien lesen, ohne Kontext-Token für komplexe Datenbankaufrufe aufzuwenden.
779
- * **Micro-Targeted RAG:** Für die präzise Ausführung fragen die kleinen LLMs die Vektor-DB ab, um genau die 3-5 benötigten Unterdateien abzurufen.
780
-
781
- ### 3. The Obsidian Visualization Plugin
782
- memB beinhaltet ein natives **Obsidian Plugin** (`obsidian-memb-plugin`) das als visuelles UI über Ihrem physischen Vault fungiert.
783
- * **Top-Down Radial Tree:** Es liest das generierte `memB_Vault` und bildet es visuell über die Graph-Ansicht von Obsidian ab.
784
- * Durch die konsequente Verwendung von gerichteten Parent-to-Child-Links (z.B. God Mode -> Projekte -> Kategorie -> Neuron) entfaltet sich der Obsidian-Graph nach außen wie eine Blume, was das "Schwarzes Loch"-Kontext-Clustering unstrukturierter Graph-Datenbanken vollständig verhindert.
785
-
786
- ### 4. Data Sovereignty & Security
787
- * **Zero Telemetry:** Absolute Datensouveränität ohne Remote-Tracking.
788
- * **Secret Filtration:** Blockiert Passwörter, rohe API-Schlüssel und Verbindungszeichenfolgen vor der Injektion.
789
- </details>
790
-
791
- ---
792
-
793
- ## ⚡ Heimdall Token Saver: CLI Kontext-Komprimierung (v4.0.0)
794
408
 
795
- ![Heimdall Savings Graph](assets/bdb_savings_graph_sketch.jpg)
409
+ ### Heimdall Token Saver — CLI-Ausgabenkompression
796
410
 
797
- **Heimdall Token Saver** ist eine ultraschnelle Kontext-Komprimierungsengine, die entwickelt wurde, um die Kontextfenster-Nutzung bei CLI-Tool-Ausgaben in KI-Agenten-Workflows drastisch zu reduzieren.
411
+ `@hybridlabor-api/heimdall-token-saver`: komprimiert wiederholte CLI-Ausgabe über Ambient Hooks auf jedem Harness. Reduziert Token-Overhead bei großen Projekten. Skill: `token-saver-config`.
798
412
 
799
- <details>
800
- <summary><strong>⚙️ Zweck & Leistung</strong></summary>
413
+ ![Token savings with Heimdall Token Saver](assets/bdb_savings_graph_sketch.jpg)
801
414
 
802
- - **Automatische CLI-Ausgaben-Kontext-Komprimierung:** Reduziert den Token-Overhead um **60–99%** bei umfangreichen CLI-Tool-Ausgaben, ohne das Verständnis des Agenten zu beeinträchtigen.
803
- - **Garantie für null Informationsverlust:** Bewahrt alle Fehlermeldungen, fehlgeschlagenen Assertions, Stack-Traces, Exit-Codes und handlungsorientierten Debugging-Kontext, während redundante Leerzeichen, Fortschrittsanzeigen und wiederholende Logs entfernt werden.
804
- - **Automatische Geheimnis-Schwärzung:** Erkennt und schwärzt automatisch Passwörter, Token, API-Schlüssel und sensible Umgebungsvariablen, bevor die Befehlsausgabe in die Kontextfenster des Agenten eingefügt wird.
805
- </details>
806
-
807
- <details>
808
- <summary><strong>🔬 Technische Spezifikationen & Prozessoren</strong></summary>
809
-
810
- - **36 Specialized Processors:** Beinhaltet maßgeschneiderte Komprimierungsregeln für:
811
- - **Versionskontrolle & Entwicklertools:** `git` (status, diff, log, branch)
812
- - **Testing-Frameworks:** `pytest`, `jest`, `cargo test`, `vitest`, `go test`
813
- - **Container & Infrastruktur:** `docker`, `kubectl`, `terraform`
814
- - **Paketmanager & Build-Systeme:** `npm`, `yarn`, `pnpm`, `pip`, `cargo`, `go` Paketlisten und Build-Ausgaben
815
- - **Preservation Rules:** Garantiert, dass Zeilennummern, Fehlerspuren und genaue Fehlerorte zu 100% intakt bleiben für eine sofortige Fehlerursachendiagnose.
816
- </details>
817
-
818
- <details>
819
- <summary><strong>🔌 Agenten-Integration & Hooks</strong></summary>
820
-
821
- - **Automatisierte Hook-Installation:** Nahtlos konfiguriert und installiert über `installer.js`.
822
- - **Unterstützte Harnesses:**
823
- - **Claude Code:** Integriert über `PreToolUse` hook.
824
- - **Google Antigravity CLI:** Integriert über `AfterTool` hook.
825
-
826
- ### 📊 CLI-Diagnose & Tooling
827
- Sie können Diagnose- und Benchmarking-Befehle direkt in Ihrem Terminal ausführen:
828
- - **Version prüfen:** `token-saver version`
829
- - **Einsparungen & Nutzungsstatistiken anzeigen:** `token-saver stats`
830
- - **Befehlseinsparungen benchmarken:** `token-saver benchmark '<command>'`
831
- </details>
415
+ *Illustrative Skizze aus v3.x. Die Prozentwerte sind Schätzungen des Projekts, keine für dieses README durchgeführten Messungen.*
832
416
 
833
417
  ---
834
418
 
835
- ## 🛠️ Installation
836
-
837
- ### 🆚 Welche Version sollte ich verwenden?
838
-
839
- - **`@latest`** — der Stable-Kanal. Interaktive MCP-Auswahl-UI, aktive Hintergrund-Daemons (`memB`, `OpenWiki`), vollständige Skill-Bibliothek.
840
- - **`@next`** — ein gelegentlich genutzter Staging-Kanal für größere Änderungen (wie die v4.0.0 AOS-Umbenennung), bevor sie zu `@latest` befördert werden (welches CI bei jedem release-please-Release automatisch veröffentlicht). Kein dauerhaft paralleler Kanal.
841
- - **`bdb-antigravity-skills@legacy`** — das ursprüngliche Antigravity-only-Paket vor Einführung des Dispatchers, erhalten für Nutzer, die noch davon abhängen.
842
-
843
- Jeder Durchlauf bietet Ihnen dieselbe Wahl: **Backup & Overwrite** (bestehende Konfigurationen sicher ersetzen) oder **Merge** (neue Skills/Configs/MCP-Pfade in Ihre bestehenden integrieren).
844
-
845
- ### Fragen Sie Ihren KI-Agenten (Am einfachsten)
846
- Sagen Sie Ihrem Assistenten: *"Führe `npx -y @hybridlabor-api/aos@latest` aus, um das Skills-Paket zu installieren und die lokalen MCP-Server zu konfigurieren."*
419
+ ## Aktualisierung
847
420
 
848
- ### Kommandozeile
421
+ Führe den gleichen Befehl erneut aus. Das Installationsprogramm sieht die installierte Version, bietet **Quick Update** an und aktualisiert Skills, Hooks, Templates und Module:
849
422
 
850
423
  ```bash
851
- # Stable
852
424
  npx -y @hybridlabor-api/aos@latest
853
-
854
- # Migration Staging-Kanal (v4.0.0 AOS)
855
- # Hinweis: @next wird nur gelegentlich für aktive Migrationen verwendet, nicht als ständiger Kanal.
856
- npx -y @hybridlabor-api/aos@next
857
425
  ```
858
- *(Funktioniert auf Mac/Linux-Terminals sowie in der Windows PowerShell.)*
859
426
 
860
- ### Nicht-interaktiv / CI
427
+ Es gibt keinen `aos update` Unterbefehl. Wenn du einmal `npm i -g @hybridlabor-api/aos` ausgeführt hast, führt ein einfaches `aos` auf deinem PATH diese eingefrorene Kopie und ihre Version aus, nicht die neueste; aktualisiere sie entweder (`npm i -g @hybridlabor-api/aos@latest`) oder entferne sie und bleibe bei `npx`. Das Installationsprogramm gibt selbst den Update-Befehl aus, wenn eine neuere Version existiert; die `bdb-updater` Skill umschließt die gleiche Überprüfung zur Verwendung innerhalb einer Session.
861
428
 
862
- Wählen Sie Ziele ohne das Menü über `--platforms=<n[,n]>` — `0` Universal, `1` Antigravity, `2` Claude Desktop/Code, `3` Cursor, `5` Codex, `6` Windsurf, `7` Roo/Cline, `8` Aider:
429
+ ## Deinstallation
863
430
 
864
431
  ```bash
865
- npx -y @hybridlabor-api/aos -y --platforms=2
432
+ aos-uninstall # removes what AOS installed; memory, wikis and credentials stay
433
+ aos-uninstall --purge # also removes ~/.MemBDB, ~/.openwiki, ~/.synapse, ~/.memb
434
+ aos-uninstall --dry-run # list everything, delete nothing
866
435
  ```
867
436
 
868
- ### Local Project Harness
437
+ Das Deinstallationsprogramm arbeitet aus dem Installationsmanifest: Eine Datei, die immer noch den Hash entspricht, den AOS geschrieben hat, wird entfernt, eine Datei, die du bearbeitet hast, wird stattdessen gesichert, eine Datei, die AOS nie geschrieben hat, wird nicht berührt. Die gleiche Aktion ist im Installer-Menü.
869
438
 
870
- Fügen Sie nur den Dispatcher-Contract (`.agents/`, die Gate-Hooks, den `/startcycle-graph` Workflow) in ein einzelnes Projekt ein, anstatt global in `$HOME` zu installieren:
439
+ ---
871
440
 
872
- ```bash
873
- npx -y @hybridlabor-api/aos --project-harness
874
- ```
441
+ ## Beitragen
875
442
 
876
- ### Aus dem Quellcode (Contributing)
443
+ - [AGENTS.md](AGENTS.md) ist die einzige Quelle der Regeln für jeden Harness: der Skill-Vertrag, Kategorie-Routing, das Release-Gate, Conventional Commits.
444
+ - Ein Skill ist ein Verzeichnis mit `SKILL.md`; das Frontmatter benötigt `name` (gleich dem Verzeichnisnamen), `description` und `category`. `npm run validate` erzwingt den Vertrag, ebenso CI bei jedem Push.
445
+ - `npm test` führt den Validator-Selbsttest, die Plugin-Manifest-Prüfung und das Installationsprogramm-, Store-, Doctor- und Cross-Harness-Hook-Tests durch.
446
+ - `.claude-plugin/plugin.json` und `marketplace.json` werden von `npm run plugin:build` generiert und durch `npm run plugin:check` überprüft. Sie existieren heute; der Claude Code Marketplace-Installationspfad wird noch finalisiert, daher bleibt das obige Installationsprogramm der unterstützte Weg.
447
+ - Releases werden von Release-Please aus Conventional Commits geschnitten; kein manuelles Anheben der Version in `package.json`. `feat:` bedeutet einen Minor-Sprung.
448
+ - Skills, die von anderen Projekten abgeleitet sind, notieren `source:` im Frontmatter und einen Eintrag in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
877
449
 
878
- ```bash
879
- git clone https://github.com/hybridlabor-api/aos.git
880
- cd aos
881
- npm install
882
- node installer.js
883
- ```
450
+ ## Links
884
451
 
885
- ---
886
- *Elevate your agency. Dominate the workflow.*
452
+ - Paket: [npmjs.com/package/@hybridlabor-api/aos](https://www.npmjs.com/package/@hybridlabor-api/aos)
453
+ - Quellcode und Issues: [github.com/hybridlabor-api/aos](https://github.com/hybridlabor-api/aos) · [issues](https://github.com/hybridlabor-api/aos/issues)
454
+ - [CHANGELOG.md](CHANGELOG.md) · [docs/skills_table.md](docs/skills_table.md)
455
+ - Schwester-Repos: [bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator) · [bdb-synapse](https://github.com/hybridlabor-api/bdb-synapse) · [bdb-dev-creator-extension](https://github.com/hybridlabor-api/bdb-dev-creator-extension) · [bdb-hardware-pcb](https://github.com/hybridlabor-api/bdb-hardware-pcb) · [bdb-os-remote](https://github.com/hybridlabor-api/bdb-os-remote)
456
+
457
+ License: [Apache-2.0](LICENSE).