aios-core 4.0.4 → 4.2.0

package/.aios-core/development/tasks/validate-next-story.md

@@ -190,13 +190,24 @@ token_usage: ~3,000-10,000 tokens
 
 ```yaml
 story: N/A
-version: 1.0.0
+version: 2.0.0
 dependencies:
   - N/A
 tags:
   - automation
   - workflow
-updated_at: 2025-11-17
+  - self-healing
+  - auto-fix
+updated_at: 2026-02-15
+changelog:
+  - version: 2.0.0
+    date: 2026-02-15
+    author: "@po (Pax)"
+    change: "Added Step 12: Auto-Fix and Re-Validate loop — fixes template compliance, CodeRabbit, Dev Notes, Testing, Risks, and task AC mapping automatically"
+  - version: 1.0.0
+    date: 2025-11-17
+    author: "original"
+    change: "Initial validate-next-story task (report-only, no auto-fix)"
 ```
 
 ---
@@ -452,4 +463,90 @@ Provide a structured validation report including:
 - **NO-GO**: Story requires fixes before implementation
 - **Implementation Readiness Score**: 1-10 scale
 - **Confidence Level**: High/Medium/Low for successful implementation
+
+### 12. Auto-Fix and Re-Validate (Self-Healing Loop)
+
+**Purpose:** Automatically fix all fixable issues found during validation instead of just reporting them. This eliminates the manual round-trip of validate → report → fix → re-validate.
+
+**EXECUTION RULES:**
+
+```yaml
+auto_fix:
+  enabled: true
+  max_iterations: 2
+  fixable_categories:
+    - template_compliance    # Missing sections from story template
+    - executor_assignment    # Missing or incorrect executor/quality_gate fields
+    - story_format           # Missing "As a / I want / So that"
+    - coderabbit_section     # Missing or incomplete CodeRabbit Integration
+    - dev_notes              # Missing Dev Notes, Source Tree, Testing
+    - task_ac_mapping        # Tasks without AC references
+    - risks_section          # Missing Risks section
+    - placeholder_sections   # Missing Dev Agent Record, QA Results placeholders
+  non_fixable_categories:
+    - anti_hallucination     # Requires human verification
+    - business_logic         # Requires PO decision
+    - scope_changes          # Requires stakeholder approval
+```
+
+**SEQUENTIAL AUTO-FIX PROCEDURE:**
+
+1. **Classify issues** from Step 11 report:
+   - `FIXABLE`: Template compliance, missing sections, structural issues
+   - `NON-FIXABLE`: Business logic, scope, anti-hallucination findings
+
+2. **IF fixable issues exist AND iteration < max_iterations:**
+
+   a. **Template Compliance Fixes:**
+      - Missing Executor Assignment → Infer from story Agent field and Work Type mapping (Step 1.1 table)
+      - Missing Story format → Generate from Description section (extract role, action, benefit)
+      - Missing Dev Notes → Generate from Technical Notes, File List, and epic context
+      - Missing Testing section → Generate from Acceptance Criteria (derive test scenarios)
+      - Missing Risks section → Generate from Description and Scope (identify common risk patterns)
+      - Missing placeholder sections (Dev Agent Record, QA Results) → Add standard placeholders
+
+   b. **CodeRabbit Integration Fixes (if `coderabbit_integration.enabled: true`):**
+      - Missing section → Generate from story type analysis:
+        - Infer Primary Type from Description keywords
+        - Assign agents from Work Type mapping
+        - Add Quality Gate checkboxes (Pre-Commit always, Pre-PR if applicable)
+        - Add Self-Healing config based on primary agent
+        - Add Focus Areas based on story type
+
+   c. **Task Enhancement Fixes:**
+      - Missing AC references → Map tasks to ACs by content matching
+      - Missing subtasks → Break down vague tasks into specific subtasks
+      - Add edge case scenarios to ACs if obvious gaps found
+
+   d. **Nice-to-Have Improvements:**
+      - Add external dependency links (GitHub, npm) if referenced in Technical Notes
+      - Expand Scope IN/OUT if implicit from Description
+
+3. **Apply all fixes** to the story file using Edit tool
+
+4. **Re-validate** (run Steps 1-11 again on fixed story)
+
+5. **IF still NO-GO after max_iterations:**
+   - Report remaining NON-FIXABLE issues
+   - List what was auto-fixed vs what needs human decision
+   - HALT for user input
+
+6. **IF GO after fixes:**
+   - Update story Status from `Draft` to `Ready`
+   - Log transition in Change Log: `"Status: Draft → Ready (validation GO {score}/10, auto-fixed {N} issues)"`
+   - Report summary of all fixes applied
+
+**AUTO-FIX CHANGE LOG FORMAT:**
+```markdown
+| {date} | @po (Pax) | v{N} — Auto-fix: {comma-separated list of fixes applied} |
+| {date} | @po (Pax) | Status: Draft → Ready (validation GO {score}/10) |
+```
+
+**IMPORTANT CONSTRAINTS:**
+- NEVER change Acceptance Criteria content (only add missing edge cases as new ACs)
+- NEVER change Description or Problem/Solution
+- NEVER change Scope IN/OUT boundaries
+- NEVER change Points or Priority
+- NEVER invent technical details not present in epic/PRD context
+- All generated content MUST be traceable to existing story content or epic context
  

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md

@@ -68,7 +68,7 @@ console.log(status.tip('Press Enter to continue'));
 
 ### Welcome Screen
 ```javascript
-console.log(headings.h1('🎉 Welcome to AIOS v2.1 Installer!'));
+console.log(headings.h1('🎉 Welcome to AIOS v4.0.4 Installer!'));
 console.log(colors.info('Let\'s configure your project...\n'));
 ```
 

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md

@@ -1,4 +1,4 @@
-# AIOS Color Palette v2.1
+# AIOS Color Palette v4.0.4
 
 **Version:** 2.1.0  
 **Created:** 2025-01-20  
@@ -66,7 +66,7 @@ For special effects, animations, and branding moments:
 ```javascript
 const chalk = require('chalk');
 
-// AIOS Color Palette v2.1
+// AIOS Color Palette v4.0.4
 const colors = {
   // Core Brand Colors
   primary: chalk.hex('#8B5CF6'),      // ClickUp-inspired purple
@@ -162,7 +162,7 @@ module.exports = {
 - Example: Welcome screens, major section headers
 
 ```javascript
-console.log(colors.brandPrimary('🎉 AIOS v2.1 Installer'));
+console.log(colors.brandPrimary('🎉 AIOS v4.0.4 Installer'));
 ```
 
 **Level 2: Primary Content**
@@ -193,7 +193,7 @@ console.log(colors.info('💡 Tip: You can change this later'));
 **Installer & Wizards:**
 ```javascript
 // Welcome
-console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v2.1\n'));
+console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v4.0.4\n'));
 console.log(colors.info('Let\'s get your project set up...\n'));
 
 // Questions
@@ -341,7 +341,7 @@ For future design system integration:
 ## 🔗 Related Documents
 
 - [AIOS-LIVRO-DE-OURO-V2.1](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) - Complete AIOS standards
-- [Story 1.2](../stories/v2.1/sprint-1/story-1.2-interactive-wizard-foundation.md) - Interactive Wizard (first implementation)
+- [Story 1.2](../stories/v4.0.4/sprint-1/story-1.2-interactive-wizard-foundation.md) - Interactive Wizard (first implementation)
 - [ClickUp Brand Guidelines](https://clickup.com/brand) - Primary color reference
 
 ---

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

@@ -1,4 +1,4 @@
-# AIOS Framework - Livro de Ouro v2.1 (Complete)
+# AIOS Framework - Livro de Ouro v4.0.4 (Complete)
 
 ## O Sistema Operacional Definitivo para Orquestração de Agentes IA
 
@@ -17,7 +17,7 @@
 
 ## 📣 IMPORTANTE: Sobre Este Documento
 
-Este documento é a **versão consolidada v2.1** que incorpora todas as mudanças dos Sprints 2-5:
+Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudanças dos Sprints 2-5:
 
 - ✅ **Modular Architecture** (4 módulos: core, development, product, infrastructure)
 - ✅ **Squad System** (nova terminologia, substituindo "Expansion Pack")
@@ -34,13 +34,13 @@ Este documento é a **versão consolidada v2.1** que incorpora todas as mudança
 
 ---
 
-## 📜 Open Source vs. Serviço - Business Model v2.1
+## 📜 Open Source vs. Serviço - Business Model v4.0.4
 
-### O Que Mudou de v2.0 para v2.1
+### O Que Mudou de v2.0 para v4.0.4
 
-**IMPORTANTE: v2.1 alterou fundamentalmente o business model!**
+**IMPORTANTE: v4.0.4 alterou fundamentalmente o business model!**
 
-| Componente               | v2.0        | v2.1            | Rationale                  |
+| Componente               | v2.0        | v4.0.4            | Rationale                  |
 | ------------------------ | ----------- | --------------- | -------------------------- |
 | **11 Agents**            | ✅ Open     | ✅ Open         | Core functionality         |
 | **Workers (97+)**        | ❌ Closed   | ✅ **OPEN**     | Commodity, network effects |
@@ -106,7 +106,7 @@ Este documento é a **versão consolidada v2.1** que incorpora todas as mudança
 | LangChain     | ✅ Complete              | ❌ None (commodity)            |
 | CrewAI        | ✅ Complete              | ❌ None (commodity)            |
 | AutoGen       | ✅ Complete              | ❌ None (commodity)            |
-| **AIOS v2.1** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
+| **AIOS v4.0.4** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
 
 **Analogia:** Linux é open source, mas Red Hat Enterprise Linux adiciona suporte e otimizações. Ambos são Linux, mas o valor agregado varia. AIOS funciona igual.
 
@@ -119,7 +119,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 - 🚀 **Layer 0: DISCOVERY** - Descubra seu caminho (5 min)
 - 🎯 **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 3: USAGE GUIDE** - Como usar AIOS v4.0.4 no seu contexto
 - 📚 **Layer 4: COMPLETE REFERENCE** - Especificação técnica completa
 - 🔄 **META: EVOLUTION** - Como contribuir e evoluir o framework
 
@@ -129,7 +129,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 
 # 🚀 LAYER 0: DISCOVERY ROUTER
 
-## Bem-vindo ao AIOS v2.1 - Vamos Encontrar Seu Caminho
+## Bem-vindo ao AIOS v4.0.4 - Vamos Encontrar Seu Caminho
 
 ### Learning Tracks Disponíveis
 
@@ -192,7 +192,7 @@ AIOS fornece **orquestração estruturada**:
 
 ---
 
-## Essay 3: Business Model v2.1
+## Essay 3: Business Model v4.0.4
 
 ### Por Que Workers São Open-Source Agora?
 
@@ -212,7 +212,7 @@ AIOS fornece **orquestração estruturada**:
 
 ## Essay 4: Agent System
 
-### Os 11 Agents v2.1
+### Os 11 Agents v4.0.4
 
 | Agent     | ID              | Archetype    | Responsabilidade        |
 | --------- | --------------- | ------------ | ----------------------- |
@@ -288,7 +288,7 @@ responsavel_type: Clone    # Year 2
 
 # 🎨 LAYER 2: COMPONENT LIBRARY
 
-## Arquitetura Modular v2.1
+## Arquitetura Modular v4.0.4
 
 ### Os 4 Módulos
 
@@ -342,7 +342,7 @@ Regras:
 
 ---
 
-## Squad System (Novo em v2.1)
+## Squad System (Novo em v4.0.4)
 
 ### Terminologia
 
@@ -600,7 +600,7 @@ npm install @aios/mcp-presets
 
 # 📋 LAYER 3: USAGE GUIDE
 
-## Quick Start v2.1
+## Quick Start v4.0.4
 
 ### Installation (5 minutes)
 
@@ -609,7 +609,7 @@ npm install @aios/mcp-presets
 $ npx @SynkraAI/aios@latest init
 
 # Existing project (Brownfield)
-$ npx @SynkraAI/aios migrate v2.0-to-v2.1
+$ npx @SynkraAI/aios migrate v2.0-to-v4.0.4
 ```
 
 ### First Steps
@@ -700,7 +700,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 # 📚 LAYER 4: COMPLETE REFERENCE
 
-## Source Tree v2.1 (Current)
+## Source Tree v4.0.4 (Current)
 
 ```
 @synkra/aios-core/                        # Root project
@@ -733,7 +733,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 │
 ├── docs/                              # Project docs
 │   ├── stories/                       # Development stories
-│   │   └── v2.1/                      # v2.1 stories
+│   │   └── v4.0.4/                      # v4.0.4 stories
 │   │       ├── sprint-1/
 │   │       ├── sprint-2/
 │   │       ├── sprint-3/
@@ -785,7 +785,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Installation
 
-| Metric          | v2.0       | v2.1      | Improvement     |
+| Metric          | v2.0       | v4.0.4      | Improvement     |
 | --------------- | ---------- | --------- | --------------- |
 | Time to install | 2-4 hours  | 5 minutes | **96% faster**  |
 | Steps required  | 15+ manual | 1 command | **93% simpler** |
@@ -793,7 +793,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Development Speed
 
-| Metric                | v2.0     | v2.1       | Improvement       |
+| Metric                | v2.0     | v4.0.4       | Improvement       |
 | --------------------- | -------- | ---------- | ----------------- |
 | Find reusable Worker  | N/A      | 30 seconds | **∞**             |
 | Quality issues caught | 20%      | 80%        | **4x**            |
@@ -801,7 +801,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Quality
 
-| Metric              | v2.0       | v2.1          |
+| Metric              | v2.0       | v4.0.4          |
 | ------------------- | ---------- | ------------- |
 | Quality Gate Layers | 1 (manual) | 3 (automated) |
 | Auto-caught issues  | 0%         | 80%           |
@@ -834,4 +834,4 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ---
 
-_Este documento consolida AIOS-LIVRO-DE-OURO.md (v2.0) + deltas v2.1 em um único documento completo._
+_Este documento consolida AIOS-LIVRO-DE-OURO.md (v2.0) + deltas v4.0.4 em um único documento completo._

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

@@ -9,14 +9,14 @@
 
 ## 🎯 PURPOSE OF THIS DOCUMENT
 
-This is a **delta document** highlighting **ONLY what changed in v2.2** compared to v2.1.
+This is a **delta document** highlighting **ONLY what changed in v2.2** compared to v4.0.4.
 
 For complete content:
 - ✅ **`AIOS-LIVRO-DE-OURO.md`** (v2.0 base)
-- ✅ **`AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md`** (v2.1 changes)
+- ✅ **`AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md`** (v4.0.4 changes)
 - ✅ **This document** (v2.2 changes ONLY)
 
-**Combined reading:** v2.0 base + v2.1 delta + v2.2 delta = Complete v2.2 understanding
+**Combined reading:** v2.0 base + v4.0.4 delta + v2.2 delta = Complete v2.2 understanding
 
 ---
 
@@ -24,7 +24,7 @@ For complete content:
 
 ### Memory Layer (The Game Changer)
 
-**v2.1:** Stateless agents (each execution isolated)  
+**v4.0.4:** Stateless agents (each execution isolated)  
 **v2.2:** Agents remember, learn, and improve
 
 ```yaml
@@ -59,7 +59,7 @@ Memory Types:
 
 ### Agent Lightning (RL Optimization)
 
-**v2.1:** Static workflows  
+**v4.0.4:** Static workflows  
 **v2.2:** Self-optimizing workflows
 
 ```yaml
@@ -96,7 +96,7 @@ Result:
 
 ### Advanced Features Matrix
 
-| Feature | v2.1 | v2.2 | Impact |
+| Feature | v4.0.4 | v2.2 | Impact |
 |---------|------|------|--------|
 | **Memory Layer** | ❌ Stateless | ✅ 4 memory types | Agents learn |
 | **Agent Lightning** | ❌ Static | ✅ RL optimization | 30% faster, 40% cheaper |
@@ -110,7 +110,7 @@ Result:
 
 ## 🧠 DEEP DIVE: Memory Layer
 
-### The Problem (v2.1)
+### The Problem (v4.0.4)
 
 ```yaml
 Scenario: Developer asks Dex (Dev Agent) to implement feature
@@ -298,10 +298,10 @@ Example:
 
 ## ⚡ DEEP DIVE: Agent Lightning
 
-### The Problem (v2.1)
+### The Problem (v4.0.4)
 
 ```yaml
-Static Workflow (v2.1):
+Static Workflow (v4.0.4):
   1. Developer creates story
   2. Dex implements (5 min)
   3. Quinn tests (3 min)
@@ -419,7 +419,7 @@ Result:
 
 ### Impact Metrics
 
-**Before Agent Lightning (v2.1):**
+**Before Agent Lightning (v4.0.4):**
 ```yaml
 Average workflow time: 11 minutes
 Average cost per story: $0.50 (LLM calls)
@@ -441,7 +441,7 @@ Learning rate: 10% improvement per week
 
 ### Shared Context
 
-**v2.1:** Each developer's agents isolated  
+**v4.0.4:** Each developer's agents isolated  
 **v2.2:** Team-wide shared memory
 
 ```yaml
@@ -637,11 +637,11 @@ responsavel_type: Clone
 
 ---
 
-## 📊 COMPARATIVE METRICS: v2.1 vs. v2.2
+## 📊 COMPARATIVE METRICS: v4.0.4 vs. v2.2
 
 ### Development Speed
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Simple task time | 11 min | 1 min | **91% faster** |
 | Complex task time | 11 min | 26 min | Appropriately slower |
@@ -650,7 +650,7 @@ responsavel_type: Clone
 
 ### Cost Efficiency
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Avg cost per story | $0.50 | $0.30 | **40% cheaper** |
 | Wasted LLM calls | 30% | 5% | **83% reduction** |
@@ -658,7 +658,7 @@ responsavel_type: Clone
 
 ### Quality & Learning
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Issue catch rate | 80% (3 layers) | 85% (learning) | **+5 percentage points** |
 | False positive rate | 15% | 8% | **47% reduction** |
@@ -667,7 +667,7 @@ responsavel_type: Clone
 
 ### Team Collaboration
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Handoff delay | 30 min avg | 0 min | **100% elimination** |
 | Coordination overhead | 2h/day | 15min/day | **87% reduction** |
@@ -716,7 +716,7 @@ Features:
 
 ## 🎯 SUMMARY: Evolution Path
 
-### v2.0 → v2.1 (The Foundation)
+### v2.0 → v4.0.4 (The Foundation)
 
 **Focus:** Installation + Discovery + Architecture
 - ✅ 5-minute installation
@@ -729,7 +729,7 @@ Features:
 
 ---
 
-### v2.1 → v2.2 (The Intelligence)
+### v4.0.4 → v2.2 (The Intelligence)
 
 **Focus:** Memory + Learning + Collaboration
 - ✅ Memory Layer (4 types)
@@ -756,7 +756,7 @@ Features:
 
 ## 📖 WHERE TO GO FROM HERE
 
-### If You're on v2.1
+### If You're on v4.0.4
 
 1. ✅ Read this summary (done!)
 2. → Review [Memory Layer Architecture](#memory-layer)
@@ -782,7 +782,7 @@ Features:
 
 ---
 
-**Full v2.2 Documentation:** Combine v2.0 base + v2.1 delta + v2.2 delta
+**Full v2.2 Documentation:** Combine v2.0 base + v4.0.4 delta + v2.2 delta
 
 **Next Version:** v2.3 (Q3 2026) - Enterprise & Scale
 
@@ -988,7 +988,7 @@ Features:
 │   ├── research/
 │   ├── epics/
 │   ├── stories/
-│   │   ├── v2.1/                      # v2.1 stories (completed)
+│   │   ├── v4.0.4/                      # v4.0.4 stories (completed)
 │   │   ├── v2.2/                      # ⭐ v2.2 stories (in progress)
 │   │   │   ├── sprint-1/              # Memory Layer
 │   │   │   ├── sprint-2/              # Agent Lightning
@@ -1093,7 +1093,7 @@ Features:
 
 ---
 
-### Key Changes from v2.1 → v2.2
+### Key Changes from v4.0.4 → v2.2
 
 **1. Memory Layer:**
 ```
@@ -1192,7 +1192,7 @@ ENHANCED: .aios-core/core/validation/learning-feedback-loop.js
   - False positive reduction
   - Accuracy improvement over time
 
-Impact: 85% catch rate (vs. 80% in v2.1), 8% false positives (vs. 15%)
+Impact: 85% catch rate (vs. 80% in v4.0.4), 8% false positives (vs. 15%)
 ```
 
 **7. Local Development Environment:**
@@ -1221,7 +1221,7 @@ Impact: Never lose institutional knowledge
 
 ### Storage Requirements Comparison
 
-| Component | v2.1 | v2.2 | Additional Storage |
+| Component | v4.0.4 | v2.2 | Additional Storage |
 |-----------|------|------|-------------------|
 | Base Framework | ~50MB | ~50MB | 0MB |
 | Workers | ~5MB | ~5MB | 0MB |
@@ -1237,7 +1237,7 @@ Impact: Never lose institutional knowledge
 
 ### Performance Comparison
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Simple task time | 1 min | 30s | **50% faster** |
 | Complex task time | 26 min | 22 min | **15% faster** |

package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md

@@ -3,7 +3,7 @@
 **Version:** 2.1.0
 **Date:** 2025-12-09
 **Purpose:** Document differences between AIOS open-source and AIOS service implementations
-**Status:** ⚠️ Needs Review - Updated for v2.1 Multi-Repo Strategy
+**Status:** ⚠️ Needs Review - Updated for v4.0.4 Multi-Repo Strategy
 
 ---
 
@@ -17,7 +17,7 @@ This document clarifies which features apply to which context.
 
 ---
 
-## Multi-Repo Strategy (v2.1)
+## Multi-Repo Strategy (v4.0.4)
 
 ### Repository Organization
 
@@ -489,7 +489,7 @@ function validateTask(task) {
 
 ## Related Documents
 
-- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v2.1 framework guide
+- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v4.0.4 framework guide
 - [STANDARDS-INDEX.md](./STANDARDS-INDEX.md) - Standards navigation
 - [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) - Complete task format spec
 - [AGENT-PERSONALIZATION-STANDARD-V1.md](./AGENT-PERSONALIZATION-STANDARD-V1.md) - Personality guidelines
@@ -508,4 +508,4 @@ function validateTask(task) {
 
 **Last Updated:** 2025-12-09
 **Version:** 2.1.0
-**Applies to:** AIOS v2.1+
+**Applies to:** AIOS v4.0.4+

package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md

@@ -1,4 +1,4 @@
-# Quality Gates Specification v2.1
+# Quality Gates Specification v4.0.4
 
 **Version:** 2.1.0
 **Last Updated:** 2025-12-09
@@ -481,7 +481,7 @@ reviews:
         Verify:
         - Terminology uses 'Squad' not 'Expansion Pack'
         - All internal links work
-        - Version numbers are v2.1
+        - Version numbers are v4.0.4
 
     - path: "squads/**"
       instructions: |
@@ -512,7 +512,7 @@ reviews:
 | Issues escaping to production | ~15% |
 | Developer context switches | High |
 
-### After Quality Gates (v2.1)
+### After Quality Gates (v4.0.4)
 
 | Metric | Value | Improvement |
 |--------|-------|-------------|

package/.aios-core/docs/standards/STANDARDS-INDEX.md

@@ -16,18 +16,18 @@
 
 ### For Existing Users
 
-- **v2.0 → v2.1 Migration:** See "What's New" section in [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md)
+- **v2.0 → v4.0.4 Migration:** See "What's New" section in [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md)
 - **Architecture Changes:** Review [ARCHITECTURE-INDEX.md](../../docs/architecture/ARCHITECTURE-INDEX.md)
 
 ---
 
 ## 📚 Standards by Category
 
-### Core Framework Standards (Current v2.1)
+### Core Framework Standards (Current v4.0.4)
 
 | Document | Description | Status | Version |
 |----------|-------------|--------|---------|
-| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v2.1 framework guide** | ✅ Current | 2.1.0 |
+| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v4.0.4 framework guide** | ✅ Current | 2.1.0 |
 | [QUALITY-GATES-SPECIFICATION.md](./QUALITY-GATES-SPECIFICATION.md) | 3-layer quality gates system | ✅ Current | 2.1.0 |
 | [STORY-TEMPLATE-V2-SPECIFICATION.md](./STORY-TEMPLATE-V2-SPECIFICATION.md) | Story template v2.0 specification | ✅ Current | 2.0.0 |
 | [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) | Task-First architecture format | ✅ Current | 1.0.0 |
@@ -52,21 +52,21 @@
 | Document | Description | Status | Superseded By |
 |----------|-------------|--------|---------------|
 | [AIOS-LIVRO-DE-OURO.md](./AIOS-LIVRO-DE-OURO.md) | v2.0.0 base document | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
-| [AIOS-LIVRO-DE-OURO-V2.1.md](./AIOS-LIVRO-DE-OURO-V2.1.md) | v2.1 delta (partial) | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
-| [AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) | v2.1 summary | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
+| [AIOS-LIVRO-DE-OURO-V2.1.md](./AIOS-LIVRO-DE-OURO-V2.1.md) | v4.0.4 delta (partial) | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
+| [AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) | v4.0.4 summary | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
 | [AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md) | Future v2.2 planning | 📋 Draft | N/A |
 | [AIOS-FRAMEWORK-MASTER.md](./AIOS-FRAMEWORK-MASTER.md) | v2.0.0 framework doc | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
 | [V3-ARCHITECTURAL-DECISIONS.md](./V3-ARCHITECTURAL-DECISIONS.md) | Old architectural decisions | 📦 Archive Candidate | Current architecture docs |
 
 ---
 
-## 🔄 What Changed in v2.1
+## 🔄 What Changed in v4.0.4
 
 ### New Documents Created
 
 | Document | Purpose |
 |----------|---------|
-| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v2.1 documentation |
+| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v4.0.4 documentation |
 | QUALITY-GATES-SPECIFICATION.md | 3-layer quality gates |
 | STORY-TEMPLATE-V2-SPECIFICATION.md | Story template v2.0 |
 | STANDARDS-INDEX.md | This navigation document |
@@ -101,8 +101,8 @@
 .aios-core/docs/standards/
 ├── STANDARDS-INDEX.md                     # This file - navigation
 │
-├── Current v2.1 Standards
-│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v2.1 guide
+├── Current v4.0.4 Standards
+│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v4.0.4 guide
 │   ├── QUALITY-GATES-SPECIFICATION.md       # Quality gates
 │   ├── STORY-TEMPLATE-V2-SPECIFICATION.md   # Story template
 │   ├── TASK-FORMAT-SPECIFICATION-V1.md      # Task format
@@ -113,8 +113,8 @@
 │
 ├── Legacy (Reference Only)
 │   ├── AIOS-LIVRO-DE-OURO.md              # v2.0.0 base (deprecated)
-│   ├── AIOS-LIVRO-DE-OURO-V2.1.md         # v2.1 delta (deprecated)
-│   ├── AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md # v2.1 summary (deprecated)
+│   ├── AIOS-LIVRO-DE-OURO-V2.1.md         # v4.0.4 delta (deprecated)
+│   ├── AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md # v4.0.4 summary (deprecated)
 │   ├── AIOS-FRAMEWORK-MASTER.md           # v2.0.0 (deprecated)
 │   └── V3-ARCHITECTURAL-DECISIONS.md      # Archive candidate
 │
@@ -156,7 +156,7 @@ Located in `docs/`:
 
 | Status | Meaning | Action |
 |--------|---------|--------|
-| ✅ Current | Up-to-date with v2.1 | Use as reference |
+| ✅ Current | Up-to-date with v4.0.4 | Use as reference |
 | ⚠️ Deprecated | Superseded by newer document | Refer to replacement |
 | ⚠️ Needs Update | Content outdated | Update planned |
 | 📦 Archive Candidate | Should be archived | Move to _archived/ |
@@ -201,7 +201,7 @@ grep -r "v2.0" .aios-core/docs/standards --include="*.md"
 
 | Date | Version | Changes | Author |
 |------|---------|---------|--------|
-| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v2.1 | @dev (Dex) |
+| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v4.0.4 | @dev (Dex) |
 
 ---