codehava-agent-kit 1.0.0 → 2.0.0

package/templates/.agent/skills/advogado-especialista/references/fontes.md

@@ -0,0 +1,139 @@
+# Referencias e Fontes — Advogado Especialista Elite
+
+## Legislacao Federal (Ordem Cronologica)
+
+### Constituicao e Codigos
+- Constituicao Federal de 1988 (com emendas ate 2025)
+- Codigo Civil — Lei 10.406/2002
+- Codigo de Processo Civil — Lei 13.105/2015
+- Codigo Penal — Decreto-Lei 2.848/1940
+- Codigo de Processo Penal — Decreto-Lei 3.689/1941
+- CLT — Decreto-Lei 5.452/1943
+- Codigo de Defesa do Consumidor — Lei 8.078/1990
+- Codigo Tributario Nacional — Lei 5.172/1966
+
+### Leis Especiais — Familia
+- Lei 5.478/1968 — Alimentos
+- Lei 6.515/1977 — Divorcio (parcialmente revogada)
+- Lei 8.560/1992 — Investigacao de paternidade
+- Lei 9.278/1996 — Uniao estavel
+- Lei 11.441/2007 — Divorcio/inventario extrajudicial
+- Lei 11.804/2008 — Alimentos gravidicos
+- Lei 12.318/2010 — Alienacao parental
+- Lei 12.398/2011 — Direito de visita dos avos
+- Lei 13.058/2014 — Guarda compartilhada
+- EC 66/2010 — Divorcio direto
+
+### Leis Especiais — Criminal/Maria da Penha
+- Lei 11.340/2006 — Maria da Penha
+- Lei 13.641/2018 — Descumprimento medida protetiva
+- Lei 14.132/2021 — Stalking
+- Lei 14.188/2021 — Violencia psicologica
+- Lei 14.994/2024 — Pacote Antifeminicidio
+- Lei 15.125/2025 — Monitoramento eletronico
+- Lei 15.280/2025 — Medidas protetivas crimes sexuais
+- Lei 8.072/1990 — Crimes hediondos
+- Lei 13.964/2019 — Pacote Anticrime
+- Lei 11.343/2006 — Lei de Drogas
+
+### Leis Especiais — Imobiliario
+- Lei 6.015/1973 — Registros Publicos
+- Lei 4.591/1964 — Condominio/incorporacao
+- Lei 8.245/1991 — Inquilinato
+- Lei 9.514/1997 — Alienacao fiduciaria
+- Lei 8.009/1990 — Bem de familia
+- Lei 10.257/2001 — Estatuto da Cidade
+- Lei 13.465/2017 — REURB
+
+### Leis Especiais — Trabalhista/Previdenciario
+- Lei 8.213/1991 — Beneficios previdenciarios
+- Lei 8.036/1990 — FGTS
+- Lei 4.090/1962 — 13o salario
+- Lei 12.506/2011 — Aviso previo proporcional
+- EC 103/2019 — Reforma previdenciaria
+
+### Leis Especiais — Digital/Empresarial/Administrativo
+- Lei 13.709/2018 — LGPD
+- Lei 12.965/2014 — Marco Civil da Internet
+- Lei 6.404/1976 — Sociedades anonimas
+- Lei 11.101/2005 — Recuperacao judicial e falencia
+- Lei 8.429/1992 — Improbidade administrativa (alterada pela Lei 14.230/2021)
+- Lei 14.133/2021 — Nova lei de licitacoes
+- Lei 6.830/1980 — Execucao fiscal
+- Lei 12.016/2009 — Mandado de seguranca
+
+### Leis Especiais — Consumidor/Responsabilidade
+- Lei 8.078/1990 — CDC
+- Lei 13.718/2018 — Revenge porn
+- Lei 12.737/2012 — Crimes informaticos (Carolina Dieckmann)
+
+## Jurisprudencia Consolidada
+
+### STJ — Familia
+- Sumula 301: Recusa DNA = presuncao paternidade
+- Sumula 309: Prisao civil = ultimos 3 meses de alimentos
+- Sumula 336: Alimentos devidos desde citacao
+- Sumula 364: Bem de familia protege solteiro/viuvo
+- Sumula 377 STF: Separacao obrigatoria — aquestos comunicam
+- Sumula 596: Alimentos transitivos entre ex-conjuges
+- REsp 1.954.279: Alimentos compensatorios
+- REsp 1.629.994: Guarda compartilhada nao exclui alimentos
+
+### STJ — Responsabilidade Civil
+- Sumula 37: Cumulacao dano moral + material
+- Sumula 227: PJ pode sofrer dano moral
+- Sumula 370: Cirurgia plastica = obrigacao de resultado
+- Sumula 385: Negativacao anterior exclui novo dano moral
+- Sumula 387: Cumulacao dano estetico + dano moral
+- Tema 983: Dano moral minimo em violencia domestica
+
+### STJ — Consumidor
+- Sumula 297: CDC aplica-se a bancos
+- Sumula 302: Carencia em plano de saude — urgencia afasta
+- Sumula 532: Notificacao previa obrigatoria para cadastro negativo
+
+### STJ — Criminal/Maria da Penha
+- Sumula 536: Nao aplica suspensao processo
+- Sumula 542: Lesao corporal = acao publica incondicionada
+- Sumula 588: Nao cabe restritiva de direitos
+- Sumula 589: Insignificancia inaplicavel
+- Sumula 600: Coabitacao nao e requisito
+
+### STF — Constitucional
+- SV 25: Prisao civil so devedor alimentos
+- RE 878.694 (Tema 498): Companheiro = conjuge heranca
+- RE 898.060 (Tema 622): Socioafetiva nao impede biologica
+- ADI 4.277: Uniao estavel homoafetiva
+- RE 1.010.606: Direito ao esquecimento
+- Tema 1.102: Revisao da vida toda
+
+## Doutrina de Referencia
+
+### Familia
+- Maria Berenice Dias — Manual de Direito das Familias
+- Rolf Madaleno — Direito de Familia
+- Paulo Lobo — Direito Civil: Familias
+
+### Civil / Responsabilidade
+- Flavio Tartuce — Direito Civil
+- Carlos Roberto Goncalves — Responsabilidade Civil
+- Sergio Cavalieri Filho — Programa de Responsabilidade Civil
+
+### Processual Civil
+- Fredie Didier Jr. — Curso de Direito Processual Civil
+- Daniel Amorim Assumpçao Neves — Manual de Processo Civil
+- Humberto Theodoro Junior — Curso de Processo Civil
+
+### Penal
+- Rogerio Greco — Curso de Direito Penal
+- Cleber Masson — Direito Penal
+- Renato Brasileiro — Manual de Processo Penal
+
+### Trabalhista
+- Mauricio Godinho Delgado — Curso de Direito do Trabalho
+
+### Previdenciario
+- Frederico Amado — Direito Previdenciario
+
+### Digital
+- Patricia Peck Pinheiro — Direito Digital

package/templates/.agent/skills/agent-evaluation/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: agent-evaluation
+description: "You're a quality engineer who has seen agents that aced benchmarks fail spectacularly in production. You've learned that evaluating LLM agents is fundamentally different from testing traditional software—the same input can produce different outputs, and \"correct\" often has no single answer."
+risk: unknown
+source: "vibeship-spawner-skills (Apache 2.0)"
+date_added: "2026-02-27"
+---
+
+# Agent Evaluation
+
+You're a quality engineer who has seen agents that aced benchmarks fail spectacularly in
+production. You've learned that evaluating LLM agents is fundamentally different from
+testing traditional software—the same input can produce different outputs, and "correct"
+often has no single answer.
+
+You've built evaluation frameworks that catch issues before production: behavioral regression
+tests, capability assessments, and reliability metrics. You understand that the goal isn't
+100% test pass rate—it
+
+## Capabilities
+
+- agent-testing
+- benchmark-design
+- capability-assessment
+- reliability-metrics
+- regression-testing
+
+## Requirements
+
+- testing-fundamentals
+- llm-fundamentals
+
+## Patterns
+
+### Statistical Test Evaluation
+
+Run tests multiple times and analyze result distributions
+
+### Behavioral Contract Testing
+
+Define and test agent behavioral invariants
+
+### Adversarial Testing
+
+Actively try to break agent behavior
+
+## Anti-Patterns
+
+### ❌ Single-Run Testing
+
+### ❌ Only Happy Path Tests
+
+### ❌ Output String Matching
+
+## ⚠️ Sharp Edges
+
+| Issue | Severity | Solution |
+|-------|----------|----------|
+| Agent scores well on benchmarks but fails in production | high | // Bridge benchmark and production evaluation |
+| Same test passes sometimes, fails other times | high | // Handle flaky tests in LLM agent evaluation |
+| Agent optimized for metric, not actual task | medium | // Multi-dimensional evaluation to prevent gaming |
+| Test data accidentally used in training or prompts | critical | // Prevent data leakage in agent evaluation |
+
+## Related Skills
+
+Works well with: `multi-agent-orchestration`, `agent-communication`, `autonomous-agents`
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/.agent/skills/agent-framework-azure-ai-py/SKILL.md

@@ -0,0 +1,338 @@
+---
+name: agent-framework-azure-ai-py
+description: "Build persistent agents on Azure AI Foundry using the Microsoft Agent Framework Python SDK."
+risk: unknown
+source: community
+date_added: "2026-02-27"
+---
+
+# Agent Framework Azure Hosted Agents
+
+Build persistent agents on Azure AI Foundry using the Microsoft Agent Framework Python SDK.
+
+## Architecture
+
+```
+User Query → AzureAIAgentsProvider → Azure AI Agent Service (Persistent)
+                    ↓
+              Agent.run() / Agent.run_stream()
+                    ↓
+              Tools: Functions | Hosted (Code/Search/Web) | MCP
+                    ↓
+              AgentThread (conversation persistence)
+```
+
+## Installation
+
+```bash
+# Full framework (recommended)
+pip install agent-framework --pre
+
+# Or Azure-specific package only
+pip install agent-framework-azure-ai --pre
+```
+
+## Environment Variables
+
+```bash
+export AZURE_AI_PROJECT_ENDPOINT="https://<project>.services.ai.azure.com/api/projects/<project-id>"
+export AZURE_AI_MODEL_DEPLOYMENT_NAME="gpt-4o-mini"
+export BING_CONNECTION_ID="your-bing-connection-id"  # For web search
+```
+
+## Authentication
+
+```python
+from azure.identity.aio import AzureCliCredential, DefaultAzureCredential
+
+# Development
+credential = AzureCliCredential()
+
+# Production
+credential = DefaultAzureCredential()
+```
+
+## Core Workflow
+
+### Basic Agent
+
+```python
+import asyncio
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="MyAgent",
+            instructions="You are a helpful assistant.",
+        )
+        
+        result = await agent.run("Hello!")
+        print(result.text)
+
+asyncio.run(main())
+```
+
+### Agent with Function Tools
+
+```python
+from typing import Annotated
+from pydantic import Field
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+def get_weather(
+    location: Annotated[str, Field(description="City name to get weather for")],
+) -> str:
+    """Get the current weather for a location."""
+    return f"Weather in {location}: 72°F, sunny"
+
+def get_current_time() -> str:
+    """Get the current UTC time."""
+    from datetime import datetime, timezone
+    return datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M:%S UTC")
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="WeatherAgent",
+            instructions="You help with weather and time queries.",
+            tools=[get_weather, get_current_time],  # Pass functions directly
+        )
+        
+        result = await agent.run("What's the weather in Seattle?")
+        print(result.text)
+```
+
+### Agent with Hosted Tools
+
+```python
+from agent_framework import (
+    HostedCodeInterpreterTool,
+    HostedFileSearchTool,
+    HostedWebSearchTool,
+)
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="MultiToolAgent",
+            instructions="You can execute code, search files, and search the web.",
+            tools=[
+                HostedCodeInterpreterTool(),
+                HostedWebSearchTool(name="Bing"),
+            ],
+        )
+        
+        result = await agent.run("Calculate the factorial of 20 in Python")
+        print(result.text)
+```
+
+### Streaming Responses
+
+```python
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="StreamingAgent",
+            instructions="You are a helpful assistant.",
+        )
+        
+        print("Agent: ", end="", flush=True)
+        async for chunk in agent.run_stream("Tell me a short story"):
+            if chunk.text:
+                print(chunk.text, end="", flush=True)
+        print()
+```
+
+### Conversation Threads
+
+```python
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="ChatAgent",
+            instructions="You are a helpful assistant.",
+            tools=[get_weather],
+        )
+        
+        # Create thread for conversation persistence
+        thread = agent.get_new_thread()
+        
+        # First turn
+        result1 = await agent.run("What's the weather in Seattle?", thread=thread)
+        print(f"Agent: {result1.text}")
+        
+        # Second turn - context is maintained
+        result2 = await agent.run("What about Portland?", thread=thread)
+        print(f"Agent: {result2.text}")
+        
+        # Save thread ID for later resumption
+        print(f"Conversation ID: {thread.conversation_id}")
+```
+
+### Structured Outputs
+
+```python
+from pydantic import BaseModel, ConfigDict
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+class WeatherResponse(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    
+    location: str
+    temperature: float
+    unit: str
+    conditions: str
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="StructuredAgent",
+            instructions="Provide weather information in structured format.",
+            response_format=WeatherResponse,
+        )
+        
+        result = await agent.run("Weather in Seattle?")
+        weather = WeatherResponse.model_validate_json(result.text)
+        print(f"{weather.location}: {weather.temperature}°{weather.unit}")
+```
+
+## Provider Methods
+
+| Method | Description |
+|--------|-------------|
+| `create_agent()` | Create new agent on Azure AI service |
+| `get_agent(agent_id)` | Retrieve existing agent by ID |
+| `as_agent(sdk_agent)` | Wrap SDK Agent object (no HTTP call) |
+
+## Hosted Tools Quick Reference
+
+| Tool | Import | Purpose |
+|------|--------|---------|
+| `HostedCodeInterpreterTool` | `from agent_framework import HostedCodeInterpreterTool` | Execute Python code |
+| `HostedFileSearchTool` | `from agent_framework import HostedFileSearchTool` | Search vector stores |
+| `HostedWebSearchTool` | `from agent_framework import HostedWebSearchTool` | Bing web search |
+| `HostedMCPTool` | `from agent_framework import HostedMCPTool` | Service-managed MCP |
+| `MCPStreamableHTTPTool` | `from agent_framework import MCPStreamableHTTPTool` | Client-managed MCP |
+
+## Complete Example
+
+```python
+import asyncio
+from typing import Annotated
+from pydantic import BaseModel, Field
+from agent_framework import (
+    HostedCodeInterpreterTool,
+    HostedWebSearchTool,
+    MCPStreamableHTTPTool,
+)
+from agent_framework.azure import AzureAIAgentsProvider
+from azure.identity.aio import AzureCliCredential
+
+
+def get_weather(
+    location: Annotated[str, Field(description="City name")],
+) -> str:
+    """Get weather for a location."""
+    return f"Weather in {location}: 72°F, sunny"
+
+
+class AnalysisResult(BaseModel):
+    summary: str
+    key_findings: list[str]
+    confidence: float
+
+
+async def main():
+    async with (
+        AzureCliCredential() as credential,
+        MCPStreamableHTTPTool(
+            name="Docs MCP",
+            url="https://learn.microsoft.com/api/mcp",
+        ) as mcp_tool,
+        AzureAIAgentsProvider(credential=credential) as provider,
+    ):
+        agent = await provider.create_agent(
+            name="ResearchAssistant",
+            instructions="You are a research assistant with multiple capabilities.",
+            tools=[
+                get_weather,
+                HostedCodeInterpreterTool(),
+                HostedWebSearchTool(name="Bing"),
+                mcp_tool,
+            ],
+        )
+        
+        thread = agent.get_new_thread()
+        
+        # Non-streaming
+        result = await agent.run(
+            "Search for Python best practices and summarize",
+            thread=thread,
+        )
+        print(f"Response: {result.text}")
+        
+        # Streaming
+        print("\nStreaming: ", end="")
+        async for chunk in agent.run_stream("Continue with examples", thread=thread):
+            if chunk.text:
+                print(chunk.text, end="", flush=True)
+        print()
+        
+        # Structured output
+        result = await agent.run(
+            "Analyze findings",
+            thread=thread,
+            response_format=AnalysisResult,
+        )
+        analysis = AnalysisResult.model_validate_json(result.text)
+        print(f"\nConfidence: {analysis.confidence}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Conventions
+
+- Always use async context managers: `async with provider:`
+- Pass functions directly to `tools=` parameter (auto-converted to AIFunction)
+- Use `Annotated[type, Field(description=...)]` for function parameters
+- Use `get_new_thread()` for multi-turn conversations
+- Prefer `HostedMCPTool` for service-managed MCP, `MCPStreamableHTTPTool` for client-managed
+
+## Reference Files
+
+- references/tools.md: Detailed hosted tool patterns
+- references/mcp.md: MCP integration (hosted + local)
+- references/threads.md: Thread and conversation management
+- references/advanced.md: OpenAPI, citations, structured outputs
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/.agent/skills/agent-manager-skill/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: agent-manager-skill
+description: "Manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling."
+risk: unknown
+source: community
+date_added: "2026-02-27"
+---
+
+# Agent Manager Skill
+
+## When to Use
+Use this skill when you need to:
+
+- run multiple local CLI agents in parallel (separate tmux sessions)
+- start/stop agents and tail their logs
+- assign tasks to agents and monitor output
+- schedule recurring agent work (cron)
+
+## Prerequisites
+
+Install `agent-manager-skill` in your workspace:
+
+```bash
+git clone https://github.com/fractalmind-ai/agent-manager-skill.git
+```
+
+## Common commands
+
+```bash
+python3 agent-manager/scripts/main.py doctor
+python3 agent-manager/scripts/main.py list
+python3 agent-manager/scripts/main.py start EMP_0001
+python3 agent-manager/scripts/main.py monitor EMP_0001 --follow
+python3 agent-manager/scripts/main.py assign EMP_0002 <<'EOF'
+Follow teams/fractalmind-ai-maintenance.md Workflow
+EOF
+```
+
+## Notes
+
+- Requires `tmux` and `python3`.
+- Agents are configured under an `agents/` directory (see the repo for examples).

package/templates/.agent/skills/agent-memory-mcp/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: agent-memory-mcp
+description: "A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions)."
+risk: unknown
+source: community
+date_added: "2026-02-27"
+---
+
+# Agent Memory Skill
+
+This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.
+
+## Prerequisites
+
+- Node.js (v18+)
+
+## Setup
+
+1. **Clone the Repository**:
+   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
+
+   ```bash
+   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
+   ```
+
+2. **Install Dependencies**:
+
+   ```bash
+   cd .agent/skills/agent-memory
+   npm install
+   npm run compile
+   ```
+
+3. **Start the MCP Server**:
+   Use the helper script to activate the memory bank for your current project:
+
+   ```bash
+   npm run start-server <project_id> <absolute_path_to_target_workspace>
+   ```
+
+   _Example for current directory:_
+
+   ```bash
+   npm run start-server my-project $(pwd)
+   ```
+
+## Capabilities (MCP Tools)
+
+### `memory_search`
+
+Search for memories by query, type, or tags.
+
+- **Args**: `query` (string), `type?` (string), `tags?` (string[])
+- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
+
+### `memory_write`
+
+Record new knowledge or decisions.
+
+- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
+- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
+
+### `memory_read`
+
+Retrieve specific memory content by key.
+
+- **Args**: `key` (string)
+- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`
+
+### `memory_stats`
+
+View analytics on memory usage.
+
+- **Usage**: "Show memory statistics" -> `memory_stats({})`
+
+## Dashboard
+
+This skill includes a standalone dashboard to visualize memory usage.
+
+```bash
+npm run start-dashboard <absolute_path_to_target_workspace>
+```
+
+Access at: `http://localhost:3333`
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.