iron-edge 1.0.0

package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md

@@ -0,0 +1,320 @@
+# Multi-Agent Deployment Patterns — Clones em Sistemas Multi-Agente
+
+> Como integrar clones cognitivos em sistemas multi-agente (CrewAI, LangGraph,
+> AutoGen/AG2, OpenAI Agents SDK, Claude Agent SDK).
+> Como clones funcionam como nodes em orquestrações maiores.
+> Baseado em: MS-009 Sistema 5 — Agent, Subagent & Skills Modeling.
+
+---
+
+## Contexto: O Mercado de Frameworks (Abril 2026)
+
+| Framework | Status | Ideal Para |
+|-----------|--------|-----------|
+| **LangGraph** | Producao — High maturity | Fluxos complexos, state machines, producao enterprise |
+| **CrewAI** | Producao — High maturity | Prototipagem rapida, equipes conceituais de agentes |
+| **Claude Agent SDK** | Producao — High maturity | Ecossistema Claude nativo, tool use, file checkpointing |
+| **OpenAI Agents SDK** | Producao — High maturity | Ecossistema OpenAI, handoffs, guardrails |
+| **Google ADK** | Producao — High maturity | Ecossistema Gemini, lancado Cloud NEXT 2025 |
+| **Microsoft Agent Framework** | Novo (2026) | Substitui AutoGen + Semantic Kernel unificados |
+| **AutoGen/AG2** | Maintenance mode | Fork comunitario (ag2ai/ag2) — nao recomendado para novos projetos |
+
+**Nota importante (Abril 2026):** Microsoft aposentou AutoGen em favor do
+Microsoft Agent Framework. AutoGen recebe apenas bug fixes e security patches.
+A comunidade mantém o fork AG2 independente.
+
+---
+
+## Padrao 1: Clone como Especialista no CrewAI
+
+O padrao mais simples — o clone e um "agent" dentro de uma crew:
+
+```python
+from crewai import Agent, Task, Crew
+
+clone_hormozi = Agent(
+    role="Alex Hormozi Clone — Offer Creation Expert",
+    goal="Analyze and create high-value offers using Hormozi's documented methodology",
+    backstory="""
+    You are a cognitive clone of Alex Hormozi, with 88% confidence score (Tier 3).
+    Your expertise is in offer creation, business acquisition, and scaling.
+    Core principle: 'The value equation determines everything about an offer.'
+    You speak directly, use simple language, and always quantify.
+    You decline to advise on: accounting, legal matters, technical implementation.
+    Based on documented sources: DotCom Secrets, Expert Secrets, $100M Offers, podcasts.
+    """,
+    verbose=True,
+    allow_delegation=False  # Clone nao delega — ele e o especialista
+)
+
+task_offer_review = Task(
+    description="Review this offer and improve it using Alex Hormozi's documented methodology",
+    agent=clone_hormozi,
+    expected_output="Revised offer with rationale based on documented Hormozi principles"
+)
+```
+
+### Regras para Clone em CrewAI
+
+1. **allow_delegation=False:** Clone e especialista terminal, nao orquestrador
+2. **backstory inclui confidence score:** Transparencia sobre qualidade
+3. **backstory inclui failure modes:** "You decline to advise on X"
+4. **backstory inclui fonte:** "Based on documented sources: ..."
+5. **Nome do role menciona "Clone":** Deixa claro que e representacao
+
+---
+
+## Padrao 2: Clone como Node no LangGraph
+
+Para fluxos mais complexos com state management:
+
+```python
+from langgraph.graph import StateGraph, State
+from typing import TypedDict
+
+class CloningState(TypedDict):
+    query: str
+    clone_response: str
+    confidence_used: float
+    sources_activated: list[str]
+
+def hormozi_clone_node(state: CloningState) -> CloningState:
+    """
+    Node que implementa o clone Hormozi.
+    Carrega memory WARM sob demanda baseado na query.
+    """
+    # Retrieval WARM para a query especifica
+    relevant_kbs = retrieve_warm_memory(
+        query=state["query"],
+        clone_id="alex-hormozi",
+        top_k=3
+    )
+    
+    # Montar contexto: HOT (always) + WARM (retrieved)
+    system_prompt = build_clone_context(
+        hot_memory=HORMOZI_HOT_MEMORY,  # Sempre carregado
+        warm_memory=relevant_kbs
+    )
+    
+    response = claude_invoke(
+        system=system_prompt,
+        message=state["query"]
+    )
+    
+    return {
+        **state,
+        "clone_response": response,
+        "confidence_used": 0.88,
+        "sources_activated": [kb.name for kb in relevant_kbs]
+    }
+
+# Construir o grafo
+workflow = StateGraph(CloningState)
+workflow.add_node("hormozi_clone", hormozi_clone_node)
+workflow.add_node("quality_validator", validate_clone_output)
+workflow.add_edge("hormozi_clone", "quality_validator")
+```
+
+### Vantagens do LangGraph para Clones
+
+- **Traceable:** Cada decisao do clone e rastreavel no grafo
+- **Interruptible:** Pode pausar para revisao humana em pontos criticos
+- **State management:** Mantém contexto entre multiplos turnos
+- **Conditional routing:** Pode rotear para clone diferente baseado no topico
+
+---
+
+## Padrao 3: Clone como Subagente no Claude Agent SDK
+
+Para integracao nativa com Claude Code e ecossistema Anthropic:
+
+```markdown
+# Agent Definition: clone-{source-mind}
+
+---
+name: clone-alex-hormozi
+description: >
+  Cognitive clone of Alex Hormozi (88% confidence, Tier 3).
+  Specialist in offer creation, business acquisition, and scaling.
+  Use when: offer analysis, pricing strategy, business growth.
+model: claude-sonnet-4-6
+tools:
+  - Read  # Para acessar KBs
+allowed_tools: Read
+---
+
+You are a cognitive clone of Alex Hormozi...
+{system prompt completo do agent.md}
+```
+
+```python
+# Invocacao via Claude Agent SDK
+import anthropic
+
+client = anthropic.Anthropic()
+
+# Carregar o clone como subagente
+result = client.agents.run(
+    agent_id="clone-alex-hormozi",
+    messages=[{"role": "user", "content": "Analise esta oferta..."}]
+)
+```
+
+---
+
+## Padrao 4: Multi-Clone Panel (Debate de Perspectivas)
+
+Padrao avancado: multiplos clones debatem um problema:
+
+```python
+from crewai import Agent, Task, Crew, Process
+
+# Definir 3 clones com perspectivas diferentes
+hormozi_clone = Agent(
+    role="Alex Hormozi Clone — Offer & Scale Expert",
+    backstory="...",
+    allow_delegation=False
+)
+
+brunson_clone = Agent(
+    role="Russell Brunson Clone — Funnel & Persuasion Expert",
+    backstory="...",
+    allow_delegation=False
+)
+
+halbert_clone = Agent(
+    role="Gary Halbert Clone — Direct Response Copywriting Expert",
+    backstory="...",
+    allow_delegation=False
+)
+
+synthesizer = Agent(
+    role="Synthesis Agent",
+    goal="Identify common ground and unique insights from multiple perspectives",
+    backstory="You synthesize diverse expert perspectives without bias",
+    allow_delegation=False
+)
+
+tasks = [
+    Task(
+        description="Analyze this marketing campaign from your documented perspective",
+        agent=hormozi_clone
+    ),
+    Task(
+        description="Analyze this marketing campaign from your documented perspective",
+        agent=brunson_clone
+    ),
+    Task(
+        description="Analyze this marketing campaign from your documented perspective",
+        agent=halbert_clone
+    ),
+    Task(
+        description="Synthesize the three perspectives into actionable recommendations",
+        agent=synthesizer,
+        context=[task1, task2, task3]  # Recebe outputs dos outros
+    )
+]
+
+panel = Crew(
+    agents=[hormozi_clone, brunson_clone, halbert_clone, synthesizer],
+    tasks=tasks,
+    process=Process.sequential
+)
+```
+
+### Quando Usar Multi-Clone Panel
+
+- Decisoes estratégicas onde perspectivas diferentes agregam valor
+- Criacao de conteudo que precisa de "best of all worlds"
+- Auditoria de estratégias (cada clone testa sua lente)
+- Treinamento/educacao (ver como diferentes experts abordam o mesmo problema)
+
+**Limitacao:** O custo aumenta linearmente com o numero de clones. Para
+producao, usar apenas quando o valor adicional justifica o custo.
+
+---
+
+## Padrao 5: Clone com Memory Persistente (Letta/MemGPT)
+
+Para clones que precisam lembrar de interacoes anteriores:
+
+```python
+from letta import create_client
+
+client = create_client()
+
+# Criar agente com memoria persistente
+clone_agent = client.create_agent(
+    name="clone-alex-hormozi",
+    memory=ChatMemory(
+        human="User building a SaaS product",
+        persona="You are a cognitive clone of Alex Hormozi..."
+    ),
+    system=HORMOZI_SYSTEM_PROMPT,
+    tools=["core_memory_append", "core_memory_replace", "archival_memory_search"]
+)
+
+# Interagir — o clone lembra de conversas anteriores
+response_1 = client.send_message(
+    agent_id=clone_agent.id,
+    message="Meu produto atual e X com preco Y"
+)
+
+# Em sessao futura, o clone lembra do contexto
+response_2 = client.send_message(
+    agent_id=clone_agent.id,
+    message="Devo mudar o preco?"
+    # Clone lembra: "produto X com preco Y" da sessao anterior
+)
+```
+
+### Quando Usar Memory Persistente
+
+- Clone que atua como consultor recorrente para o mesmo usuario/empresa
+- Quando o contexto acumula ao longo de semanas/meses
+- Quando o clone precisa "aprender" sobre o contexto especifico do usuario
+
+**Atencao:** Memory persistente aumenta complexidade e custo. Usar apenas quando
+o beneficio de lembrar o contexto e claro e recorrente.
+
+---
+
+## Governance de Clones em Sistemas Multi-Agente
+
+### Regras de Autoridade
+
+| Operacao | Clone pode fazer? | Notas |
+|---------|-------------------|-------|
+| Responder perguntas no dominio | Sim | Dentro de confidence score |
+| Dar recomendacoes | Sim, com contextualizacao | "Baseado no que [nome] documentou..." |
+| Executar acoes (codigo, escrita) | Sim, se ferramentas permitidas | Depende de `allowed_tools` |
+| Apresentar-se como a pessoa real | NAO | Sempre como "clone cognitivo" |
+| Opinar em areas fora do dominio | Com disclaimer | Marcar como fora do escopo |
+| Criar conteudo "no nome de" sem supervisao | Nao recomendado | Ver ethical-guidelines.md |
+
+### Handoff Protocol para Clones
+
+Quando o clone recebe uma pergunta fora do seu dominio:
+
+```
+Resposta padrao:
+"Isso esta alem do que {Nome} documenta extensivamente.
+Baseado nas suas fontes, o mais proximo que posso chegar e [X].
+Para conselho especializado em [area], recomendo [recurso]."
+```
+
+---
+
+## Metricas de Performance em Producao
+
+| Metrica | Meta | Alertar se |
+|---------|------|-----------|
+| Clone activation rate | > 80% das perguntas no dominio | < 60% |
+| Out-of-domain rate | < 15% das respostas | > 25% |
+| Confidence tag compliance | 100% das extracoes tagadas | < 95% |
+| Fidelity score (por sampling) | >= 70% | < 55% |
+| Boundary violation rate | < 2% | > 5% |
+
+Ver tambem: `memory-architecture-for-clones.md` para como estruturar a memoria.
+Ver tambem: `clone-quality-assurance.md` para validacao de fidelidade.
+Ver tambem: `ethical-guidelines.md` para uso etico em sistemas automatizados.

package/squads/squad-cloning/knowledge-base/pipeline-session-planning.md

@@ -0,0 +1,108 @@
+# Pipeline Session Planning — Planejamento de Sessoes com 1M de Contexto
+
+> Como planejar e distribuir o trabalho de clonagem em sessoes de Claude Code
+> aproveitando o contexto de 1M tokens.
+
+---
+
+## Modelo de Sessao (1M tokens ≈ 750K palavras)
+
+Com 1M de contexto, o pipeline muda fundamentalmente:
+
+| Antes (200K contexto) | Depois (1M contexto) |
+|----------------------|---------------------|
+| Chunkar em 600 pedacos | Carregar tudo de uma vez |
+| Muitas sessoes por clone | 1-3 sessoes por clone |
+| Precisava API Batch | Tudo no plano Max |
+| Dias para 1 clone | 1-3 sessoes para 1 clone |
+
+---
+
+## Distribuicao por Tier
+
+### Tier 1 — 1 Sessao
+```
+Sessao 1:
+  - Carregar source-catalog.yaml
+  - Carregar todas as transcricoes (5-20K palavras)
+  - Extrair 5 camadas DNA
+  - Sintetizar perfil cognitivo
+  - Gerar 3-8 KBs
+  - Validar
+```
+
+### Tier 2 — 1-2 Sessoes
+```
+Sessao 1:
+  - Carregar source-catalog.yaml
+  - Carregar todas as transcricoes (30-100K palavras)
+  - Extrair 5 camadas DNA
+  - Sintetizar perfil cognitivo
+  - Calcular confidence score
+
+Sessao 2:
+  - Carregar perfil cognitivo
+  - Gerar agent.md
+  - Gerar 5+ KBs
+  - Validar tudo
+```
+
+### Tier 3 — 2-3 Sessoes
+```
+Sessao 1:
+  - Carregar source-catalog.yaml
+  - Carregar todas as transcricoes (80-200K+ palavras)
+  - Extrair 5 camadas DNA
+  - Sintetizar perfil cognitivo
+
+Sessao 2:
+  - Carregar perfil cognitivo + extracoes
+  - Gerar agent.md completo
+  - Gerar 8+ KBs
+
+Sessao 3 (se necessario):
+  - Carregar agent.md + KBs + perfil
+  - Gerar tasks (6+)
+  - Gerar workflows
+  - Montar squad.yaml
+  - Rodar pre-publish checklist
+  - Deploy cross-squad
+```
+
+---
+
+## Ferramentas por Fase
+
+| Fase | Ferramenta | Ambiente |
+|------|-----------|---------|
+| Source Discovery | Brave Search + Claude Code | Desktop |
+| Content Capture | Whisper API (Whisper) + Playwright | VPS 24/7 |
+| Load & Extract | Claude Code (1M) | Desktop/VPS |
+| Synthesize | Claude Code (1M) | Desktop/VPS |
+| Generate Agent | Claude Code | Desktop |
+| Generate KBs | Claude Code | Desktop |
+| Generate Tasks | Claude Code | Desktop |
+| Assemble & Deploy | Claude Code | Desktop |
+
+---
+
+## Estimativa de Tempo
+
+| Classe | Volume | Capture | Processing | Total |
+|--------|--------|---------|-----------|-------|
+| A (Rico) | 200K+ palavras | 2-4h (Whisper) | 2-3 sessoes | ~1 dia |
+| B (Moderado) | 50-200K | 1-2h | 1-2 sessoes | ~meio dia |
+| C (Escasso) | 10-50K | 30min-1h | 1 sessao | ~2-3h |
+| D (Historico) | 5-50K | 1h (OCR) | 1 sessao | ~2-3h |
+
+**Nota:** Tempos assumem plano Max com acesso direto a Claude Code.
+
+---
+
+## Custo Extra
+
+**Zero.** Todo o pipeline roda com:
+- Claude Code (plano Max) — processamento principal
+- Whisper API (gratuito) — Whisper transcricao, Playwright capture
+- Brave Search (gratuito) — source discovery
+- Syncthing (gratuito) — sync cross-machine

package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md

@@ -0,0 +1,262 @@
+# SKILL.md Standard para Clones — Exportacao Universal
+
+> Como exportar clones cognitivos no formato Agent Skills (SKILL.md),
+> compativel com 33+ plataformas: Claude Code, Codex, Gemini CLI, Cursor,
+> VS Code, GitHub Copilot e outros.
+> Baseado em: research 07-skills-agents-swarm, spec agentskills.io.
+
+---
+
+## Por Que SKILL.md Para Clones
+
+O formato Agent Skills (SKILL.md) e o padrao de facto universal em 2026:
+- 33 plataformas suportam o formato
+- 1.060+ skills catalogadas no ecossistema
+- Compatibilidade cross-platform sem modificacao
+- Especificacao publica em agentskills.io (Anthropic)
+
+Exportar clones como SKILL.md permite que o conhecimento cognitivo seja
+acessado em qualquer ferramenta de IA que o usuario ja usa — sem precisar
+"ativar o squad" explicitamente.
+
+---
+
+## Estrutura de Pasta para Clone-Skill
+
+```
+clones/{source-mind-kebab}/
+  SKILL.md              # OBRIGATORIO: metadata + instrucoes compactas
+  scripts/              # Opcional: scripts de suporte
+  references/
+    heuristics.md       # Lista completa de heuristics (L2)
+    workflows.md        # Workflows detalhados (L3)
+    kb/                 # Knowledge bases completos
+      {topic-1}.md
+      {topic-2}.md
+  assets/
+    templates/          # Templates de output usados pelo clone
+```
+
+**Regra fundamental:** O nome da pasta DEVE coincidir com o campo `name` no frontmatter.
+
+---
+
+## Frontmatter Obrigatorio
+
+```yaml
+---
+name: clone-{source-mind-kebab}
+description: >
+  Cognitive clone of {Nome}, expert in {dominios}. Responds as {nome} would,
+  using their documented heuristics, mental models and communication style.
+  Confidence: {X}% (Tier {1|2|3}). Use when you need {nome}'s perspective on
+  {area 1}, {area 2}, {area 3}. Trigger: "como {nome} pensaria sobre",
+  "o que {nome} faria", "analise como {nome}".
+license: UNLICENSED
+compatibility: Works standalone. Full features require SINAPSE squad-cloning context.
+metadata:
+  source_mind: "{Nome Completo}"
+  clone_tier: "{1|2|3}"
+  confidence_score: "{X}%"
+  fidelity_score: "{X}%"
+  squad: "squad-cloning"
+  primary_domains: "{dominio1}, {dominio2}, {dominio3}"
+  sinapse_version: "5.x"
+  last_updated: "{YYYY-MM-DD}"
+allowed-tools: Read
+---
+```
+
+### Campo `description` — Regras Criticas
+
+1. **Ser pushy:** A Anthropic recomenda descriptions "pushy" para combater under-triggering.
+   Incluir keywords explicitas que o usuario pode mencionar.
+2. **Mencionar confidence score:** Transparencia sobre a qualidade do clone.
+3. **Listar triggers:** Frases especificas que devem ativar o clone.
+4. **Listar dominios:** Areas de expertise documentadas.
+
+**Exemplo real:**
+```yaml
+description: >
+  Cognitive clone of Alex Hormozi, expert in offer creation, business acquisition,
+  and scaling service businesses. Confidence: 88% (Tier 3). Use when you need
+  Alex's perspective on pricing, offers, lead generation, or business growth.
+  Trigger phrases: "como Hormozi pensaria", "o que o Hormozi faria aqui",
+  "analise como Alex Hormozi", "perspectiva do Hormozi".
+```
+
+---
+
+## Corpo do SKILL.md — Template
+
+O corpo deve seguir Progressive Disclosure de 3 niveis:
+
+```markdown
+# Clone: {Nome} ({Tier})
+
+> Confidence: {X}% | Tier {N} | Dominios: {lista}
+> Baseado em: {N} fontes, {N}K palavras processadas
+
+## Identity
+
+{Core axiom em 1-2 frases. A essencia mais fundamental de como esta pessoa pensa.}
+
+**Principios fundamentais:**
+1. {Principio 1 — de L1, [DIRETO|INFERIDO]}
+2. {Principio 2}
+3. {Principio 3}
+4. {Principio 4}
+5. {Principio 5}
+
+## Como Esta Pessoa Responde
+
+**Tom:** {Descricao concisa do tom — direto/analitico/empático, formal/informal, etc.}
+
+**Abertura tipica:** "{Exemplo de como começa uma resposta}"
+
+**Vocabulario recorrente:** {lista de 8-10 palavras/expressoes caracteristicas}
+
+## Heuristics Principais (Top 5)
+
+1. **{Trigger 1}** → {Acao documentada} [DIRETO|INFERIDO]
+2. **{Trigger 2}** → {Acao} [DIRETO|INFERIDO]
+3. **{Trigger 3}** → {Acao} [DIRETO|INFERIDO]
+4. **{Trigger 4}** → {Acao} [DIRETO|INFERIDO]
+5. **{Trigger 5}** → {Acao} [DIRETO|INFERIDO]
+
+Para lista completa de heuristics: `references/heuristics.md`
+
+## Limites e Boundaries
+
+**Nao opinar sobre:**
+- {Area fora do dominio documentado}
+- {Topico que o original evita}
+
+**Sempre contextualizar:** "Baseado no que {nome} documentou/ensinou..."
+
+**Recusar criar conteudo que:**
+- Contradiz os valores documentados do original
+- Exige conhecimento nao presente nas fontes ({N} fontes, ate {data})
+
+## Como Usar Este Clone
+
+**Ativar com:** "Responda como {nome}", "O que {nome} faria?", "Perspectiva do {nome}"
+
+**Funciona melhor para:**
+- {Caso de uso 1}
+- {Caso de uso 2}
+- {Caso de uso 3}
+
+**Nao usar para:**
+- {Caso fora do dominio}
+- {Area de incerteza documentada}
+
+## Referencias
+
+- [Heuristics completas](references/heuristics.md) ({N} heuristics documentadas)
+- [Workflows](references/workflows.md) ({N} workflows)
+- [Knowledge Bases](references/kb/) ({N} KBs tematicos)
+```
+
+---
+
+## Progressive Disclosure por Nivel
+
+| Nivel | O que carrega | Quando | Tamanho |
+|-------|--------------|--------|---------|
+| 1 | name + description (frontmatter) | Startup — listagem | ~100 tokens |
+| 2 | Body do SKILL.md (Identity + Top heuristics) | Clone invocado | <3.000 tokens |
+| 3 | references/ (KBs completos, heuristics all) | Tarefa especifica | Ilimitado |
+
+**Regra critica:** SKILL.md deve ficar abaixo de 300 linhas.
+Todo material de referencia detalhado vai para references/.
+
+---
+
+## Qualidade de Skill por Tier de Clone
+
+### Tier 1 — SKILL.md Minimo
+- Frontmatter completo com confidence score
+- Identity block compacto (core axiom + 3 principios)
+- Top 3 heuristics
+- Boundaries claros
+- Referencias para KBs (mesmo que simples)
+
+### Tier 2 — SKILL.md Consultant
+- Frontmatter completo
+- Identity completo (core axiom + 5-6 principios)
+- Top 5 heuristics com trigger/action/rationale
+- Communication style detalhado
+- Failure modes completos
+- references/heuristics.md com lista completa
+- references/kb/ com KBs tematicos
+
+### Tier 3 — SKILL.md Full Clone
+- Tudo do Tier 2
+- Workflows ativos em references/workflows.md
+- Templates de output em assets/templates/
+- references/kb/ com 8+ KBs tematicos
+- Decision trees para cenarios complexos
+- Exemplos concretos de input/output esperado
+
+---
+
+## Anti-patterns de Clone-Skills
+
+| Anti-pattern | Problema | Correcao |
+|-------------|---------|---------|
+| SKILL.md > 500 linhas | Polui o contexto, atrasa carga | Mover para references/ |
+| Description vaga ("AI assistant for X") | Nao e ativada pelo LLM | Ser explicito e pushy |
+| Sem confidence score no frontmatter | Usuario nao sabe qualidade | Sempre incluir |
+| Sem failure modes | Clone responde fora do dominio | Adicionar secao de limites |
+| Heuristics sem tag [DIRETO|INFERIDO|HIPOTESE] | Viola principio de honestidade | Taguear todas |
+| Clone soa como pessoa mas nao decide como ela | Fidelidade cognitiva baixa | Validar com fidelity test |
+
+---
+
+## Deploy para Marketplace
+
+### Via Claude Code Plugin
+```bash
+# No diretorio raiz do clone
+# Criar marketplace.json
+{
+  "name": "sinapse-clones",
+  "plugins": [
+    {
+      "name": "clone-{source-mind}",
+      "description": "Cognitive clone: {Nome}",
+      "source": "./",
+      "skills": ["./clones/{source-mind-kebab}"]
+    }
+  ]
+}
+
+# Instalar
+/plugin marketplace add sinapse-ai/clones
+/plugin install clone-{source-mind}@sinapse-clones
+```
+
+### Via Instalacao Manual (cross-platform)
+```bash
+# Copiar para skills do projeto
+cp -r clones/{source-mind-kebab} .claude/skills/
+
+# Ou para skills globais
+cp -r clones/{source-mind-kebab} ~/.claude/skills/
+```
+
+### Compatibilidade Cross-Platform
+
+| Plataforma | Localizacao | Comando |
+|-----------|------------|---------|
+| Claude Code | `.claude/skills/` ou `~/.claude/skills/` | `/plugin install` |
+| Gemini CLI | `.gemini/skills/` | Configuracao manual |
+| Cursor | `.cursor/skills/` | Settings > Skills |
+| VS Code Copilot | `.github/skills/` | Configuracao manual |
+
+---
+
+Ver tambem: `agent-generation-guide.md` — como gerar o agent.md base.
+Ver tambem: `clone-quality-assurance.md` — validar antes de exportar como SKILL.md.
+Ver tambem: `cross-squad-deployment.md` — deploy para squads vs skill export.