aiox-core 5.0.3 → 5.0.5

package/pro/squads/squad-creator-pro/templates/squad-prd-tmpl.md

@@ -1,464 +0,0 @@
-# Squad PRD Template
-
-> **Template ID:** squad-prd-template
-> **Version:** 1.0.0
-> **Purpose:** PRD for squads with >= 10 workflows
-> **Reference:** data/pm-best-practices.md
-
----
-
-# {{SQUAD_NAME}} Squad - Product Requirements Document
-
-**Version:** 1.0.0
-**Created:** {{DATE}}
-**Author:** @squad-chief
-**Status:** Draft | Review | Approved
-
----
-
-## 1. Goals & Context
-
-### 1.1 Goals
-
-> What outcomes does this squad enable?
-
-- [ ] {{GOAL_1}}
-- [ ] {{GOAL_2}}
-- [ ] {{GOAL_3}}
-
-### 1.2 Background Context
-
-> 1-2 paragraphs on the problem being solved
-
-{{BACKGROUND_CONTEXT}}
-
-**Key Questions Answered:**
-- Why does this squad need to exist?
-- What pain exists today without it?
-- What's the opportunity cost of NOT building this?
-
-### 1.3 Change Log
-
-| Date | Version | Description | Author |
-|------|---------|-------------|--------|
-| {{DATE}} | 1.0.0 | Initial PRD | @squad-chief |
-
----
-
-## 2. Domain Analysis
-
-### 2.1 Workflows Mapped
-
-> Complete list of ALL workflows this squad handles
-
-| # | Workflow | Category | Frequency | Complexity | Automatizável |
-|---|----------|----------|-----------|------------|---------------|
-| 1.1 | {{WORKFLOW}} | {{CATEGORY}} | {{FREQ}} | {{COMPLEX}} | {{AUTO_PCT}} |
-| ... | ... | ... | ... | ... | ... |
-
-**Total Workflows:** {{TOTAL}}
-**High Automation (>80%):** {{COUNT}} ({{PCT}}%)
-**Medium Automation (50-80%):** {{COUNT}} ({{PCT}}%)
-**Low Automation (<50%):** {{COUNT}} ({{PCT}}%)
-
-### 2.2 Workflow Categories
-
-```yaml
-categories:
-  {{CATEGORY_1}}:
-    count: {{N}}
-    workflows: [{{LIST}}]
-    automation_avg: {{PCT}}%
-
-  {{CATEGORY_2}}:
-    count: {{N}}
-    workflows: [{{LIST}}]
-    automation_avg: {{PCT}}%
-```
-
----
-
-## 3. Elite Minds
-
-### 3.1 Research Summary
-
-| Mind | Tier | Domain | Framework Documented | Score |
-|------|------|--------|---------------------|-------|
-| {{MIND_1}} | Tier 0 | {{DOMAIN}} | {{FRAMEWORK}} | {{SCORE}}/15 |
-| {{MIND_2}} | Tier 1 | {{DOMAIN}} | {{FRAMEWORK}} | {{SCORE}}/15 |
-| ... | ... | ... | ... | ... |
-
-### 3.2 Tier Distribution
-
-```yaml
-tier_distribution:
-  tier_0:
-    purpose: "Diagnosis, Classification, Onboarding"
-    minds: [{{LIST}}]
-    coverage: "{{WHAT_THEY_COVER}}"
-
-  tier_1:
-    purpose: "Masters with proven results"
-    minds: [{{LIST}}]
-    coverage: "{{WHAT_THEY_COVER}}"
-
-  tier_2:
-    purpose: "Systematizers, Framework creators"
-    minds: [{{LIST}}]
-    coverage: "{{WHAT_THEY_COVER}}"
-
-  tier_3:
-    purpose: "Format/Channel specialists"
-    minds: [{{LIST}}]
-    coverage: "{{WHAT_THEY_COVER}}"
-```
-
-### 3.3 Gap Analysis
-
-| Gap | Impact | Mitigation |
-|-----|--------|------------|
-| {{GAP}} | {{IMPACT}} | {{MITIGATION}} |
-
----
-
-## 4. Agent Architecture
-
-### 4.1 Orchestrator
-
-```yaml
-orchestrator:
-  name: "{{PACK_NAME}}-chief"
-  purpose: "Coordinates all agents, routes requests"
-  tier: "orchestrator"
-  capabilities:
-    - "Route requests to appropriate tier"
-    - "Manage multi-agent workflows"
-    - "Track context across handoffs"
-```
-
-### 4.2 Agents by Tier
-
-```yaml
-agents:
-  tier_0:
-    - id: "{{AGENT_ID}}"
-      name: "{{AGENT_NAME}}"
-      based_on: "{{MIND_NAME}}"
-      workflows: [{{WORKFLOW_IDS}}]
-      purpose: "{{PURPOSE}}"
-
-  tier_1:
-    - id: "{{AGENT_ID}}"
-      name: "{{AGENT_NAME}}"
-      based_on: "{{MIND_NAME}}"
-      workflows: [{{WORKFLOW_IDS}}]
-      purpose: "{{PURPOSE}}"
-
-  tier_2:
-    # ...
-
-  tier_3:
-    # ...
-```
-
-### 4.3 Handoff Map
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                      HANDOFF ARCHITECTURE                        │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  User Request                                                   │
-│       ↓                                                         │
-│  @{{PACK_NAME}}-chief (Orchestrator)                           │
-│       ↓                                                         │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │ Tier 0: Diagnosis                                        │   │
-│  │ {{AGENT_1}} → {{AGENT_2}}                               │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│       ↓                                                         │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │ Tier 1: Execution                                        │   │
-│  │ {{AGENT_3}} ←→ {{AGENT_4}}                              │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│       ↓                                                         │
-│  Output to User                                                 │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### 4.4 Workflow → Agent Matrix
-
-| Workflow | Primary Agent | Support Agent | Quality Gate |
-|----------|---------------|---------------|--------------|
-| {{WORKFLOW}} | @{{AGENT}} | @{{AGENT}} | {{GATE}} |
-| ... | ... | ... | ... |
-
-**Coverage Check:**
-- [ ] All {{TOTAL}} workflows assigned to at least 1 agent
-- [ ] No orphan workflows
-- [ ] No orphan agents
-
----
-
-## 5. Epic List
-
-> High-level list of epics for phased implementation
-
-### Overview
-
-| Epic | Title | Agents | Workflows | Estimated Effort |
-|------|-------|--------|-----------|------------------|
-| 1 | Foundation + Orchestrator | 1-2 | 0 | {{EFFORT}} |
-| 2 | {{TITLE}} | {{N}} | {{N}} | {{EFFORT}} |
-| 3 | {{TITLE}} | {{N}} | {{N}} | {{EFFORT}} |
-| ... | ... | ... | ... | ... |
-
-### Epic Dependencies
-
-```
-Epic 1 (Foundation)
-    ↓
-Epic 2 (Tier 0)
-    ↓
-Epic 3 (Tier 1a) ←→ Epic 4 (Tier 1b)
-    ↓
-Epic 5 (Tier 2)
-    ↓
-Epic 6 (Tier 3)
-```
-
----
-
-## 6. Epic Details
-
-### Epic 1: Foundation + Orchestrator
-
-**Goal:** Establish squad infrastructure and create orchestrator agent that routes all requests.
-
-**Deliverables:**
-- [ ] Directory structure (`squads/{{PACK_NAME}}/`)
-- [ ] `config.yaml` with pack metadata
-- [ ] `README.md` with usage documentation
-- [ ] Orchestrator agent (`{{PACK_NAME}}-chief`)
-- [ ] Core data files (KB, frameworks)
-
-**Stories:**
-
-#### Story 1.1: Create Squad Structure
-
-**As a** squad user
-**I want** the squad directory properly structured
-**So that** all components have consistent locations
-
-**Acceptance Criteria:**
-- [ ] `squads/{{PACK_NAME}}/` directory created
-- [ ] All subdirectories exist (agents/, tasks/, workflows/, etc.)
-- [ ] `config.yaml` valid and complete
-- [ ] `README.md` with activation instructions
-
-**Quality Gates:**
-- Pre-Commit: Structure validation
-- Specialist: @squad-chief
-
----
-
-#### Story 1.2: Create Orchestrator Agent
-
-**As a** squad user
-**I want** an orchestrator that routes my requests
-**So that** I don't need to know which agent to call
-
-**Execution:**
-```yaml
-workflow: "create-agent.md"
-type: "functional"
-inputs:
-  agent_id: "{{PACK_NAME}}-chief"
-  tier: "orchestrator"
-  purpose: "Route requests to appropriate tier agents"
-template: "templates/agent-tmpl.md"
-```
-
-**Acceptance Criteria:**
-- [ ] `agents/{{PACK_NAME}}-chief.md` created
-- [ ] Agent >= 400 lines
-- [ ] Routing logic for all tiers defined
-- [ ] `*help` command lists all capabilities
-
-**Quality Gates:**
-- Pre-Commit: SC_AGT_001 (Agent Quality)
-- Specialist: @squad-chief
-
----
-
-### CRITICAL: Story Pattern for Agent Creation
-
-> **REGRA:** Stories de criação de agent NUNCA devem especificar o agent inline.
-> Devem REFERENCIAR o workflow de criação.
-
-**Template a usar:** `templates/story-create-agent-tmpl.md`
-
-```yaml
-# ❌ ERRADO - Especificação inline (gera agents genéricos)
-story_antiga:
-  conteudo: |
-    agent:
-      name: "X"
-      # 200 linhas de YAML do agent completo
-      # Executor apenas copia
-
-# ✅ CORRETO - Referência a workflow (gera agents com profundidade)
-story_nova:
-  workflow: "wf-clone-mind.yaml | create-agent.md"
-  type: "mind_clone | functional"
-  inputs: [agent_id, domain, sources_path, ...]
-  quality_gates: [SC_AGT_001, SC_AGT_002, SC_AGT_003, SMOKE_TEST]
-```
-
-**Quality Gate SC_AGT_003 (Depth Gate) - NOVO:**
-```yaml
-SC_AGT_003:
-  name: "Agent Depth Quality"
-  blocking: true
-  criteria:
-    - "Frameworks têm TEORIA (o porquê), não só passos"
-    - "Heurísticas têm EXEMPLOS de aplicação real"
-    - "Voice DNA é distinguível (não genérico)"
-    - "Anti-patterns têm RAZÃO explicada"
-    - "Agent NÃO poderia ser confundido com outro genérico"
-```
-
----
-
-### Epic 2: {{EPIC_TITLE}}
-
-**Goal:** {{EPIC_GOAL}}
-
-**Deliverables:**
-- [ ] {{DELIVERABLE_1}}
-- [ ] {{DELIVERABLE_2}}
-
-**Stories:**
-
-#### Story 2.1: {{STORY_TITLE}}
-
-**As a** {{USER_TYPE}}
-**I want** {{ACTION}}
-**So that** {{BENEFIT}}
-
-**Acceptance Criteria:**
-- [ ] {{CRITERION_1}}
-- [ ] {{CRITERION_2}}
-
-**Quality Gates:**
-- Pre-Commit: {{GATE}}
-- Specialist: @{{SPECIALIST}}
-
----
-
-<!-- Repeat for all epics -->
-
----
-
-## 7. Success Criteria
-
-### 7.1 Coverage Metrics
-
-| Metric | Target | Measurement |
-|--------|--------|-------------|
-| Workflow Coverage | 100% | All {{TOTAL}} workflows have assigned agent |
-| Automation Rate | >= 70% | High-automation workflows functional |
-| Agent Quality | >= 7.0 | All agents pass quality gate |
-
-### 7.2 Functional Criteria
-
-- [ ] User can activate squad with `/{{PACK_NAME}}`
-- [ ] Orchestrator routes to correct agent
-- [ ] All Tier 0 workflows functional
-- [ ] All Tier 1 workflows functional
-- [ ] Documentation complete
-
-### 7.3 Quality Criteria
-
-- [ ] All agents have voice_dna
-- [ ] All agents have output_examples >= 3
-- [ ] All workflows have checkpoints
-- [ ] No orphan dependencies
-
----
-
-## 8. Risks & Mitigations
-
-| # | Risk | Impact | Probability | Mitigation | Rollback |
-|---|------|--------|-------------|------------|----------|
-| 1 | {{RISK}} | High/Med/Low | High/Med/Low | {{MITIGATION}} | {{ROLLBACK}} |
-| 2 | ... | ... | ... | ... | ... |
-
----
-
-## 9. Next Steps
-
-### After PRD Approval
-
-1. **Create Epic 1 issues/stories** in project management
-2. **Invoke:** `@squad-chief *create-squad {{PACK_NAME}} --epic=1`
-3. **Validate:** After each epic, run `*validate-squad {{PACK_NAME}}`
-4. **Iterate:** Proceed to next epic after validation passes
-
-### Handoff
-
-- **To @squad-chief:** Implement Epic 1
-- **To @oalanicolas:** Clone minds for Tier 0 agents
-- **To @pedro-valerio:** Validate workflow quality gates
-
----
-
-## Appendix A: Research Sources
-
-| Mind | Source Type | Source | Quality |
-|------|-------------|--------|---------|
-| {{MIND}} | Book | {{TITLE}} | Ouro |
-| {{MIND}} | Interview | {{TITLE}} | Bronze |
-
----
-
-## Appendix B: PRD Checklist
-
-### Problem Definition
-- [ ] Clear problem articulation
-- [ ] Target user identified
-- [ ] Success metrics defined
-
-### Domain Analysis
-- [ ] ALL workflows mapped
-- [ ] Categories defined
-- [ ] Automation assessed
-
-### Elite Minds
-- [ ] >= 3 minds identified
-- [ ] Frameworks documented
-- [ ] Tier coverage complete
-
-### Agent Architecture
-- [ ] Orchestrator defined
-- [ ] Handoff map complete
-- [ ] No orphan agents/workflows
-
-### Epic Structure
-- [ ] Epic 1 = Foundation
-- [ ] Sequential dependencies
-- [ ] Each epic delivers value
-
-### Quality
-- [ ] Gates defined per story
-- [ ] Specialists assigned
-- [ ] Success criteria measurable
-
-**Score:** __/6 categories
-**Threshold:** >= 5/6 to approve
-
----
-
-*Squad PRD Template v1.0*
-*Reference: data/pm-best-practices.md*

package/pro/squads/squad-creator-pro/templates/squad-readme-tmpl.md

@@ -1,170 +0,0 @@
-# {{squad_name}}
-
-> {{short_description}}
-
-**Pattern:** SC-DP-003 (Squad README)
-
----
-
-## Visão Geral
-
-{{description}}
-
-### Propósito
-
-{{proposito}}
-
-### Domínio
-
-{{dominio}}
-
----
-
-## Agents
-
-| Agent | Ícone | Papel | Comandos Principais |
-|-------|-------|-------|---------------------|
-| @{{agent_1_id}} | {{agent_1_icon}} | {{agent_1_papel}} | `*{{agent_1_cmd_1}}`, `*{{agent_1_cmd_2}}` |
-| @{{agent_2_id}} | {{agent_2_icon}} | {{agent_2_papel}} | `*{{agent_2_cmd_1}}`, `*{{agent_2_cmd_2}}` |
-
----
-
-## Estrutura
-
-```
-squads/{{squad_slug}}/
-├── agents/                 # Definições de agents
-│   ├── {{agent_1_id}}.md
-│   └── {{agent_2_id}}.md
-├── tasks/                  # Tasks executáveis
-│   ├── {{task_1}}.md
-│   └── {{task_2}}.md
-├── checklists/             # Validações
-│   └── {{checklist_1}}.md
-├── workflows/              # Orquestrações
-│   └── {{workflow_1}}.yaml
-├── sops/                   # Procedimentos
-│   └── {{sop_1}}.md
-├── templates/              # Templates reutilizáveis
-│   └── {{template_1}}.md
-├── data/                   # Dados e knowledge bases
-│   └── {{data_1}}.yaml
-├── docs/                   # Documentação do squad
-│   └── {{doc_1}}.md
-├── config.yaml             # Configuração do squad
-└── README.md               # Este arquivo
-```
-
----
-
-## Quick Start
-
-```bash
-# 1. Ativar agent principal
-@{{main_agent}}
-
-# 2. Ver comandos disponíveis
-*help
-
-# 3. Executar comando mais comum
-*{{main_command}} {argumentos}
-```
-
-### Exemplo de Uso
-
-```
-User: @{{main_agent}}
-Agent: {{greeting}}
-
-User: *{{example_command}}
-Agent: {{example_output}}
-```
-
----
-
-## Workflows Disponíveis
-
-| Workflow | Arquivo | Trigger | Descrição |
-|----------|---------|---------|-----------|
-| {{workflow_1_name}} | `workflows/{{workflow_1}}.yaml` | `*{{workflow_1_trigger}}` | {{workflow_1_desc}} |
-| {{workflow_2_name}} | `workflows/{{workflow_2}}.yaml` | `*{{workflow_2_trigger}}` | {{workflow_2_desc}} |
-
----
-
-## Comandos por Agent
-
-### @{{agent_1_id}}
-
-| Comando | Descrição |
-|---------|-----------|
-| `*{{cmd_1}}` | {{cmd_1_desc}} |
-| `*{{cmd_2}}` | {{cmd_2_desc}} |
-| `*help` | Lista todos os comandos |
-
-### @{{agent_2_id}}
-
-| Comando | Descrição |
-|---------|-----------|
-| `*{{cmd_3}}` | {{cmd_3_desc}} |
-| `*{{cmd_4}}` | {{cmd_4_desc}} |
-
----
-
-## Veto Conditions
-
-| Trigger | Ação | Agent |
-|---------|------|-------|
-| {{veto_1_trigger}} | {{veto_1_action}} | @{{veto_1_agent}} |
-| {{veto_2_trigger}} | {{veto_2_action}} | @{{veto_2_agent}} |
-
----
-
-## Documentação Completa
-
-| Documento | Descrição | Caminho |
-|-----------|-----------|---------|
-| Agent Flows | Como cada agent funciona | `docs/` |
-| Workflow Docs | Documentação de workflows | `docs/` |
-| Concepts | Conceitos fundamentais | `docs/CONCEPTS.md` |
-| FAQ | Perguntas frequentes | `docs/FAQ.md` |
-
----
-
-## Integrações
-
-### Com Outros Squads
-
-| Squad | Tipo | Descrição |
-|-------|------|-----------|
-| {{integration_squad_1}} | {{integration_type_1}} | {{integration_desc_1}} |
-
-### Com Ferramentas
-
-| Ferramenta | Uso |
-|------------|-----|
-| {{tool_1}} | {{tool_1_uso}} |
-| {{tool_2}} | {{tool_2_uso}} |
-
----
-
-## Changelog
-
-| Data | Versão | Mudanças |
-|------|--------|----------|
-| {{date}} | 1.0.0 | Release inicial |
-
----
-
-## Contribuição
-
-Para contribuir com este squad:
-
-1. Seguir estrutura de arquivos padrão
-2. Documentar novos agents/tasks
-3. Atualizar este README
-4. Validar com checklist do squad
-
----
-
-*Squad criado seguindo SC-DP-003 (Squad README)*
-*"{{squad_motto}}"*