aiox-core 5.0.2 → 5.0.3

package/pro/squads/squad-creator-pro/data/quality-dimensions-framework.md

@@ -0,0 +1,405 @@
+# Quality Dimensions Framework
+
+> **Version:** 1.0.0
+> **Source:** AIOS Quality Standards
+
+Framework for evaluating squad outputs using multi-dimensional quality scoring.
+
+---
+
+## 1. Overview
+
+A comprehensive quality assessment uses 10 standardized dimensions. Each dimension has:
+- **Weight:** Relative importance (0.0-1.0)
+- **Threshold:** Minimum acceptable score
+- **Veto Power:** Whether low score blocks progress
+
+---
+
+## 2. Standard Quality Dimensions
+
+### Configuration
+
+```yaml
+quality_dimensions:
+  pattern_reference: "squad-creator/data/quality-dimensions-framework.md"
+  total_dimensions: 10
+
+  scoring:
+    overall_threshold: 7.0
+    minimum_per_dimension: 6.0
+    veto_on_failure: false  # Default to REVIEW, not VETO
+
+  dimensions:
+    1_accuracy:
+      name: "Accuracy"
+      weight: 1.0
+      threshold: 7.0
+      veto_power: true
+      description: "Correctness verified by data/evidence"
+
+    2_coherence:
+      name: "Coherence"
+      weight: 0.9
+      threshold: 6.0
+      veto_power: false
+      description: "Internal consistency and alignment"
+
+    3_strategic_alignment:
+      name: "Strategic Alignment"
+      weight: 0.9
+      threshold: 6.0
+      veto_power: false
+      description: "Connection to goals and vision"
+
+    4_operational_excellence:
+      name: "Operational Excellence"
+      weight: 0.8
+      threshold: 6.0
+      veto_power: false
+      description: "Process quality and efficiency"
+
+    5_innovation_capacity:
+      name: "Innovation Capacity"
+      weight: 0.7
+      threshold: 5.0
+      veto_power: false
+      description: "Ability to create novel solutions"
+
+    6_risk_management:
+      name: "Risk Management"
+      weight: 0.8
+      threshold: 6.0
+      veto_power: false
+      description: "Identification and mitigation of risks"
+
+    7_resource_optimization:
+      name: "Resource Optimization"
+      weight: 0.8
+      threshold: 6.0
+      veto_power: false
+      description: "Efficient use of time, money, people"
+
+    8_stakeholder_value:
+      name: "Stakeholder Value"
+      weight: 0.7
+      threshold: 6.0
+      veto_power: false
+      description: "Value delivered to all parties"
+
+    9_sustainability:
+      name: "Sustainability"
+      weight: 0.7
+      threshold: 6.0
+      veto_power: false
+      description: "Long-term viability"
+
+    10_adaptability:
+      name: "Adaptability"
+      weight: 0.6
+      threshold: 5.0
+      veto_power: false
+      description: "Ability to respond to change"
+```
+
+---
+
+## 3. Dimension Details
+
+### 3.1 Accuracy (Weight: 1.0, VETO)
+
+**Definition:** Correctness verified by data/evidence.
+
+**Scoring Criteria:**
+- 9-10: All claims verified, zero errors
+- 7-8: Minor inaccuracies, easily corrected
+- 5-6: Some unverified claims, needs review
+- 3-4: Significant errors or contradictions
+- 1-2: Fundamentally incorrect
+
+**Red Flags:**
+- Claims without supporting evidence
+- Contradictions within the output
+- Outdated or incorrect data
+
+### 3.2 Coherence (Weight: 0.9)
+
+**Definition:** Internal consistency and alignment.
+
+**Scoring Criteria:**
+- 9-10: Perfect internal consistency
+- 7-8: Minor inconsistencies, easily reconciled
+- 5-6: Some logical gaps
+- 3-4: Significant contradictions
+- 1-2: Incoherent
+
+**Red Flags:**
+- Statements contradict each other
+- Logic gaps in reasoning
+- Disconnected sections
+
+### 3.3 Strategic Alignment (Weight: 0.9)
+
+**Definition:** Connection to goals and vision.
+
+**Scoring Criteria:**
+- 9-10: Directly enables strategic goals
+- 7-8: Clearly supports strategy
+- 5-6: Neutral, neither helps nor hinders
+- 3-4: Questionable alignment
+- 1-2: Contradicts strategic direction
+
+**Red Flags:**
+- No clear connection to objectives
+- Works against stated goals
+- Short-term focus at expense of long-term
+
+### 3.4 Operational Excellence (Weight: 0.8)
+
+**Definition:** Process quality and efficiency.
+
+**Scoring Criteria:**
+- 9-10: Optimal process, best practices
+- 7-8: Well-designed, minor improvements possible
+- 5-6: Functional but inefficient
+- 3-4: Significant process issues
+- 1-2: Broken or missing processes
+
+**Red Flags:**
+- Manual work that should be automated
+- Missing documentation
+- Inconsistent execution
+
+### 3.5 Innovation Capacity (Weight: 0.7)
+
+**Definition:** Ability to create novel solutions.
+
+**Scoring Criteria:**
+- 9-10: Breakthrough innovation
+- 7-8: Creative improvements
+- 5-6: Standard solutions
+- 3-4: Outdated approaches
+- 1-2: No innovation
+
+**Red Flags:**
+- Copy-paste solutions without adaptation
+- Ignoring new tools/methods
+- Resistance to improvement
+
+### 3.6 Risk Management (Weight: 0.8)
+
+**Definition:** Identification and mitigation of risks.
+
+**Scoring Criteria:**
+- 9-10: All risks identified and mitigated
+- 7-8: Major risks addressed
+- 5-6: Some risks identified, partial mitigation
+- 3-4: Significant blind spots
+- 1-2: No risk consideration
+
+**Red Flags:**
+- No contingency plans
+- Ignoring known risks
+- Single points of failure
+
+### 3.7 Resource Optimization (Weight: 0.8)
+
+**Definition:** Efficient use of time, money, people.
+
+**Scoring Criteria:**
+- 9-10: Optimal resource allocation
+- 7-8: Efficient with minor waste
+- 5-6: Acceptable efficiency
+- 3-4: Significant waste
+- 1-2: Grossly inefficient
+
+**Red Flags:**
+- Redundant work
+- Over-engineering
+- Under-utilization of available resources
+
+### 3.8 Stakeholder Value (Weight: 0.7)
+
+**Definition:** Value delivered to all parties.
+
+**Scoring Criteria:**
+- 9-10: Exceptional value for all stakeholders
+- 7-8: Good value, meets expectations
+- 5-6: Minimal viable value
+- 3-4: Some stakeholders underserved
+- 1-2: No clear value
+
+**Red Flags:**
+- Ignoring key stakeholder needs
+- Unbalanced value distribution
+- No clear benefit articulation
+
+### 3.9 Sustainability (Weight: 0.7)
+
+**Definition:** Long-term viability.
+
+**Scoring Criteria:**
+- 9-10: Built for perpetuity
+- 7-8: Sustainable with maintenance
+- 5-6: Medium-term viability
+- 3-4: Short-term solution
+- 1-2: Not sustainable
+
+**Red Flags:**
+- Technical debt accumulation
+- Dependency on unsustainable resources
+- No maintenance plan
+
+### 3.10 Adaptability (Weight: 0.6)
+
+**Definition:** Ability to respond to change.
+
+**Scoring Criteria:**
+- 9-10: Highly flexible, easy to modify
+- 7-8: Adaptable with reasonable effort
+- 5-6: Some flexibility
+- 3-4: Rigid, hard to change
+- 1-2: Inflexible, locked in
+
+**Red Flags:**
+- Hardcoded assumptions
+- No extension points
+- Tightly coupled components
+
+---
+
+## 4. Assessment Template
+
+```yaml
+quality_assessment:
+  subject: "What is being assessed"
+  assessment_date: "YYYY-MM-DD"
+  assessor: "Who/what performed assessment"
+
+  dimensions:
+    - name: "Accuracy"
+      score: 0-10
+      evidence: "Supporting observations"
+      recommendations: ["Improvements"]
+
+    - name: "Coherence"
+      score: 0-10
+      evidence: "Observations"
+      recommendations: []
+
+    # ... repeat for all 10 dimensions
+
+  overall_score: number  # Weighted average
+  pass_threshold: 7.0
+  status: "PASS | FAIL | REVIEW"
+
+  summary:
+    strengths: ["What's working well"]
+    weaknesses: ["What needs improvement"]
+    critical_issues: ["Blocking issues"]
+    recommendations: ["Prioritized actions"]
+```
+
+---
+
+## 5. Scoring Calculation
+
+### Weighted Average Formula
+
+```
+overall_score = Σ(dimension_score × weight) / Σ(weights)
+```
+
+### Pass/Fail Logic
+
+```
+IF (overall_score >= 7.0 AND no_dimension < 6.0)
+  THEN status = PASS
+ELSE IF (any_veto_dimension < threshold)
+  THEN status = FAIL
+ELSE
+  status = REVIEW
+```
+
+---
+
+## 6. Domain-Specific Weights
+
+Adjust weights based on domain:
+
+### Software Development
+
+```yaml
+weights_override:
+  accuracy: 1.0        # Code must work
+  operational_excellence: 0.9
+  risk_management: 0.9
+  sustainability: 0.8
+```
+
+### Marketing/Copy
+
+```yaml
+weights_override:
+  stakeholder_value: 1.0  # Must resonate with audience
+  innovation_capacity: 0.9
+  coherence: 0.9
+```
+
+### Operations/Process
+
+```yaml
+weights_override:
+  operational_excellence: 1.0
+  resource_optimization: 0.9
+  risk_management: 0.9
+```
+
+---
+
+## 7. Integration with Workflows
+
+Add quality assessment as a checkpoint:
+
+```yaml
+checkpoint:
+  id: "quality-gate"
+  type: "quality_dimensions"
+  phase: "final"
+
+  dimensions_to_evaluate: "all"  # or specific list
+
+  thresholds:
+    overall: 7.0
+    per_dimension: 6.0
+
+  veto_dimensions:
+    - "accuracy"
+
+  pass_action: "Approve and publish"
+  fail_action: "Return for revision"
+  review_action: "Escalate to human"
+```
+
+---
+
+## 8. Continuous Improvement
+
+Track scores over time:
+
+```yaml
+tracking:
+  aggregate_by: ["month", "quarter"]
+  metrics:
+    - average_overall_score
+    - dimension_averages
+    - fail_rate
+    - veto_rate
+  alerts:
+    - condition: "average_score < 7.0"
+      action: "Review process quality"
+```
+
+---
+
+*AIOS Quality Dimensions Framework v1.0*

package/pro/squads/squad-creator-pro/data/squad-analytics-guide.md

@@ -0,0 +1,252 @@
+# Squad Analytics Guide
+
+**Version:** 1.0.0
+**Last Updated:** 2026-02-01
+**Author:** squad-chief
+
+---
+
+## Overview
+
+O comando `*squad-analytics` fornece uma visão detalhada de todo o ecossistema AIOS, incluindo contagens precisas de todos os componentes por squad.
+
+---
+
+## Quick Start
+
+```bash
+# Ativar squad-chief
+/squad-creator
+
+# Executar analytics
+*squad-analytics
+```
+
+---
+
+## Comandos Disponíveis
+
+| Comando | Descrição |
+|---------|-----------|
+| `*squad-analytics` | Tabela padrão ordenada por total de componentes |
+| `*squad-analytics --detailed` | Inclui nomes dos componentes |
+| `*squad-analytics --format json` | Exporta em JSON |
+| `*squad-analytics --sort-by agents` | Ordena por número de agents |
+| `*squad-analytics --sort-by tasks` | Ordena por número de tasks |
+| `*squad-analytics --sort-by name` | Ordena alfabeticamente |
+
+---
+
+## Métricas Capturadas
+
+### Por Squad
+
+| Métrica | Descrição | Extensões |
+|---------|-----------|-----------|
+| **Agents** | Arquivos de agente | `.md` em `/agents/` |
+| **Tasks** | Tarefas atômicas | `.md` em `/tasks/` |
+| **Workflows** | Workflows multi-fase | `.md`, `.yaml` em `/workflows/` |
+| **Templates** | Templates de output | `.md`, `.yaml` em `/templates/` |
+| **Checklists** | Checklists de validação | `.md` em `/checklists/` |
+| **Data** | Arquivos de dados/KB | `.md`, `.yaml`, `.json` em `/data/` |
+| **Scripts** | Scripts de automação | `.py`, `.js`, `.ts`, `.sh` em `/scripts/` |
+
+### Totais do Ecossistema
+
+- Total de Squads
+- Total de Agents
+- Total de Tasks
+- Total de Workflows
+- Total de Templates
+- Total de Checklists
+- Total de Data files
+- Total de Scripts
+- **Total de Componentes** (soma de todos)
+
+---
+
+## Quality Indicators
+
+| Indicador | Significado | Score |
+|-----------|-------------|-------|
+| ⭐⭐⭐ | Squad completo | 9+ pontos |
+| ⭐⭐ | Squad bom | 6-8 pontos |
+| ⭐ | Squad básico | 3-5 pontos |
+| 🔨 | Work in progress | 0-2 pontos |
+
+### Cálculo do Score
+
+```
++2 pontos: tem agents
++2 pontos: tem tasks
++1 ponto: tem workflows
++1 ponto: tem templates
++1 ponto: tem checklists
++1 ponto: tem data files
++1 ponto: tem README.md
++1 ponto: tem config.yaml
+─────────────────────────
+Máximo: 10 pontos
+```
+
+---
+
+## Output Formats
+
+### Table (Padrão)
+
+```
+====================================================================================================
+📊 AIOS SQUAD ANALYTICS
+Generated: 2026-02-01
+====================================================================================================
+
+📈 ECOSYSTEM SUMMARY
+   Squads: 21 | Agents: 127 | Tasks: 293 | Workflows: 50
+   Templates: 161 | Checklists: 96 | Data: 79 | Scripts: 142
+   Total Components: 948
+
+----------------------------------------------------------------------------------------------------
+Squad                 Agents   Tasks   WFs  Tmpls  Checks   Data  Scripts  Total Quality
+----------------------------------------------------------------------------------------------------
+{squad-a}                 22      58    11     23      17      3        3    137 ⭐⭐⭐
+{squad-b}                  9      31     2     57      16     15        7    137 ⭐⭐⭐
+...
+```
+
+### Detailed (com `--detailed`)
+
+```
+{squad-name}              22      58    11     23      17      3        3    137 ⭐⭐⭐
+   └─ agents: {agent-1}, {agent-2}, {agent-3}, {agent-4}, {agent-5} (+17 more)
+   └─ tasks: {task-1}, {task-2}, {task-3} (+55 more)
+   └─ workflows: {workflow-1}, {workflow-2} (+9 more)
+   └─ checklists: {checklist-1}, {checklist-2} (+15 more)
+```
+
+### JSON (com `--format json`)
+
+```json
+{
+  "metadata": {
+    "scan_date": "2026-02-01T15:30:00",
+    "generated_by": "squad-analytics.py"
+  },
+  "squads": [
+    {
+      "name": "copy",
+      "domain": "copywriting",
+      "counts": {
+        "agents": 22,
+        "tasks": 58,
+        "workflows": 11,
+        "templates": 23,
+        "checklists": 17,
+        "data": 3,
+        "scripts": 3
+      },
+      "total": 137,
+      "quality_score": "⭐⭐⭐"
+    }
+  ],
+  "totals": {
+    "squads": 21,
+    "agents": 127,
+    "tasks": 293,
+    "total_components": 948
+  }
+}
+```
+
+---
+
+## Casos de Uso
+
+### 1. Visão Geral do Ecossistema
+
+```bash
+*squad-analytics
+```
+
+Use para: Entender o tamanho e composição do ecossistema.
+
+### 2. Identificar Squads Incompletos
+
+```bash
+*squad-analytics --sort-by total
+```
+
+Squads no final da lista (🔨 ou ⭐) precisam de mais desenvolvimento.
+
+### 3. Encontrar Squads com Mais Tasks
+
+```bash
+*squad-analytics --sort-by tasks
+```
+
+Útil para identificar squads mais operacionais.
+
+### 4. Exportar para Análise Externa
+
+```bash
+*squad-analytics --format json > ecosystem-report.json
+```
+
+### 5. Auditoria Detalhada de Componentes
+
+```bash
+*squad-analytics --detailed
+```
+
+Mostra nomes dos componentes para verificar o que cada squad contém.
+
+---
+
+## Integração com Outros Comandos
+
+| Comando | Relação |
+|---------|---------|
+| `*show-registry` | Mostra metadados (domain, keywords, highlights) |
+| `*squad-analytics` | Mostra contagens detalhadas de componentes |
+| `*refresh-registry` | Atualiza o registry com novos squads |
+| `*validate-squad {name}` | Valida qualidade de um squad específico |
+
+---
+
+## Script Location
+
+```
+squads/squad-creator-pro/scripts/squad-analytics.py
+```
+
+**Dependências:** Python 3.8+ (usa apenas standard library)
+
+---
+
+## Troubleshooting
+
+### "Could not find squads/ directory"
+
+Execute a partir da raiz do projeto:
+```bash
+cd ${PROJECT_ROOT}
+python3 squads/squad-creator-pro/scripts/squad-analytics.py
+```
+
+### Contagens diferentes do esperado
+
+O script exclui automaticamente:
+- `README.md` e `template.md` das contagens
+- Diretórios: `.DS_Store`, `__pycache__`, `node_modules`, `.git`
+- Squads sem `config.yaml` E sem pasta `agents/`
+
+---
+
+## Changelog
+
+### v1.0.0 (2026-02-01)
+- Initial release
+- Table, JSON output formats
+- Quality indicators
+- Detailed view with component names
+- Sort by name, agents, tasks, total