create-genia-os 2.1.0 → 2.2.0

package/template/.genia/skills/dev/mcp-builder.md

@@ -1,172 +1,172 @@
-# Skill: /mcp-builder
-
-## Metadata
-- **Nome**: MCP Server Builder
-- **Comando**: /mcp-builder
-- **Agente**: @dev
-- **Categoria**: dev
-- **Versao**: 2.0
-
-## Descricao
-Guia para criar servidores MCP (Model Context Protocol) de alta qualidade que permitem LLMs interagirem com servicos externos atraves de tools bem projetadas.
-
-## Quando Usar
-- Construir servidores MCP
-- Integrar APIs externas
-- Criar tools para LLMs
-- Python (FastMCP) ou TypeScript (MCP SDK)
-
-## Stack Recomendada
-
-- **Linguagem**: TypeScript (melhor suporte SDK)
-- **Transport**: Streamable HTTP para servidores remotos, stdio para locais
-
-## Workflow de Alto Nivel
-
-### Fase 1: Pesquisa e Planejamento
-
-#### 1.1 Design MCP Moderno
-- **API Coverage vs Workflow Tools**: Balancear cobertura de endpoints com tools de workflow
-- **Naming**: Prefixos consistentes (`github_create_issue`, `github_list_repos`)
-- **Contexto**: Retornar dados focados e relevantes
-- **Erros**: Mensagens que guiam para solucoes
-
-#### 1.2 Documentacao MCP
-```
-Sitemap: https://modelcontextprotocol.io/sitemap.xml
-Paginas: https://modelcontextprotocol.io/specification/draft.md
-```
-
-#### 1.3 Documentacao SDK
-- **TypeScript**: https://github.com/modelcontextprotocol/typescript-sdk
-- **Python**: https://github.com/modelcontextprotocol/python-sdk
-
-### Fase 2: Implementacao
-
-#### 2.1 Estrutura do Projeto (TypeScript)
-```
-mcp-server/
-├── src/
-│   ├── index.ts        # Entry point
-│   ├── tools/          # Tools definitions
-│   ├── resources/      # Resources
-│   └── utils/          # Helpers
-├── package.json
-└── tsconfig.json
-```
-
-#### 2.2 Infraestrutura Core
-- Cliente API com autenticacao
-- Helpers de error handling
-- Formatacao de resposta (JSON/Markdown)
-- Suporte a paginacao
-
-#### 2.3 Implementar Tools
-
-**Input Schema** (Zod para TypeScript, Pydantic para Python):
-```typescript
-const schema = z.object({
-  query: z.string().describe("Search query"),
-  limit: z.number().optional().default(10)
-});
-```
-
-**Annotations**:
-- `readOnlyHint`: true/false
-- `destructiveHint`: true/false
-- `idempotentHint`: true/false
-
-### Fase 3: Review e Teste
-
-#### 3.1 Qualidade de Codigo
-- Sem codigo duplicado (DRY)
-- Error handling consistente
-- Cobertura de tipos completa
-- Descricoes de tools claras
-
-#### 3.2 Build e Teste
-```bash
-# TypeScript
-npm run build
-npx @modelcontextprotocol/inspector
-
-# Python
-python -m py_compile server.py
-```
-
-### Fase 4: Avaliacoes
-
-Criar 10 perguntas de avaliacao:
-- Independentes
-- Read-only
-- Complexas (multiplas tool calls)
-- Realisticas
-- Verificaveis
-
-**Formato XML**:
-```xml
-<evaluation>
-  <qa_pair>
-    <question>Pergunta complexa aqui?</question>
-    <answer>Resposta verificavel</answer>
-  </qa_pair>
-</evaluation>
-```
-
-## Exemplo TypeScript
-
-```typescript
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-
-const server = new McpServer({
-  name: "my-mcp-server",
-  version: "1.0.0"
-});
-
-server.registerTool({
-  name: "search_items",
-  description: "Search for items by query",
-  inputSchema: z.object({
-    query: z.string(),
-    limit: z.number().optional()
-  }),
-  handler: async ({ query, limit = 10 }) => {
-    const results = await api.search(query, limit);
-    return {
-      content: [{ type: "text", text: JSON.stringify(results) }]
-    };
-  }
-});
-```
-
-## Exemplo Python (FastMCP)
-
-```python
-from fastmcp import FastMCP
-from pydantic import BaseModel
-
-mcp = FastMCP("my-server")
-
-class SearchInput(BaseModel):
-    query: str
-    limit: int = 10
-
-@mcp.tool
-async def search_items(input: SearchInput) -> str:
-    results = await api.search(input.query, input.limit)
-    return json.dumps(results)
-```
-
-## Recursos de Referencia
-- `reference/mcp_best_practices.md` - Guidelines universais
-- `reference/node_mcp_server.md` - Guia TypeScript
-- `reference/python_mcp_server.md` - Guia Python
-- `reference/evaluation.md` - Guia de avaliacoes
-
-## Tasks Relacionadas
-- task:criar-mcp-server
-- task:integrar-api-externa
-
-## Workflows
-- workflow:desenvolvimento-integracao
+# Skill: /mcp-builder
+
+## Metadata
+- **Nome**: MCP Server Builder
+- **Comando**: /mcp-builder
+- **Agente**: @dev
+- **Categoria**: dev
+- **Versao**: 2.0
+
+## Descricao
+Guia para criar servidores MCP (Model Context Protocol) de alta qualidade que permitem LLMs interagirem com servicos externos atraves de tools bem projetadas.
+
+## Quando Usar
+- Construir servidores MCP
+- Integrar APIs externas
+- Criar tools para LLMs
+- Python (FastMCP) ou TypeScript (MCP SDK)
+
+## Stack Recomendada
+
+- **Linguagem**: TypeScript (melhor suporte SDK)
+- **Transport**: Streamable HTTP para servidores remotos, stdio para locais
+
+## Workflow de Alto Nivel
+
+### Fase 1: Pesquisa e Planejamento
+
+#### 1.1 Design MCP Moderno
+- **API Coverage vs Workflow Tools**: Balancear cobertura de endpoints com tools de workflow
+- **Naming**: Prefixos consistentes (`github_create_issue`, `github_list_repos`)
+- **Contexto**: Retornar dados focados e relevantes
+- **Erros**: Mensagens que guiam para solucoes
+
+#### 1.2 Documentacao MCP
+```
+Sitemap: https://modelcontextprotocol.io/sitemap.xml
+Paginas: https://modelcontextprotocol.io/specification/draft.md
+```
+
+#### 1.3 Documentacao SDK
+- **TypeScript**: https://github.com/modelcontextprotocol/typescript-sdk
+- **Python**: https://github.com/modelcontextprotocol/python-sdk
+
+### Fase 2: Implementacao
+
+#### 2.1 Estrutura do Projeto (TypeScript)
+```
+mcp-server/
+├── src/
+│   ├── index.ts        # Entry point
+│   ├── tools/          # Tools definitions
+│   ├── resources/      # Resources
+│   └── utils/          # Helpers
+├── package.json
+└── tsconfig.json
+```
+
+#### 2.2 Infraestrutura Core
+- Cliente API com autenticacao
+- Helpers de error handling
+- Formatacao de resposta (JSON/Markdown)
+- Suporte a paginacao
+
+#### 2.3 Implementar Tools
+
+**Input Schema** (Zod para TypeScript, Pydantic para Python):
+```typescript
+const schema = z.object({
+  query: z.string().describe("Search query"),
+  limit: z.number().optional().default(10)
+});
+```
+
+**Annotations**:
+- `readOnlyHint`: true/false
+- `destructiveHint`: true/false
+- `idempotentHint`: true/false
+
+### Fase 3: Review e Teste
+
+#### 3.1 Qualidade de Codigo
+- Sem codigo duplicado (DRY)
+- Error handling consistente
+- Cobertura de tipos completa
+- Descricoes de tools claras
+
+#### 3.2 Build e Teste
+```bash
+# TypeScript
+npm run build
+npx @modelcontextprotocol/inspector
+
+# Python
+python -m py_compile server.py
+```
+
+### Fase 4: Avaliacoes
+
+Criar 10 perguntas de avaliacao:
+- Independentes
+- Read-only
+- Complexas (multiplas tool calls)
+- Realisticas
+- Verificaveis
+
+**Formato XML**:
+```xml
+<evaluation>
+  <qa_pair>
+    <question>Pergunta complexa aqui?</question>
+    <answer>Resposta verificavel</answer>
+  </qa_pair>
+</evaluation>
+```
+
+## Exemplo TypeScript
+
+```typescript
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+const server = new McpServer({
+  name: "my-mcp-server",
+  version: "1.0.0"
+});
+
+server.registerTool({
+  name: "search_items",
+  description: "Search for items by query",
+  inputSchema: z.object({
+    query: z.string(),
+    limit: z.number().optional()
+  }),
+  handler: async ({ query, limit = 10 }) => {
+    const results = await api.search(query, limit);
+    return {
+      content: [{ type: "text", text: JSON.stringify(results) }]
+    };
+  }
+});
+```
+
+## Exemplo Python (FastMCP)
+
+```python
+from fastmcp import FastMCP
+from pydantic import BaseModel
+
+mcp = FastMCP("my-server")
+
+class SearchInput(BaseModel):
+    query: str
+    limit: int = 10
+
+@mcp.tool
+async def search_items(input: SearchInput) -> str:
+    results = await api.search(input.query, input.limit)
+    return json.dumps(results)
+```
+
+## Recursos de Referencia
+- `reference/mcp_best_practices.md` - Guidelines universais
+- `reference/node_mcp_server.md` - Guia TypeScript
+- `reference/python_mcp_server.md` - Guia Python
+- `reference/evaluation.md` - Guia de avaliacoes
+
+## Tasks Relacionadas
+- task:criar-mcp-server
+- task:integrar-api-externa
+
+## Workflows
+- workflow:desenvolvimento-integracao

package/template/.genia/skills/dev/webapp-testing.md

@@ -1,150 +1,150 @@
-# Skill: /webapp-testing
-
-## Metadata
-- **Nome**: Web Application Testing
-- **Comando**: /webapp-testing
-- **Agente**: @qa
-- **Categoria**: dev
-- **Versao**: 2.0
-
-## Descricao
-Toolkit para interagir e testar aplicacoes web locais usando Playwright. Suporta verificacao de funcionalidade frontend, debug de comportamento UI, capturas de tela e logs do browser.
-
-## Quando Usar
-- Testar aplicacoes web locais
-- Verificar funcionalidade frontend
-- Debugar comportamento de UI
-- Capturar screenshots
-- Ver logs do browser
-
-## Scripts Helper
-
-- `scripts/with_server.py` - Gerencia lifecycle do servidor
-
-**Sempre rodar scripts com `--help` primeiro** para ver uso.
-
-## Arvore de Decisao
-
-```
-Tarefa → E HTML estatico?
-├── Sim → Ler arquivo HTML para identificar selectors
-│         ├── Sucesso → Escrever script Playwright
-│         └── Falha → Tratar como dinamico
-│
-└── Nao (webapp dinamico) → Servidor ja rodando?
-    ├── Nao → Rodar: python scripts/with_server.py --help
-    │         Usar helper + script Playwright simplificado
-    │
-    └── Sim → Reconhecimento-depois-acao:
-        1. Navegar e esperar networkidle
-        2. Screenshot ou inspecionar DOM
-        3. Identificar selectors do estado renderizado
-        4. Executar acoes com selectors descobertos
-```
-
-## Usando with_server.py
-
-### Servidor Unico
-```bash
-python scripts/with_server.py --server "npm run dev" --port 5173 -- python automation.py
-```
-
-### Multiplos Servidores (backend + frontend)
-```bash
-python scripts/with_server.py \
-  --server "cd backend && python server.py" --port 3000 \
-  --server "cd frontend && npm run dev" --port 5173 \
-  -- python automation.py
-```
-
-## Script de Automacao
-
-```python
-from playwright.sync_api import sync_playwright
-
-with sync_playwright() as p:
-    browser = p.chromium.launch(headless=True)  # Sempre headless
-    page = browser.new_page()
-    page.goto('http://localhost:5173')
-    page.wait_for_load_state('networkidle')  # CRITICO: Esperar JS executar
-
-    # ... logica de automacao
-
-    browser.close()
-```
-
-## Padrao Reconhecimento-Depois-Acao
-
-### 1. Inspecionar DOM renderizado
-```python
-page.screenshot(path='/tmp/inspect.png', full_page=True)
-content = page.content()
-page.locator('button').all()
-```
-
-### 2. Identificar selectors dos resultados
-
-### 3. Executar acoes com selectors descobertos
-
-## Armadilha Comum
-
-**NAO** inspecionar DOM antes de esperar `networkidle` em apps dinamicos
-
-**SIM** esperar `page.wait_for_load_state('networkidle')` antes de inspecao
-
-## Best Practices
-
-- Usar scripts bundled como caixas pretas
-- Usar `sync_playwright()` para scripts sincronos
-- Sempre fechar browser quando terminar
-- Usar selectors descritivos: `text=`, `role=`, CSS, IDs
-- Adicionar waits apropriados: `wait_for_selector()`, `wait_for_timeout()`
-
-## Exemplos de Selectors
-
-```python
-# Por texto
-page.click('text=Submit')
-
-# Por role
-page.get_by_role('button', name='Submit').click()
-
-# Por CSS
-page.click('.btn-primary')
-page.click('#submit-button')
-
-# Por data-testid
-page.click('[data-testid="submit-btn"]')
-```
-
-## Capturando Logs do Console
-
-```python
-page.on('console', lambda msg: print(f"Console: {msg.text}"))
-page.goto('http://localhost:5173')
-```
-
-## Screenshots
-
-```python
-# Pagina inteira
-page.screenshot(path='screenshot.png', full_page=True)
-
-# Elemento especifico
-page.locator('.card').screenshot(path='card.png')
-```
-
-## Arquivos de Referencia
-
-- `examples/element_discovery.py` - Descobrir botoes, links, inputs
-- `examples/static_html_automation.py` - Usar file:// URLs
-- `examples/console_logging.py` - Capturar logs do console
-
-## Tasks Relacionadas
-- task:testar-frontend
-- task:automacao-e2e
-- task:debug-ui
-
-## Workflows
-- workflow:qa-automatizado
-- workflow:validacao-frontend
+# Skill: /webapp-testing
+
+## Metadata
+- **Nome**: Web Application Testing
+- **Comando**: /webapp-testing
+- **Agente**: @qa
+- **Categoria**: dev
+- **Versao**: 2.0
+
+## Descricao
+Toolkit para interagir e testar aplicacoes web locais usando Playwright. Suporta verificacao de funcionalidade frontend, debug de comportamento UI, capturas de tela e logs do browser.
+
+## Quando Usar
+- Testar aplicacoes web locais
+- Verificar funcionalidade frontend
+- Debugar comportamento de UI
+- Capturar screenshots
+- Ver logs do browser
+
+## Scripts Helper
+
+- `scripts/with_server.py` - Gerencia lifecycle do servidor
+
+**Sempre rodar scripts com `--help` primeiro** para ver uso.
+
+## Arvore de Decisao
+
+```
+Tarefa → E HTML estatico?
+├── Sim → Ler arquivo HTML para identificar selectors
+│         ├── Sucesso → Escrever script Playwright
+│         └── Falha → Tratar como dinamico
+│
+└── Nao (webapp dinamico) → Servidor ja rodando?
+    ├── Nao → Rodar: python scripts/with_server.py --help
+    │         Usar helper + script Playwright simplificado
+    │
+    └── Sim → Reconhecimento-depois-acao:
+        1. Navegar e esperar networkidle
+        2. Screenshot ou inspecionar DOM
+        3. Identificar selectors do estado renderizado
+        4. Executar acoes com selectors descobertos
+```
+
+## Usando with_server.py
+
+### Servidor Unico
+```bash
+python scripts/with_server.py --server "npm run dev" --port 5173 -- python automation.py
+```
+
+### Multiplos Servidores (backend + frontend)
+```bash
+python scripts/with_server.py \
+  --server "cd backend && python server.py" --port 3000 \
+  --server "cd frontend && npm run dev" --port 5173 \
+  -- python automation.py
+```
+
+## Script de Automacao
+
+```python
+from playwright.sync_api import sync_playwright
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)  # Sempre headless
+    page = browser.new_page()
+    page.goto('http://localhost:5173')
+    page.wait_for_load_state('networkidle')  # CRITICO: Esperar JS executar
+
+    # ... logica de automacao
+
+    browser.close()
+```
+
+## Padrao Reconhecimento-Depois-Acao
+
+### 1. Inspecionar DOM renderizado
+```python
+page.screenshot(path='/tmp/inspect.png', full_page=True)
+content = page.content()
+page.locator('button').all()
+```
+
+### 2. Identificar selectors dos resultados
+
+### 3. Executar acoes com selectors descobertos
+
+## Armadilha Comum
+
+**NAO** inspecionar DOM antes de esperar `networkidle` em apps dinamicos
+
+**SIM** esperar `page.wait_for_load_state('networkidle')` antes de inspecao
+
+## Best Practices
+
+- Usar scripts bundled como caixas pretas
+- Usar `sync_playwright()` para scripts sincronos
+- Sempre fechar browser quando terminar
+- Usar selectors descritivos: `text=`, `role=`, CSS, IDs
+- Adicionar waits apropriados: `wait_for_selector()`, `wait_for_timeout()`
+
+## Exemplos de Selectors
+
+```python
+# Por texto
+page.click('text=Submit')
+
+# Por role
+page.get_by_role('button', name='Submit').click()
+
+# Por CSS
+page.click('.btn-primary')
+page.click('#submit-button')
+
+# Por data-testid
+page.click('[data-testid="submit-btn"]')
+```
+
+## Capturando Logs do Console
+
+```python
+page.on('console', lambda msg: print(f"Console: {msg.text}"))
+page.goto('http://localhost:5173')
+```
+
+## Screenshots
+
+```python
+# Pagina inteira
+page.screenshot(path='screenshot.png', full_page=True)
+
+# Elemento especifico
+page.locator('.card').screenshot(path='card.png')
+```
+
+## Arquivos de Referencia
+
+- `examples/element_discovery.py` - Descobrir botoes, links, inputs
+- `examples/static_html_automation.py` - Usar file:// URLs
+- `examples/console_logging.py` - Capturar logs do console
+
+## Tasks Relacionadas
+- task:testar-frontend
+- task:automacao-e2e
+- task:debug-ui
+
+## Workflows
+- workflow:qa-automatizado
+- workflow:validacao-frontend