@onion-architect-ai/cli 4.1.0-beta.1 → 4.1.0-beta.3

package/templates/.cursor/commands/meta/create-agent-express.md

@@ -0,0 +1,83 @@
+---
+name: create-agent-express
+description: Criar agente de forma rápida e simplificada.
+model: sonnet
+category: meta
+tags: [agent, creation, quick]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+# Comando Criar Agente
+
+Você tem a tarefa de criar um novo sub-agente do Claude Code baseado nos requisitos do usuário. Siga esta abordagem sistemática para construir um agente bem estruturado.
+
+## Requisitos do Usuário
+<requirements>
+#$ARGUMENTS
+</requirements>
+
+## Processo
+
+### 1. Entender o Propósito do Agente
+Primeiro, analise o que o usuário quer que este agente faça:
+- Qual é a responsabilidade principal do agente?
+- Que tarefas ele executará?
+- O que torna este agente especializado?
+
+### 2. Definir Configuração do Agente
+Com base nos requisitos, determine:
+- **Nome**: Crie um identificador em minúsculas, separado por hífens
+- **Descrição**: Escreva uma descrição clara e concisa do propósito do agente
+- **Ferramentas**: Selecione as ferramentas apropriadas do conjunto disponível
+
+### 3. Seleção de Ferramentas
+Liste todas as ferramentas disponíveis e pergunte ao usuário quais o sub-agente deve ter acesso:
+
+Ferramentas disponíveis:
+- **Operações de Arquivo**: Read, Write, Edit, MultiEdit, NotebookRead, NotebookEdit
+- **Pesquisa e Navegação**: Glob, Grep, LS
+- **Execução**: Bash, Task
+- **Web**: WebFetch, WebSearch
+- **Desenvolvimento**: ExitPlanMode, TodoWrite
+- **Ferramentas MCP**: Várias ferramentas com prefixo mcp__ para integrações específicas
+
+Apresente essas ferramentas organizadas por categoria e peça ao usuário para selecionar quais são apropriadas para o propósito do agente. Por padrão, use acesso mínimo às ferramentas por segurança.
+
+### 4. Projetar o Prompt do Sistema
+Crie um prompt do sistema detalhado que:
+- Define claramente o papel e expertise do agente
+- Fornece instruções passo a passo para completar suas tarefas
+- Inclui qualquer restrição ou diretriz
+- Especifica requisitos de formato de saída
+- Contém exemplos se úteis
+
+### 5. Criar o Arquivo do Agente
+Gere o arquivo .md com:
+```markdown
+---
+name: [nome-do-agente]
+description: [descrição clara do propósito do agente]
+tools: [lista separada por vírgulas das ferramentas selecionadas]
+---
+
+[Prompt do sistema detalhado com instruções claras]
+```
+IMPORTANTE: a extensão do arquivo deve ser .md, não .yaml
+
+### 6. Implementação
+- Crie o arquivo em `.cursor/agents/[name-agent].md`
+- Torne o prompt do sistema abrangente mas focado
+
+### 7. Confirmar Criação
+Após criar o agente, confirme que o arquivo foi criado com sucesso
+
+## Melhores Práticas
+- Mantenha agentes focados em uma única responsabilidade
+- Escreva prompts do sistema claros e acionáveis
+- Limite o acesso às ferramentas ao que é necessário
+- Inclua exemplos em prompts complexos
+- Considere tratamento de erros e casos extremos
+- Torne os formatos de saída explícitos
+
+Agora, analise os requisitos e comece a criar o agente seguindo este processo.

package/templates/.cursor/commands/meta/create-agent.md

@@ -0,0 +1,210 @@
+---
+name: create-agent
+description: |
+  Criação inteligente de agentes Cursor com análise de contexto.
+  Use para criar novos agentes que se integram ao ecossistema Onion.
+model: sonnet
+
+parameters:
+  - name: agent_name
+    description: Nome do agente em kebab-case
+    required: true
+  - name: category
+    description: Categoria (development/product/meta/compliance/etc)
+    required: false
+  - name: expertise
+    description: Áreas de especialização
+    required: false
+
+category: meta
+tags:
+  - agent-creation
+  - meta
+  - automation
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /meta/create-command
+  - /meta/create-agent-express
+
+related_agents:
+  - agent-creator-specialist
+  - onion
+---
+
+# 🤖 Criar Agente Inteligente
+
+Arquiteto de agentes para criar agentes contextualizados no Sistema Onion.
+
+## 🎯 Objetivo
+
+Criar agentes que se integram ao ecossistema existente seguindo padrões v3.0.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Análise de Contexto
+
+```bash
+# Listar agentes existentes
+ls .cursor/agents/*/*.md | wc -l
+
+# Verificar categoria existe
+ls .cursor/agents/{{category}}/ 2>/dev/null || echo "Nova categoria"
+
+# Verificar duplicação
+grep -l "name: {{agent_name}}" .cursor/agents/**/*.md
+```
+
+### Passo 2: Determinar Categoria
+
+SE `{{category}}` fornecido → usar diretamente
+SENÃO → inferir da expertise:
+
+| Expertise | Categoria |
+|-----------|-----------|
+| react, node, typescript | `development` |
+| tasks, specs, features | `product` |
+| git, branch, pr | `git` |
+| iso, compliance, security | `compliance` |
+| docs, writing | `review` |
+| test, coverage | `testing` |
+| commands, agents | `meta` |
+
+### Passo 3: Gerar Estrutura
+
+Usar template padrão de `common/templates/agent-template.md`:
+
+```yaml
+---
+name: {{agent_name}}
+description: |
+  [Descrição em 2 linhas]
+  Use para [caso de uso principal].
+model: sonnet
+tools:
+  - read_file
+  - write
+  - search_replace
+  - codebase_search
+  - grep
+  - list_dir
+  - web_search
+  - todo_write
+
+color: [cor apropriada]
+priority: [alta/média/baixa]
+category: {{category}}
+
+expertise:
+  - [area-1]
+  - [area-2]
+  - [area-3]
+
+related_agents:
+  - [agente-relacionado-1]
+
+related_commands:
+  - [/comando-relacionado]
+
+version: "3.0.0"
+updated: "[data atual]"
+---
+
+# Você é o [Nome do Agente]
+
+## 🎯 Filosofia Core
+
+[Descrição da filosofia e propósito]
+
+## 🔧 Áreas de Especialização
+
+### 1. [Área 1]
+[Detalhes]
+
+### 2. [Área 2]
+[Detalhes]
+
+## 📋 Processo de Trabalho
+
+[Workflow do agente]
+
+## ⚠️ Regras
+
+- [Regra 1]
+- [Regra 2]
+```
+
+### Passo 4: Validações Obrigatórias
+
+**CRÍTICO**: Executar TODAS as validações antes de criar:
+
+```bash
+# 1. DUPLICAÇÃO - Verificar nome único
+if grep -r "^name: {{agent_name}}$" .cursor/agents/ 2>/dev/null; then
+  echo "❌ ERRO: Agente '{{agent_name}}' já existe!"
+  exit 1
+fi
+
+# 2. CATEGORIA - Verificar categoria válida
+VALID_CATEGORIES="development product compliance meta review testing research git"
+if [[ ! " $VALID_CATEGORIES " =~ " {{category}} " ]]; then
+  echo "❌ ERRO: Categoria '{{category}}' inválida!"
+  echo "Válidas: $VALID_CATEGORIES"
+  exit 1
+fi
+
+# 3. EXPERTISE - Verificar 3-5 áreas
+EXPERTISE_COUNT=$(echo "{{expertise}}" | tr ',' '\n' | wc -l)
+if [ "$EXPERTISE_COUNT" -lt 3 ] || [ "$EXPERTISE_COUNT" -gt 5 ]; then
+  echo "⚠️ AVISO: Expertise deve ter 3-5 áreas (atual: $EXPERTISE_COUNT)"
+fi
+```
+
+**Checklist de Validação:**
+- [ ] Nome único (não existe em `.cursor/agents/`)
+- [ ] Categoria válida (development|product|compliance|meta|review|testing|research|git)
+- [ ] Expertise definida (3-5 áreas)
+- [ ] YAML header completo
+- [ ] < 300 linhas
+
+### Passo 5: Criar Arquivo
+
+```bash
+write .cursor/agents/{{category}}/{{agent_name}}.md
+```
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ AGENTE CRIADO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Arquivo: .cursor/agents/{{category}}/{{agent_name}}.md
+
+📋 Detalhes:
+∟ Nome: {{agent_name}}
+∟ Categoria: {{category}}
+∟ Expertise: [áreas]
+
+🔗 Relacionamentos:
+∟ Agentes: [lista]
+∟ Comandos: [lista]
+
+🚀 Para usar: @{{agent_name}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Template: `common/templates/agent-template.md`
+- Padrões: `docs/knowbase/concepts/ai-agent-design-patterns.md`
+- Agente: @agent-creator-specialist
+
+## ⚠️ Notas
+
+- Sempre validar duplicação antes de criar
+- Usar modelo `sonnet` como padrão
+- Não adicionar MCPs em agentes genéricos

package/templates/.cursor/commands/meta/create-command.md

@@ -0,0 +1,203 @@
+---
+name: create-command
+description: |
+  Criação de novos comandos Cursor com análise de contexto.
+  Use para criar comandos que seguem padrões do Sistema Onion.
+model: sonnet
+
+parameters:
+  - name: command_name
+    description: Nome do comando em kebab-case
+    required: true
+  - name: category
+    description: Categoria (engineer/product/git/docs/meta)
+    required: false
+  - name: description
+    description: Descrição do que o comando faz
+    required: false
+
+category: meta
+tags:
+  - command-creation
+  - meta
+  - automation
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /meta/create-agent
+  - /meta/create-agent-express
+  - /meta/create-abstraction
+
+related_agents:
+  - command-creator-specialist
+  - onion
+---
+
+# 📝 Criar Comando Cursor
+
+Facilitador para criação de comandos seguindo padrões Onion v3.0.
+
+## 🎯 Objetivo
+
+Criar comandos que se integram ao ecossistema existente.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Análise de Contexto
+
+```bash
+# Listar comandos existentes
+ls .cursor/commands/*/*.md | wc -l
+
+# Verificar categoria existe
+ls .cursor/commands/{{category}}/ 2>/dev/null
+
+# Verificar duplicação
+grep -l "name: {{command_name}}" .cursor/commands/**/*.md
+```
+
+### Passo 2: Determinar Categoria
+
+SE `{{category}}` fornecido → usar diretamente
+SENÃO → inferir do propósito:
+
+| Propósito | Categoria |
+|-----------|-----------|
+| Desenvolvimento, código | `engineer` |
+| Tasks, specs, features | `product` |
+| Git, branches, PRs | `git` |
+| Documentação | `docs` |
+| Comandos, agentes | `meta` |
+| Validações | `validate` |
+
+### Passo 3: Gerar Estrutura
+
+Usar template de `common/templates/command-template.md`:
+
+```yaml
+---
+name: {{command_name}}
+description: |
+  [Descrição em 2 linhas]
+  Use para [caso de uso principal].
+model: sonnet
+
+parameters:
+  - name: param1
+    description: [descrição]
+    required: [true/false]
+
+category: {{category}}
+tags:
+  - [tag1]
+  - [tag2]
+
+version: "3.0.0"
+updated: "[data atual]"
+
+related_commands:
+  - /category/comando
+
+related_agents:
+  - agente-relacionado
+---
+
+# [Título do Comando]
+
+[Descrição breve]
+
+## 🎯 Objetivo
+
+[O que este comando faz]
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: [Nome]
+[Instruções]
+
+### Passo 2: [Nome]
+[Instruções]
+
+## 📤 Output Esperado
+
+[Formato de saída]
+
+## 🔗 Referências
+
+- [Referências relevantes]
+
+## ⚠️ Notas
+
+- [Notas importantes]
+```
+
+### Passo 4: Validações Obrigatórias
+
+**CRÍTICO**: Executar TODAS as validações antes de criar:
+
+```bash
+# 1. DUPLICAÇÃO - Verificar nome único
+if grep -r "^name: {{command_name}}$" .cursor/commands/ 2>/dev/null; then
+  echo "❌ ERRO: Comando '{{command_name}}' já existe!"
+  exit 1
+fi
+
+# 2. FORMATO - Verificar kebab-case
+if [[ ! "{{command_name}}" =~ ^[a-z][a-z0-9]*(-[a-z0-9]+)*$ ]]; then
+  echo "❌ ERRO: Nome deve ser kebab-case (ex: my-command)"
+  exit 1
+fi
+
+# 3. CATEGORIA - Verificar categoria válida
+VALID_CATEGORIES="engineer product git docs meta validate quick general"
+if [[ ! " $VALID_CATEGORIES " =~ " {{category}} " ]]; then
+  echo "❌ ERRO: Categoria '{{category}}' inválida!"
+  echo "Válidas: $VALID_CATEGORIES"
+  exit 1
+fi
+```
+
+**Checklist de Validação:**
+- [ ] Nome único (não existe em `.cursor/commands/`)
+- [ ] Nome em kebab-case válido
+- [ ] Categoria válida (engineer|product|git|docs|meta|validate|quick|general)
+- [ ] YAML header completo
+- [ ] < 400 linhas
+- [ ] Seções obrigatórias (Objetivo, Fluxo, Output)
+
+### Passo 5: Criar Arquivo
+
+```bash
+write .cursor/commands/{{category}}/{{command_name}}.md
+```
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ COMANDO CRIADO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Arquivo: .cursor/commands/{{category}}/{{command_name}}.md
+
+📋 Detalhes:
+∟ Nome: {{command_name}}
+∟ Categoria: {{category}}
+∟ Linhas: ~150
+
+🚀 Para usar: /{{category}}/{{command_name}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Template: `common/templates/command-template.md`
+- Agente: @command-creator-specialist
+
+## ⚠️ Notas
+
+- Máximo 400 linhas por comando
+- Usar prompts modulares de `common/prompts/`
+- Sempre validar duplicação antes de criar

package/templates/.cursor/commands/meta/create-knowledge-base.md

@@ -0,0 +1,143 @@
+---
+name: create-knowledge-base
+description: |
+  Criação de bases de conhecimento estruturadas via pesquisa.
+  Use para gerar KBs sobre tecnologias, ferramentas ou conceitos.
+model: sonnet
+
+parameters:
+  - name: topic
+    description: Tema da knowledge base
+    required: true
+  - name: category
+    description: Categoria (technologies/tools/concepts/frameworks)
+    required: false
+
+category: meta
+tags:
+  - knowledge-base
+  - research
+  - documentation
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /docs/build-tech-docs
+
+related_agents:
+  - research-agent
+---
+
+# 📚 Criar Knowledge Base
+
+Geração de bases de conhecimento via pesquisa estruturada.
+
+## 🎯 Objetivo
+
+Criar KBs densas e estruturadas sobre temas específicos.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Análise do Tema
+
+1. **Interpretar requisitos**: Extrair tema de `{{topic}}`
+2. **Determinar categoria**:
+   - `technologies/` - React, Python, etc.
+   - `tools/` - Docker, VSCode, etc.
+   - `concepts/` - Metodologias, padrões
+   - `frameworks/` - NestJS, FastAPI, etc.
+   - `platforms/` - AWS, Azure, etc.
+
+### Passo 2: Validar Estrutura
+
+```bash
+# Verificar docs/knowbase/
+test -d docs/knowbase/ || mkdir -p docs/knowbase/{technologies,tools,concepts,frameworks,platforms}
+
+# Verificar duplicação
+ls docs/knowbase/**/*{{topic}}*.md 2>/dev/null
+```
+
+### Passo 3: Pesquisar
+
+Via @research-agent ou web_search:
+
+1. **Documentação oficial**
+2. **Best practices**
+3. **Exemplos de uso**
+4. **Limitações conhecidas**
+5. **Comparações relevantes**
+
+### Passo 4: Estruturar Conteúdo
+
+```markdown
+# {{topic}} - Knowledge Base
+
+## 📋 Visão Geral
+[O que é, para que serve]
+
+## 🎯 Casos de Uso
+- Caso 1
+- Caso 2
+
+## ⚡ Quick Start
+[Como começar rapidamente]
+
+## 🔧 Configuração
+[Setup e configurações]
+
+## 💡 Best Practices
+[Melhores práticas]
+
+## ⚠️ Limitações
+[Pontos de atenção]
+
+## 🔗 Referências
+- [Link oficial](url)
+- [Docs](url)
+
+---
+**Última atualização**: [data]
+**Fonte principal**: [fonte]
+```
+
+### Passo 5: Salvar
+
+```bash
+write docs/knowbase/{{category}}/{{topic}}.md
+```
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ KNOWLEDGE BASE CRIADA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Arquivo: docs/knowbase/{{category}}/{{topic}}.md
+
+📊 Conteúdo:
+∟ Seções: 7
+∟ Linhas: ~200
+∟ Referências: 5
+
+📚 Fontes Consultadas:
+∟ Documentação oficial
+∟ GitHub
+∟ Stack Overflow
+
+🚀 Para acessar: docs/knowbase/{{category}}/{{topic}}.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Agente: @research-agent
+- Estrutura: `docs/knowbase/`
+
+## ⚠️ Notas
+
+- Sempre incluir data de atualização
+- Citar fontes principais
+- Manter < 400 linhas (dividir se maior)