aiox-core 5.0.3 → 5.0.5

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

@@ -1,405 +0,0 @@
-# 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

@@ -1,252 +0,0 @@
-# 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