aios-core 2.1.0

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1.md

@@ -0,0 +1,439 @@
+# AIOS Framework - Livro de Ouro v2.1
+## The Complete Open-Source AI Orchestration System
+
+**Versão:** 2.1.0-post-5-sprints  
+**Status:** Living Document  
+**Data:** Março 2026 (as-if-implemented)  
+**Mantido Por:** AIOS Framework Team + Community
+
+---
+
+> **"Structure is Sacred. Tone is Flexible."**  
+> *— Fundamento filosófico do AIOS*
+
+---
+
+## 🎊 WHAT'S NEW IN v2.1
+
+**Released:** March 2026  
+**Status:** Production-ready  
+**Install:** `npx @allfluence/aios@latest init`
+
+### Major Features Delivered
+
+✅ **Installer Híbrido** - One-command setup with interactive wizard  
+✅ **Modular Architecture** - Clean domain separation (core/development/product/infrastructure)  
+✅ **Service Discovery** - 97+ Workers cataloged and searchable  
+✅ **Task-First Architecture** - Universal task format enables instant executor migration  
+✅ **Workers Open-Source** - Complete script library, community-driven  
+✅ **Quality Gates 3 Layers** - Local + PR + Human validation  
+✅ **Template Engine** - All document types automated  
+✅ **CodeRabbit Integration** - AI-powered code review (local + GitHub)
+
+### Breaking Changes from v2.0
+
+⚠️ **Business Model Update:**
+- Workers are now **open-source** (previously proprietary)
+- Clones remain **proprietary** (DNA Mental™)
+- Expansion Packs remain **proprietary**
+
+⚠️ **Installation Method:**
+- Old: Manual clone + configuration
+- New: `npx @allfluence/aios@latest init` (5 minutes)
+
+⚠️ **Project Structure:**
+- Old: Flat `.aios-core/` directory
+- New: Modular `core/development/product/infrastructure/`
+
+### Upgrade Path from v2.0
+
+```bash
+# Backup your current project
+$ cp -r .aios-core .aios-core.backup
+
+# Run migration script
+$ npx @allfluence/aios migrate v2.0-to-v2.1
+
+# Follow interactive prompts
+# Migration takes ~15 minutes
+```
+
+**Migration Guide:** [Complete migration documentation](#migration-guide)
+
+---
+
+## 📜 Nota sobre Open Source vs. Serviço
+
+Este documento descreve o **AIOS Framework v2.1** completo - a arquitetura, filosofia e capacidades após 5 sprints de desenvolvimento.
+
+### O Que Mudou em v2.1
+
+**IMPORTANTE: v2.1 alterou fundamentalmente o business model!**
+
+#### Open-Source v2.1 (Complete Framework)
+
+```yaml
+✅ 11 Agents (Creative + Analytical)
+   - Dex, Luna, Aria, Quinn, Zara, Kai, Sage, Felix, Nova, Uma, Dara
+   - Full system prompts included
+   - Customization templates provided
+
+✅ 97+ Workers (Deterministic Scripts)
+   - Config & Setup (12 workers)
+   - Data Transformation (23 workers)
+   - File Operations (18 workers)
+   - Integration & APIs (15 workers)
+   - Quality & Testing (11 workers)
+   - Build & Deploy (10 workers)
+   - Utilities (8 workers)
+
+✅ Humanos (Orchestration Primitives)
+   - Approval gates
+   - Strategic review
+   - Human-in-the-loop patterns
+
+✅ Service Discovery
+   - Worker catalog with search
+   - Task compatibility mapping
+   - Community contribution system
+
+✅ Task-First Architecture
+   - Universal task format (TASK-FORMAT-SPECIFICATION-V1.md)
+   - Instant executor migration
+   - Backward compatibility
+
+✅ Quality Gates (3 Layers)
+   - Layer 1: Local validation (pre-commit)
+   - Layer 2: PR automation (CI/CD)
+   - Layer 3: Human review (strategic)
+
+✅ Complete Orchestration
+   - Workflow engine
+   - Pattern library
+   - Best practices documentation
+```
+
+#### Proprietary (Service/Enterprise)
+
+```yaml
+❌ Clones (Cognitive Emulation via DNA Mental™)
+   - Pedro Valério (Systems Architecture)
+   - Brad Frost (Atomic Design)
+   - Marty Cagan (Product Discovery)
+   - Paul Graham (First Principles)
+   - [Future: 10+ expert clones]
+
+❌ Expansion Packs (Industry Expertise)
+   - Data Engineering (ETL pipelines, data quality)
+   - Finance & Banking (compliance, risk models)
+   - Healthcare (HIPAA, medical workflows)
+   - E-commerce (inventory, fulfillment)
+   - [Future: 20+ domain packs]
+
+❌ Team Features
+   - Shared memory across team members
+   - Collaborative workflows
+   - Team analytics & insights
+   - Centralized configuration
+
+❌ Enterprise Infrastructure
+   - Cloud scaling & orchestration
+   - Priority support (< 2h response)
+   - SLAs & uptime guarantees
+   - Advanced security & compliance
+```
+
+### Por Que Workers São Open-Source Agora?
+
+**Competitive Analysis:**
+
+| Feature | LangChain | CrewAI | AutoGen | **AIOS v2.1** |
+|---------|-----------|---------|---------|---------------|
+| Agents | ✅ Open | ✅ Open | ✅ Open | ✅ **Open (11)** |
+| Workers | ✅ Open | ✅ Open | ✅ Open | ✅ **Open (97+)** |
+| Orchestration | ✅ Open | ✅ Open | ✅ Open | ✅ **Open** |
+| Service Discovery | ⚠️ Basic | ⚠️ Basic | ❌ None | ✅ **Built-in** |
+| Task-First | ❌ None | ❌ None | ❌ None | ✅ **Unique** |
+| **Cognitive Clones** | ❌ None | ❌ None | ❌ None | 🔒 **Proprietary** ⭐ |
+| Quality Gates | ⚠️ Basic | ⚠️ Basic | ⚠️ Basic | ✅ **3 Layers** |
+
+**Strategic Rationale:**
+
+1. **Workers são Commodity**
+   - Any developer can write deterministic scripts
+   - Value is in discovery, not creation
+   - Community contributions improve quality
+
+2. **Clones são Singularidade**
+   - DNA Mental™ takes years to develop
+   - Cognitive architecture is unique IP
+   - Methodology codification is defensible moat
+
+3. **Maximum Adoption Strategy**
+   - Complete framework open = zero friction to start
+   - Developers test EVERYTHING locally
+   - Conversion happens when scaling (Clones + Team features)
+
+4. **Network Effects**
+   - More users → More contributors → Better Workers
+   - Better Workers → More use cases → More users
+   - Virtuous cycle
+
+**Bottom Line:**  
+AIOS v2.1 is the **most complete open-source AI orchestration framework**. We don't hide core functionality behind paywalls. We monetize exclusively through **Clones** (cognitive emulation) and **Expansion Packs** (industry expertise) - features that provide clear value and take years to build.
+
+**Analogia:** Linux é open source, mas Red Hat Enterprise Linux adiciona suporte, ferramentas e otimizações proprietárias. Ambos são Linux, mas o valor agregado varia. AIOS funciona igual.
+
+---
+
+## 📖 Como Usar Este Livro
+
+Este não é um documento para ser lido do início ao fim (embora você possa). É um **sistema de aprendizado em camadas** - cada uma construída para um propósito específico:
+
+- 🚀 **Layer 0: DISCOVERY** ← Você está aqui! Descubra seu caminho
+- 🎯 **Layer 1: UNDERSTANDING** - 5 essays que ensinam o modelo mental (75 min)
+- 🎨 **Layer 2: COMPONENT LIBRARY** - Catálogo completo de componentes
+- 📋 **Layer 3: USAGE GUIDE** - Como usar AIOS v2.1 no seu contexto
+- 📚 **Layer 4: COMPLETE REFERENCE** - Especificação técnica completa
+- 🔄 **META: EVOLUTION** - Como contribuir e evoluir o framework
+
+**A maioria das pessoas precisa apenas do Layer 1.** O resto existe para quando você precisar.
+
+---
+
+# 🚀 LAYER 0: DISCOVERY ROUTER
+
+## Bem-vindo ao AIOS v2.1 - Vamos Encontrar Seu Caminho
+
+**Tempo estimado:** 5 minutos  
+**Resultado:** Você será direcionado para o conteúdo EXATO que precisa
+
+---
+
+## 🎯 SELF-ASSESSMENT: Descubra Onde Você Está
+
+Responda estas 5 perguntas com HONESTIDADE (não há resposta certa ou errada - cada contexto é válido):
+
+### Pergunta 1: Qual Sua Relação com IA Agents Hoje?
+
+**A)** 🤷 **Explorador Curioso**  
+Nunca trabalhei com agents de forma estruturada. Uso Copilot/ChatGPT mas sem coordenação. Quero entender se AIOS faz sentido pra mim.
+
+**B)** 🏗️ **Builder Ativo**  
+Já trabalho com AI agents (Cursor, Copilot, custom agents). Tenho dores reais: falta de coordenação, sem quality gates, agentes sem personalidade. Busco solução sistemática.
+
+**C)** 🎓 **Framework Developer**  
+Sou desenvolvedor/arquiteto interessado em CONTRIBUIR com o AIOS ou criar ferramentas/extensões. Preciso entender arquitetura profunda.
+
+**D)** 👔 **Decision Maker**  
+Lidero time/empresa avaliando adoção do AIOS. Preciso entender ROI, riscos, prerequisites, esforço de implementação.
+
+**E)** 🔧 **Power User Atual**  
+Já uso AIOS mas busco domínio avançado: criar agents customizados, workflows complexos, ou migrar projeto brownfield.
+
+---
+
+### Pergunta 2: Qual Seu Contexto de Projeto?
+
+**A)** 🌱 **Greenfield (Projeto Novo)**  
+Vou começar projeto do zero. Posso desenhar arquitetura sem restrições de legado.
+
+**B)** 🏛️ **Brownfield (Projeto Existente)**  
+Tenho projeto em andamento. Preciso integrar AIOS incrementalmente sem reescrever tudo.
+
+**C)** 🎨 **Framework/Tooling**  
+Não tenho "projeto de produto" - meu foco é construir/melhorar o próprio AIOS ou ferramentas relacionadas.
+
+**D)** 🤔 **Ainda Não Sei**  
+Tô explorando. Talvez nem tenha projeto ainda - quero primeiro entender o que AIOS pode fazer.
+
+---
+
+### Pergunta 3: Quanto Tempo Você Tem AGORA?
+
+**A)** ⚡ **15-30 minutos** - Quick Win  
+Quero entender o essencial rapidamente e decidir se continuo depois.
+
+**B)** ⏰ **1-2 horas** - Deep Dive Inicial  
+Tenho tempo pra mergulho inicial completo. Quero sair com modelo mental formado.
+
+**C)** 📅 **Vários dias/semanas** - Mastery Path  
+Vou dedicar tempo sério pra dominar AIOS completamente. Me mostre o caminho completo.
+
+**D)** 🎯 **Preciso de algo específico** - Targeted Learning  
+Tenho uma dúvida/necessidade específica (ex: como usar Service Discovery? como funciona Task-First?). Não preciso de overview completo agora.
+
+---
+
+### Pergunta 4: Qual Seu Nível Técnico?
+
+**A)** 👨‍💼 **Non-Technical Leader**  
+Não codifico. Preciso entender conceitos, benefícios, trade-offs para decisões estratégicas.
+
+**B)** 💻 **Developer/Engineer**  
+Codifico profissionalmente. Entendo arquitetura de software, APIs, workflows. Quero implementar.
+
+**C)** 🏛️ **Architect/Tech Lead**  
+Desenho sistemas. Preciso entender arquitetura profunda, decisões de design, trade-offs técnicos.
+
+**D)** 📊 **Product/Agile Role**  
+Sou PO, PM, SM, Analyst. Meu foco é gestão de produto/processo usando AIOS para coordenar trabalho.
+
+---
+
+### Pergunta 5: Você Já Leu Algo Sobre AIOS Antes?
+
+**A)** 🆕 **Primeira Vez**  
+Zero contexto prévio. Comecei agora.
+
+**B)** 👀 **Já Vi Por Alto**  
+Já dei uma olhada rápida, vi o README, talvez algum doc. Mas não aprofundei.
+
+**C)** 📖 **Já Li Bastante**  
+Li docs, stories, decisions. Conheço conceitos principais mas quero consolidar/avançar.
+
+**D)** ⭐ **Sou Usuário v2.0**  
+Usei AIOS v2.0. Quero entender o que mudou em v2.1 e como migrar.
+
+---
+
+## 🧭 ROUTING: Seu Caminho Personalizado
+
+**Baseado nas suas respostas, você será direcionado para:**
+
+### 🎯 TRACK 1: QUICK START (15-30 min)
+**Melhor para:** Resposta A ou D na P1 + A na P3  
+**Você vai ler:**
+1. [What's New in v2.1](#whats-new-summary) (5 min)
+2. [Installation Quick Guide](#install-quick) (10 min)
+3. [First Steps](#first-steps) (10 min)
+4. **Próximo Passo:** Decida se quer continuar com Track 2
+
+---
+
+### 🚀 TRACK 2: DEEP DIVE INICIAL (1.5-2 horas)
+**Melhor para:** Resposta B na P1 + B na P3  
+**Você vai ler:**
+1. Layer 1 completo: [5 Essays](#layer-1-understanding) (75 min)
+2. [Quick Reference: Agents + Workers](#component-catalog) (20 min)
+3. [Getting Started: Complete Installation](#complete-install) (30 min)
+4. **Próximo Passo:** Implementar no seu projeto ou explorar Layer 2-3
+
+---
+
+### 🎓 TRACK 3: MASTERY PATH (Semanas)
+**Melhor para:** Resposta C ou E na P1 + C na P3  
+**Você vai seguir:**
+1. Layer 1: [Understanding Essays](#layer-1-understanding) (75 min)
+2. Layer 2: [Complete Component Library](#layer-2-component-library) (4-5 horas)
+3. Layer 3: [Complete Usage Guide](#layer-3-usage-guide) (3-4 horas)
+4. Layer 4: [Technical Reference](#layer-4-reference) (referência contínua)
+5. [Contribution Guide](#contribution-guide) - Comece a contribuir
+6. **Próximo Passo:** Criar agents customizados, workers, workflows complexos
+
+---
+
+### 📊 TRACK 4: DECISION MAKER PATH (30-45 min)
+**Melhor para:** Resposta D na P1 (qualquer tempo)  
+**Você vai ler:**
+1. [Executive Summary](#executive-summary) (10 min)
+2. [What's New in v2.1 - Business Impact](#business-impact) (10 min)
+3. [ROI Analysis](#roi-analysis) (10 min)
+4. [Migration Strategy](#migration-strategy) (10 min)
+5. **Próximo Passo:** Go/No-Go decision com base em dados
+
+---
+
+### 🎯 TRACK 5: TARGETED LEARNING (Variável)
+**Melhor para:** Resposta D na P3 (precisa de algo específico)  
+**Use o índice visual para ir direto ao tópico:**
+- [Como usar Service Discovery?](#service-discovery-guide)
+- [Como funciona Task-First Architecture?](#task-first-guide)
+- [Como migrar de v2.0 para v2.1?](#migration-guide)
+- [Como usar Quality Gates 3 Layers?](#quality-gates-guide)
+- [Como contribuir Workers?](#worker-contribution-guide)
+- [Ver índice completo](#indice-visual) ↓
+
+---
+
+### 🔄 TRACK 6: v2.0 UPGRADE PATH (45-60 min)
+**Melhor para:** Resposta D na P5 (usuário v2.0)  
+**Você vai ler:**
+1. [Breaking Changes Summary](#breaking-changes) (10 min)
+2. [Migration Guide v2.0 → v2.1](#migration-guide) (20 min)
+3. [What's New - Technical Deep Dive](#whats-new-technical) (20 min)
+4. [New Features Quick Tour](#new-features-tour) (15 min)
+5. **Próximo Passo:** Execute migration script
+
+---
+
+## 🎯 CASOS DE USO ESPECIAIS
+
+### 🏛️ Para Brownfield Projects
+**Você disse que tem projeto existente?**  
+Adicione este material ao seu track escolhido:
+- [Brownfield Integration Guide](#brownfield-guide) (30 min)
+- [Incremental Migration Strategy](#incremental-migration) (15 min)
+- [Real Example: Subdirectory Migration](#subdirectory-example) - Caso real
+
+### 🔧 Para Framework Developers
+**Você quer contribuir com AIOS?**  
+Seu caminho específico:
+1. Track 3 (Mastery Path) completo
+2. [Architecture Deep Dive](#architecture-deep-dive) (2 horas)
+3. [Decision History](#decision-history) - Entenda o "porquê"
+4. [Contribution Guide](#contribution-guide) (30 min)
+5. [Open Issues & Roadmap](#roadmap) - Encontre onde contribuir
+
+### 👔 Para Non-Technical Leaders
+**Você não codifica mas precisa entender?**  
+Track customizado:
+1. [Executive Summary](#executive-summary) (10 min)
+2. [Essay 1: Por Que AIOS Existe](#essay-1) - Conceitos sem código (15 min)
+3. [Business Model v2.1](#business-model) (15 min)
+4. [Team Adoption Guide](#team-adoption) (10 min)
+
+---
+
+## ✅ CHECKLIST PRÉ-LEITURA
+
+Antes de prosseguir para seu track, confirme:
+
+- [ ] **Escolhi meu Track** (1, 2, 3, 4, 5 ou 6)
+- [ ] **Separei o tempo necessário** (não adianta escolher Track 2 com 15 minutos)
+- [ ] **Tenho objetivo claro** (explorar vs adotar vs contribuir vs decidir vs migrar)
+- [ ] **[Opcional] Tenho projeto em mente** para aplicar o aprendizado
+- [ ] **[Opcional] Configurei ambiente** se for implementar junto (Node.js 18+, IDE)
+
+---
+
+## 🎯 ESCOLHA SEU CAMINHO AGORA
+
+Clique no track que escolheu e **comece sua jornada AIOS v2.1**:
+
+→ [TRACK 1: Quick Start (15-30 min)](#track-1-quick-start)  
+→ [TRACK 2: Deep Dive Inicial (1.5-2h)](#track-2-deep-dive)  
+→ [TRACK 3: Mastery Path (Semanas)](#track-3-mastery)  
+→ [TRACK 4: Decision Maker (30-45 min)](#track-4-decision-maker)  
+→ [TRACK 5: Targeted Learning (Variável)](#track-5-targeted)  
+→ [TRACK 6: v2.0 Upgrade (45-60 min)](#track-6-upgrade)
+
+---
+
+## 💡 NOTA DOS CRIADORES
+
+> **Pedro Valério:** "v2.1 é o que sempre quis construir. Installer em 5 minutos. Workers open-source com Service Discovery. Task-First funcionando de verdade. Quality Gates em 3 layers. Se você testou v2.0 e achou complexo, v2.1 resolveu isso. Se você nunca usou AIOS, esse é o momento perfeito."
+
+> **Marty Cagan:** "v2.1 tackles the value risk head-on: 'Will this actually save me time?' Answer: Yes. 5-minute install (vs 2-4 hours). 97 Workers ready to use (vs writing from scratch). 80% of issues caught automatically (vs 0%). These aren't aspirational metrics - they're production reality."
+
+> **Brad Frost:** "Service Discovery is to Workers what Pattern Libraries are to Components. You can finally FIND and REUSE instead of REBUILD. Task-First Architecture is Atomic Design applied to processes. It's elegant. It works. It scales."
+
+> **Paul Graham:** "The interesting truth: opening Workers made AIOS stronger, not weaker. Clones are the moat. Workers are the network effect. v2.1 gets this right. The framework you'd design if you started today, knowing what we know now."
+
+---
+
+**Pronto?** Escolha seu track acima e comece! ↑
+
+---
+
+