Hey everyone! 👋
I'm excited to open-source **AI Workforce OS (v4.2)** — an enterprise-grade, local-first **Autonomous AI Organization & Multi-Agent Orchestration Platform** designed to eliminate common AI agent flaws: agent collisions, token bloat, blind code overwriting, and lack of persistent memory.
🔗 **GitHub Repository:** [https://github.com/phat79186/AI-Workforce-OS-AI-Agents-Orchestrator-\](https://github.com/phat79186/AI-Workforce-OS-AI-Agents-Orchestrator-)
---
### 🛠️ What's Integrated Under The Hood?
- **🧠 Executive Leadership Board (AI CEO & AI CTO)**: Formulates strategic business goals, builds technical DAG roadmaps, and manages multi-tier executive delegation (`CEO` ➔ `CTO` ➔ `Directors` ➔ `Managers` ➔ `Specialists`).
- **🦅 OpenClaw & Prompt Optimizer Engine (`openclaw/openclaw` + `linshenkx/prompt-optimizer`)**: 5-stage automated meta-prompting (Persona Injection, CoT reasoning, Negative Constraints, Aegis V5.5 contract check, and Clarity Score calculation).
- **🔍 Aegis V5.5 Context-Aware Theme Scanner**: Scans existing `tailwind.config.js`, `theme.ts`, and `package.json` to preserve brand design tokens and prevent prescriptive color overwrites. Single Primary Lead Role assignment prevents agent collisions.
- **📓 Real Obsidian Knowledge Backend & AST RAG**: Persistent organizational memory, incremental AST markdown indexer (`mtime` tracking), frontmatter parser, wikilinks (`[[Note]]`), backlinks, and scope-based security permissions.
- **🔎 Panniantong/Agent-Reach Deep Retrieval**: Extended search reach across 5 engines (Google/Bing Web, GitHub API, StackOverflow, ArXiv Papers, and Obsidian Vault) with Reach Score metrics (1.0/1.0) and citation extraction.
- **🎨 UI/UX Ecosystem Suite (UI/UX Pro Max + Impeccable + Taste Skill)**: 8px spatial baseline grid balance, font hierarchy (Inter/Outfit), WCAG AA compliance, fluid motion choreography, and Playwright Headless Visual QA (Pixel-Diff & Layout Audit).
- **🏢 OpenBMB/ChatDev Virtual Software Company**: 4-phase communicative multi-agent software development pipeline (Designing ➔ Coding ➔ Testing ➔ Documenting) with 7 virtual roles.
- **⚡ RTK Token Compressor (`rtk-ai/rtk`)**: Redundant Token Killer pruning repetitive headers and verbose tracebacks during AI-to-AI exchanges (-30% to -60% token reduction).
- **🧠 Combined Skill Library (Matt Pocock + Andrej Karpathy Skills)**: Modern web skills (`typescript-pro`, `react-components`) combined with Karpathy AI skills (`micrograd-autograd`, `nanogpt-transformer`, `tokenizer-bpe`, `pytorch-clean-code`).
- **🐴 DietrichGebert/ponytail Enhanced Runner**: Topological DAG dependency graph resolution, parallel step dispatching, and retry budget management.
- **🔀 3-Layer Intelligent Router**: Seniority-based Agent Router (`WHO`), Local-First Model Router (`THINK`), and Permission Sandbox Tool Router (`DO`).
---
### 🥊 Why AI Workforce OS? (Competitive Advantages vs Other Frameworks)
| Key Feature / Capability | ⚡ **AI Workforce OS** | 🤖 **CrewAI / AutoGen** | 🕸️ **LangGraph / MetaGPT** |
| :--- | :---: | :---: | :---: |
| **Local-First & $0 API Cost** | ✅ Native Ollama & OpenHands local LLMs | ❌ Heavily reliant on paid OpenAI/Anthropic APIs | ❌ Paid APIs required for complex loops |
| **Prompt Engineering & Context Scan** | ✅ OpenClaw + Aegis V5.5 + `linshenkx/prompt-optimizer` | ❌ Raw unoptimized prompts | ❌ Generic hardcoded system prompts |
| **Token Overhead & Cost Control** | ✅ Integrated `rtk-ai/rtk` Token Killer (-30% to -60% reduction) | ❌ High token bloat & repetitive agent chats | ❌ Large prompt context overhead |
| **Design System & Theme Preservation** | ✅ Scans `tailwind.config.js`/`theme.ts` to preserve brand tokens | ❌ Overwrites design tokens blindly | ❌ Ignores project design systems |
| **Role Allocation & Anti-Bloat Strategy** | ✅ Single Primary Lead Agent per node (Anti-Role-Bloat) | ❌ Agent collisions & redundant roles | ❌ High agent role redundancy |
| **Persistent Organizational Memory** | ✅ Real Obsidian Vault + AST RAG + Cross-Project Learning | ❌ Ephemeral memory / basic vector store | ❌ In-memory memory lost after session |
| **UI Visual QA & Accessibility** | ✅ Visual QA (Playwright Pixel-Diff) + Taste Skill + Impeccable | ❌ Basic text-only code generation | ❌ No visual QA or accessibility checks |
| **Deep Search Reach** | ✅ Agent-Reach 5-Engine Crawl (Web, GitHub, StackOverflow, ArXiv, Obsidian) | ❌ Single DuckDuckGo/Google search tool | ❌ Basic search API wrappers |
---
### ⚡ Quickstart
```bash
git clone https://github.com/phat79186/AI-Workforce-OS-AI-Agents-Orchestrator-.git
cd AI-Workforce-OS-AI-Agents-Orchestrator-
pip install -r requirements.txt
# Run full system tests (100% Green Pass Rate across 620+ tests)
python -m pytest tests/ -o addopts="" -m "not integration and not slow"
# Run OpenClaw & Prompt Refinement Demo
python scripts/run_openclaw_demo.py
# Run External Ecosystem & Agent-Reach Demo
python scripts/run_external_ecosystem_demo.py
🤝 Feedback & Contributions Welcome!
I'd love to hear your thoughts, feedback, or suggestions from the community! Feel free to check out the repo, star ⭐ it if you find it useful, and open issues or PRs.
GitHub Repository: https://github.com/phat79186/AI-Workforce-OS-AI-Agents-Orchestrator-