jarvis-ai-framework 2.0.0 → 2.1.1

package/skills/jarvis-evolution-architect/references/lentes-e-conceitos.md

@@ -0,0 +1,292 @@
+# Referências - Jarvis Evolution Architect
+
+## 📚 Lentes Arquiteturais
+
+### SDD (Spec-Driven Development)
+- **Intenção clara**: O que está tentando resolver?
+- **Requisitos bem definidos**: Qual comportamento esperado?
+- **Critérios de aceitação**: Como saber que está pronto?
+- **Rastreabilidade**: De onde vem cada requisito?
+- **Validação**: Como verifica que implementação atende spec?
+
+**Quando usar**: Sempre que decidir sobre uma nova feature ou mudança arquitetural.
+
+### CDD (Context-Driven Development)
+- **Contexto certo**: Qual contexto o agente precisa?
+- **Momento certo**: Quando esse contexto deve estar disponível?
+- **Mínimo ruído**: Apenas informação relevante?
+- **Sem duplicação**: Existe em apenas um lugar?
+- **Sem conflito**: As informações contradizem?
+
+**Quando usar**: Ao avaliar como arquitetura compartilha informações.
+
+### Agentic Software Engineering
+- **Agent Understanding**: O agente entende melhor?
+- **Agent Decision Making**: O agente toma melhores decisões?
+- **Agent Consistency**: Comportamento mais consistente?
+- **Agent Autonomy**: Mais autonomia com segurança?
+- **Agent Verification**: Mais fácil verificar resultado?
+- **Context Efficiency**: Contexto relevante sem excesso?
+
+**Quando usar**: Ao avaliar se uma feature/mudança beneficia agentes de IA.
+
+### Developer Experience
+- **Simplicidade**: É fácil de entender?
+- **Discoverability**: O desenvolvedor consegue descobrir?
+- **Ergonomia**: É natural de usar?
+- **Documentação**: Está bem documentado?
+- **Manutenção**: É fácil manter?
+- **Debugging**: É fácil debugar?
+- **Onboarding**: É fácil aprender?
+- **Previsibilidade**: Comportamento é previsível?
+
+**Quando usar**: Ao avaliar qualidade arquitetural do ponto de vista do desenvolvedor.
+
+---
+
+## 🏗️ Classificação de Artefatos
+
+### Agent
+**Quando usar:**
+- Possui identidade própria e bem-definida
+- Tem responsabilidades bem separadas
+- Requer contexto especializado
+- Toma decisões independentes
+- Tem ciclo de vida próprio
+
+**Não usar quando:**
+- É apenas uma etapa de um workflow
+- É auxiliar a outro agente
+- Responsabilidade é muito especializada/única
+
+### Skill
+**Quando usar:**
+- É um playbook executável
+- Define padrões detalhados
+- Pode ser reutilizado em múltiplos contextos
+- É acionável via comando
+- Tem metadatas e configurações
+
+**Não usar quando:**
+- É apenas uma decisão de um agente
+- É configuração estática
+
+### Workflow
+**Quando usar:**
+- É uma sequência de etapas
+- Coordena múltiplos artefatos
+- Define ordem e condições
+- É um fluxo de execução
+
+**Não usar quando:**
+- É apenas uma skill única
+- É decisão de um agente
+
+### Rule
+**Quando usar:**
+- É uma diretriz/constraint
+- Afeta múltiplos artefatos
+- É um gate/validação
+- É uma convenção
+
+### Template
+**Quando usar:**
+- É um modelo de documento
+- Reutilizável em múltiplos projetos
+- Define estrutura, não conteúdo
+
+### Specification
+**Quando usar:**
+- É um documento estruturado
+- Define requisitos, comportamento, critérios de aceitação
+- Precisa rastreabilidade
+
+### Context
+**Quando usar:**
+- É informação estruturada
+- Usada por múltiplos artefatos
+- Deve estar disponível em momento específico
+- Pode ser persistente ou sob demanda
+
+---
+
+## 🛡️ Princípios de Proteção
+
+### Contra Overengineering
+- Questionar se solução é mais complexa que problema
+- Procurar a menor solução viável
+- Evitar camadas de abstração desnecessárias
+
+### Contra Duplicação
+- Verificar se existe similar antes de criar novo
+- Preferir reusar e estender
+- Identificar padrões repetidos
+
+### Contra Fragmentação
+- Manter coerência arquitetural
+- Evitar múltiplos jeitos de fazer a mesma coisa
+- Centralizar decisões estratégicas
+
+### Contra Excesso de Contexto
+- Fornecer apenas o necessário
+- Evitar contexto muito amplo ou muito específico
+- Validar se informação está no lugar certo
+
+---
+
+## 📊 Matriz de Decisão
+
+| Tipo | Use quando... | Evite quando... |
+|------|---------------|-----------------|
+| **Agent** | Identidade própria + contexto especializado | Apenas uma etapa/auxiliar |
+| **Skill** | Playbook reutilizável acionável | Configuração estática |
+| **Workflow** | Sequência de etapas coordenadas | Skill única |
+| **Rule** | Diretriz/gate/convenção | Decisão de um agent |
+| **Template** | Modelo de documento reutilizável | Conteúdo único |
+| **Specification** | Requisitos estruturados com rastreabilidade | Simples tarefa |
+| **Context** | Informação usada por múltiplos artefatos | Informação local |
+
+---
+
+## 🔄 Preferência Evolutiva
+
+```
+1. REUSE - Usar existente como está
+   ↓ (se não resolve 100%)
+2. EXTEND - Estender existente
+   ↓ (se extend adiciona muita complexidade)
+3. REFACTOR - Reorganizar existente
+   ↓ (se reorganizar não suficiente)
+4. CREATE - Criar novo artefato
+   ↓ (JUSTIFIQUE POR QUE NÃO REUSE/EXTEND)
+```
+
+**Regra**: Criar algo novo deve ser a última opção e bem justificada.
+
+---
+
+## 🎯 Framework Jarvis Atual
+
+### Conceitos
+- **Agents**: 17 ativos (eng, qa, product, data, security)
+- **Skills**: 50+ playbooks executáveis
+- **Workflows**: Templates de execução (eng, product)
+- **Rules**: Diretrizes por contexto
+- **Templates**: Modelos de documentos
+- **Specifications**: PRD, ARD, Tech Spec
+
+### Convenções
+- Skills em `skills/{nome}/`
+- Agents em `agents/{area}/`
+- Workflows em `workflows/{area}/`
+- Rules em `rules/{area}/`
+- Todas com metadatas (area, author, version)
+
+### Filosofia
+- AI-native: Otimizado para agentes de IA
+- Composable: Artefatos reutilizáveis
+- Simple: Complexidade adicional deve ser justificada
+- Extensible: Fácil de evoluir
+
+---
+
+## 🔍 Tendências em AI-native Development
+
+### Áreas para monitorar
+- AI Coding Agents (Claude Code, Cursor, Codex, Windsurf)
+- Agent Infrastructure (MCP, subagents, orchestration)
+- Development Methodologies (SDD, CDD, Context Engineering)
+- Context Management (estratégias, eficiência)
+- Agent Autonomy (decisões, verificação)
+
+### Avaliação de Tendências
+```
+Tendência → Problema que resolve → Relevância para Jarvis
+→ Benefício → Complexidade → Trade-off → Decisão
+```
+
+**Decisões:**
+- **ADOPT**: Implementar agora
+- **EXPERIMENT**: Testar em projeto piloto
+- **WATCH**: Acompanhar evolução
+- **REJECT**: Não alinha com filosofia do Jarvis
+
+---
+
+## 💬 Padrões de Resposta
+
+### Estrutura Consultiva
+```
+Minha leitura:
+[O que entendi do problema]
+
+O que eu acho:
+[Avaliação técnica direta]
+
+O que eu mudaria:
+[Melhorias]
+
+O que eu não faria:
+[Decisões questionáveis]
+
+Como eu faria:
+[Proposta arquitetural]
+
+Trade-offs:
+[O que ganhamos e perdemos]
+
+Minha recomendação:
+[Decisão clara e opinativa]
+```
+
+### Quando Pesquisar
+- Tendências atuais
+- Práticas recentes
+- Comparação com frameworks similares
+- Comportamento de ferramentas atuais
+- Tecnologia recente
+
+### Quando Não Pesquisar
+- Arquitetura consolidada
+- Princípios estabelecidos
+- Práticas bem-conhecidas
+
+---
+
+## 🎓 Exemplo: Avaliação de Nova Feature
+
+**Pergunta**: "Devemos criar um novo agent Spec Reviewer?"
+
+**Análise SDD**:
+- **Intenção**: Validar especificações estão completas?
+- **Requisitos**: Quais critérios de aceitação para uma spec completa?
+- **Comportamento**: O que faz quando encontra gap?
+- **Rastreabilidade**: Como rastreia specs reviadas?
+
+**Análise CDD**:
+- **Contexto necessário**: Especificação + histórico de specs
+- **Quando needed**: Durante fase de spec, não depois
+- **Duplicação**: Existe análise similar?
+
+**Análise Agentic**:
+- **Agent Understanding**: Agente entenderia specs melhor com reviewer?
+- **Agent Decision Making**: Tomar melhores decisões?
+- **Autonomy**: Pode proceder automaticamente após review?
+
+**Análise DX**:
+- **Simplicidade**: Novo agent mantém Jarvis simples?
+- **Discoverability**: Desenvolvedor descobre quando usar?
+- **Onboarding**: Fácil aprender a usar?
+
+**Preferência Evolutiva**:
+- **REUSE**: Existe workflow de review?
+- **EXTEND**: Pode estender workflow existente?
+- **REFACTOR**: Reorganizar spec workflow?
+- **CREATE**: Criar novo agent? (última opção)
+
+**Recomendação**:
+"Eu não criaria um novo agent ainda. Começaria como etapa de workflow. Se notar que reviewer tem comportamento, contexto e ciclo de vida próprios, aí extraímos para agent."
+
+---
+
+**Última atualização**: 2026-10-04

package/skills/jarvis-evolution-architect/references/visao-geral.md

@@ -0,0 +1,272 @@
+# Jarvis Evolution Architect
+
+**Mentor de arquitetura especializado em evolução do Jarvis Framework.**
+
+---
+
+## 🎯 O que é?
+
+Uma **skill de mentoria arquitetural** que você invoca quando tem dúvidas sobre:
+
+- ✅ Deveria criar um novo agent, skill, workflow ou rule?
+- ✅ Como simplificar essa solução?
+- ✅ Qual é realmente o problema que estou tentando resolver?
+- ✅ Devemos adotar essa tendência?
+- ✅ Qual a diferença entre SDD e CDD na prática?
+
+---
+
+## 🚀 Como Usar
+
+### 1. Instale
+
+O skill vem com o framework. Sincronize a pasta da IDE (`$IDE/skills/`):
+
+```bash
+jarvis init --ide claude --force   # ou a sua IDE (cursor, windsurf, ...)
+```
+
+### 2. Invoque
+
+No chat da sua IDE:
+
+```
+/jarvis-evolution-architect "Sua pergunta arquitetural"
+```
+
+### 3. Exemplos
+
+```
+/jarvis-evolution-architect "Deveria criar um novo agent para validar specs?"
+
+/jarvis-evolution-architect "Acho essa arquitetura complexa demais. O que eu mudaria?"
+
+/jarvis-evolution-architect "Pesquise como MCP pode ser relevante pro Jarvis"
+```
+
+---
+
+## 🧠 Lentes de Análise
+
+A skill usa **4 lentes** para avaliar decisões:
+
+| Lente | O que questiona |
+|-------|----------------|
+| **SDD** | Intenção, requisitos, comportamento esperado |
+| **CDD** | Contexto, quando necessário, sem duplicação |
+| **Agentic SE** | Entendimento, decisões, autonomia do agente |
+| **Developer Experience** | Simplicidade, discoverability, manutenção |
+
+---
+
+## 💡 Filosofia
+
+**A pergunta principal não é:**
+> "Qual feature podemos adicionar?"
+
+**A pergunta principal é:**
+> "Qual é a melhor maneira de resolver o problema mantendo o Jarvis simples, extensível, coerente e AI-native?"
+
+---
+
+## 📊 Preferência Evolutiva
+
+A skill questiona **por que criar novo**. Ordem de preferência:
+
+```
+1. REUSE    → Usar existente como está
+2. EXTEND   → Estender existente
+3. REFACTOR → Reorganizar existente
+4. CREATE   → Criar novo (justifique!)
+```
+
+---
+
+## 🛡️ O Que a Skill Protege
+
+A skill **questiona ativamente**:
+
+- 🚫 Overengineering
+- 🚫 Abstrações desnecessárias
+- 🚫 Duplicação
+- 🚫 Excesso de configuração
+- 🚫 Excesso de agentes/skills
+- 🚫 Workflows desnecessariamente complexos
+- 🚫 Fragmentação excessiva
+
+---
+
+## 💬 Como Responde
+
+Estrutura típica de resposta:
+
+```
+Minha Leitura:
+[O que entendi]
+
+O Que Eu Acho:
+[Avaliação técnica]
+
+O Que Eu Mudaria:
+[Melhorias]
+
+O Que Eu Não Faria:
+[Problemas]
+
+Como Eu Faria:
+[Proposta arquitetural]
+
+Trade-Offs:
+[Ganhamos/Perdemos]
+
+Minha Recomendação:
+[Decisão clara]
+```
+
+---
+
+## 📁 Arquivos
+
+| Arquivo | Descrição |
+|---------|-----------|
+| **SKILL.md** (`../SKILL.md`) | Definição técnica da skill (role, comportamento, lentes) |
+| **guia-de-uso.md** | Como usar (invocação, quando usar, exemplos) |
+| **exemplos.md** | Exemplos reais de conversas |
+| **lentes-e-conceitos.md** | Documentação detalhada (SDD, CDD, Agentic SE) |
+| **visao-geral.md** | Este arquivo |
+
+---
+
+## ✅ Quando Usar
+
+```
+✅ "Deveria criar um novo agent?"
+✅ "Essa feature deveria ser skill ou workflow?"
+✅ "Acho isso muito complexo, como simplificar?"
+✅ "Qual a diferença entre agente e workflow?"
+✅ "Devemos adotar X tendência?"
+
+❌ "Qual skill uso para X?" (use /jarvis-find-skill)
+❌ "Como implemento X?" (use skill específica)
+❌ "Como debugo isso?" (use documentação)
+```
+
+---
+
+## 🎓 Exemplos Rápidos
+
+### Exemplo 1: Nova Feature
+```
+Você: "Vou criar um agent Spec Reviewer"
+Skill: "Não ainda. Começaria como workflow... [análise]"
+```
+
+### Exemplo 2: Simplificação
+```
+Você: "Temos 50+ skills, descobrimento é difícil"
+Skill: "Problema é discovery, não quantidade. [propostas]"
+```
+
+### Exemplo 3: Tendência
+```
+Você: "Devemos adotar MCP?"
+Skill: "Pesquisa necessária. [análise de tendência]"
+```
+
+---
+
+## 🔧 Personalidade
+
+- 🎯 Técnica e estratégica
+- 💬 Direta e opinativa
+- 🤔 Questiona antes de concordar
+- 🔍 Pesquisa quando necessário
+- 🤝 Colaborativa mas honesta
+
+**Você está falando com alguém que conhece arquitetura de software profundamente.**
+
+---
+
+## 📚 Recursos Inclusos
+
+### lentes-e-conceitos.md
+Documentação completa de:
+- SDD (Spec-Driven Development)
+- CDD (Context-Driven Development)
+- Agentic Software Engineering
+- Developer Experience
+- Classificação de artefatos
+- Preferência evolutiva
+- Princípios de proteção
+
+### exemplos.md
+5 exemplos reais:
+1. Nova Feature - Spec Reviewer Agent
+2. Simplificação - Context Optimizer
+3. Tendência - MCP Integration
+4. Discovery - Skills Organization
+5. Arquitetura - Agents vs Workflows
+
+### guia-de-uso.md
+Tudo que você precisa saber para usar:
+- Como invocar
+- Lentes de análise
+- Estrutura de resposta
+- Quando usar/não usar
+- Boas perguntas
+
+---
+
+## 🚀 Próximos Passos
+
+1. **Instale** com `jarvis init` (o skill vai para `$IDE/skills/`)
+2. **Leia** `guia-de-uso.md` para entender como usar
+3. **Consulte** `lentes-e-conceitos.md` para conceitos detalhados
+4. **Use** `/jarvis-evolution-architect` quando tiver dúvidas arquiteturais
+5. **Veja** `exemplos.md` para padrões de conversa
+
+---
+
+## 🎯 Vision
+
+Esta skill é parte da estratégia de manter o Jarvis:
+
+- ✅ **Simples** - Sem overengineering
+- ✅ **Extensível** - Fácil de evoluir
+- ✅ **Coerente** - Padrões consistentes
+- ✅ **AI-native** - Otimizado para agentes de IA
+
+---
+
+## 📝 Metadatas
+
+```
+Name: jarvis-evolution-architect
+Area: architecture
+Specialization: jarvis-framework-evolution
+Version: 1.0
+Framework: Jarvis 2.0+
+License: AGPL-3.0
+```
+
+---
+
+## 🔗 Integração com Jarvis
+
+O skill faz parte do framework e vai para a pasta da IDE com o `jarvis init`:
+
+```
+$IDE/skills/jarvis-evolution-architect/
+├── SKILL.md
+└── references/
+    ├── visao-geral.md
+    ├── guia-de-uso.md
+    ├── exemplos.md
+    └── lentes-e-conceitos.md
+```
+
+---
+
+**Criada**: 2026-10-04  
+**Versão**: 1.0  
+**Status**: Pronto para usar

package/skills/jarvis-init/SKILL.md

@@ -908,13 +908,13 @@ Se não existir na raiz do projeto:
 
 **Executar após gravar o ENV.md** (nos fluxos create, update B e upgrade C).
 
-Objetivo: garantir que `$IDE/rules/` contenha apenas as rules relevantes para o perfil do usuário, reduzindo tokens carregados em sessão.
+Objetivo: garantir que `$IDE/rules/` e `$IDE/rules-on-demand/` contenham apenas as rules relevantes para o perfil do usuário, reduzindo tokens carregados em sessão. A pasta `rules/` é carregada no início da sessão; a `rules-on-demand/` guarda as rules de uma etapa só, que cada workflow lê quando precisa (o Claude Code não a carrega sozinho). O filtro é o mesmo nas duas pastas, e `bin/lib/core/profile-filter.js` o espelha em JS (usado por `jarvis tokens`): ao mudar a lógica aqui, mude lá e em `rules/AGENTS.md`.
 
 **Passos:**
 
 ```
 1. Ler HUB, POSITION, AREA, SQUAD do ENV.md recém-gravado
-2. Listar todos os arquivos .md em rules/ (recursivo, exceto AGENTS.md)
+2. Para cada uma das duas pastas (rules/ e rules-on-demand/), listar todos os arquivos .md (recursivo, exceto AGENTS.md)
 3. Para cada arquivo:
    a. Ler o bloco `> **Applies to:**` (primeira ocorrência no arquivo)
    b. Se o bloco não existir → tratar como universal → copiar sempre
@@ -922,8 +922,8 @@ Objetivo: garantir que `$IDE/rules/` contenha apenas as rules relevantes para o
    d. **Condição especial RTK**: se o arquivo for `rtk-rules.md`,
       copiar APENAS se `RTK_ENABLED=true` no ENV.md
       (mesmo que o perfil bata, RTK é opt-in)
-   e. Se bate com o perfil → copiar para $IDE/rules/ (preservando subpastas)
-   f. Se não bate → deletar de $IDE/rules/ se existir lá
+   e. Se bate com o perfil → copiar para a mesma pasta em $IDE/ (rules/ → $IDE/rules/, rules-on-demand/ → $IDE/rules-on-demand/), preservando subpastas
+   f. Se não bate → deletar de $IDE/ se existir lá
 4. Exibir resumo ao usuário
 ```
 
@@ -976,8 +976,9 @@ function parseAppliesTo(fileContent) {
 ```bash
 # Exemplo: rules/engineering/qa/eng.qa.quality-gate-scoring-rules.md
 # Destino: $IDE/rules/engineering/qa/eng.qa.quality-gate-scoring-rules.md
-mkdir -p "$IDE/rules/$(dirname $relPath)"
-cp "rules/$relPath" "$IDE/rules/$relPath"
+# (o mesmo vale para rules-on-demand/ → $IDE/rules-on-demand/)
+mkdir -p "$IDE/$pasta/$(dirname $relPath)"
+cp "$pasta/$relPath" "$IDE/$pasta/$relPath"   # $pasta = rules ou rules-on-demand
 ```
 
 **Saída para o usuário:**
@@ -986,7 +987,7 @@ cp "rules/$relPath" "$IDE/rules/$relPath"
 🔍 Sincronizando rules para o perfil: HUB={HUB} | POSITION={POSITION} | AREA={AREA} | SQUAD={SQUAD}
 
 ✅ Rules sincronizadas:
-   Copiadas : N arquivos
+   Copiadas : N arquivos (rules/: N | rules-on-demand/: N)
    Removidas: N arquivos (não batem com o perfil)
    Universais: N arquivos (sem applies_to — sempre copiadas)
 ```
@@ -1064,6 +1065,12 @@ Apresentar checklist de onboarding por período (Dia 1, Semana 1, Mês 1).
 
 > **Checklists detalhados**: Ver `assets/onboarding-checklist.md`
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| Passo 9 — Adicionar as stacks (opcional) | `/jarvis-create-specialization {área} {stack}` | Se a pessoa escolher criar um skill novo para uma stack que ainda não tem especialização instalada (uma stack por vez; pular o passo não chama nada) |
+
 ---
 
 ## Validações de Segurança

package/skills/jarvis-list-specializations/SKILL.md

@@ -90,6 +90,12 @@ done
 - Um item da lista **sem skill instalado** aparece como "registrado sem skill instalado".
 - Se `$ARGUMENTS` for `backend` ou `frontend`, mostre só essa área.
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
 ---
 
 ## Saída

package/skills/jarvis-report-issue/SKILL.md

@@ -146,6 +146,12 @@ Erro:
 Verifique token (GitLab .npmrc / gh auth / BITBUCKET_TOKEN) e JARVIS_PROJECT.
 ```
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
 ---
 
 ## Regras

package/skills/product-roadmap-report/SKILL.md

@@ -157,6 +157,14 @@ Para cada projeto:
 - Corresponder ao idioma do usuário
 - Inserir novas atualizações ANTES do conteúdo antigo (cronologia reversa)
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
+Se o usuário usa Obsidian, a skill pode usar skills ou MCP de manipulação de notas disponíveis no ambiente; nenhum é nomeado neste arquivo.
+
 ## Regras Críticas
 
 ### NUNCA:

package/skills/product-specs/SKILL.md

@@ -21,6 +21,7 @@ Esta skill é só a **porta de entrada** das especificações de produto: ela **
 | Investigar uma ideia inicial | `/prod.spec.discovery` | `$IDE/$FLOWS_FOLDER/prod.spec.discovery.md` |
 | PRD (Documento de Requisitos de Produto) | `/prod.spec.prd` | `$IDE/$FLOWS_FOLDER/prod.spec.prd.md` |
 | FRD (Documento de Requisitos Funcionais) | `/prod.spec.frd` | `$IDE/$FLOWS_FOLDER/prod.spec.frd.md` |
+| ARD (requisitos arquiteturais a partir do produto) | `/prod.spec.ard` | `$IDE/$FLOWS_FOLDER/prod.spec.ard.md` |
 | Épico | `/prod.spec.epic` | `$IDE/$FLOWS_FOLDER/prod.spec.epic.md` |
 | História, tarefa ou bug | `/prod.spec.issue` | `$IDE/$FLOWS_FOLDER/prod.spec.issue.md` |
 | Esclarecer uma especificação | `/prod.spec.clarify` | `$IDE/$FLOWS_FOLDER/prod.spec.clarify.md` |
@@ -43,3 +44,11 @@ Para outras necessidades de produto sem workflow próprio, aplique as boas prát
 **Discovery:** "investigar uma ideia..." · "fazer discovery de..." · "tenho uma ideia, vale a pena?"
 
 **Esclarecimento:** "esclarecer a especificação..." · "esclarecer o PRD..."
+
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
+A skill só roteia para os workflows `prod.spec.*` (tabela acima); workflows não são skills e ficam fora desta tabela.

package/skills/product-specs-update/SKILL.md

@@ -150,6 +150,12 @@ apenas o que estiver faltando.
 Escrever ou atualizar o `specs-index.md` no Drive seguindo o template
 de Índice Global abaixo.
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| Pré-requisito — Carregar ENV.md | `/jarvis-init` | Se o `ENV.md` não existir (executado via Skill tool) |
+
 ---
 
 ## Templates