jarvis-ai-framework 7.0.0 → 8.2.0

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

@@ -1,7 +1,7 @@
 ---
 name: product-roadmap-report
 description: Cria e atualiza relatórios estruturados de roadmap de produto a partir de reuniões, mensagens, documentos ou notas. Use quando usuários precisam extrair atualizações de roadmap em relatórios markdown com seções de resumo, problemas, riscos e ações, consolidar múltiplos relatórios de times, atualizar relatórios existentes mantendo ordem cronológica reversa, salvar/modificar relatórios no Obsidian vault, ou mencionar termos como "relatório de roadmap", "atualização de produto", "sync", "war room", "relatório do time" ou "atualização semanal".
-allowed-tools: conversation_search, google_drive_search, google_drive_fetch
+allowed-tools: conversation_search, google_drive_search, google_drive_fetch, Bash, WebFetch
 metadata:
   author: jarvis-team
   version: "1.0.0"
@@ -25,7 +25,7 @@ Por favor, siga o `rules/status-report-rules.md` para obter orientações corret
 Sempre interaja com o usuário no mesmo idioma que ele estiver usando.
 
 ### Roadmap Preview:
-- Quando o usuário perguntar sobre roadmap, status, sprint, atualizações, etc., execute as instruções de `commands/status-roadmap-preview`
+- Quando o usuário perguntar sobre roadmap, status, sprint, atualizações, etc., execute as instruções de `commands/status.roadmap.preview.md`
 - Use o `$ARGUMENTS` do usuário para obter a resposta correta.
 
 

package/skills/product-roadmap-report/commands/status.memory.md

@@ -84,7 +84,7 @@ I see some terms I want to make sure I understand:
 
 Continue through each information, asking only about terms you haven't already decoded.
 
-Gather data from available installed MCP sources:
+Gather data from available installed MCP sources (chat, email, documents and calendar only; the board and git are read only through the vendor's official CLI, see `eng.integrations-rules.md`):
 - **Chat:** Recent messages, channels, DMs
 - **Email:** Sent messages, recipients
 - **Documents:** Recent docs, collaborators

package/skills/product-roadmap-report/commands/status.roadmap.preview.md

@@ -3,7 +3,7 @@ name: prod-roadmap-preview
 description: >
   Use esta habilidade sempre que alguém perguntar sobre roadmap de produto, status de entrega, status de sprint, atualizações de equipe ou relatórios de status.
   Aciona quando os usuários perguntam coisas como: "qual o roadmap?", "quais são as entregas do trimestre?", "status do time X", "o que está sendo feito?", "quando vai sair feature Y?", "me mostra o roadmap", "status report do time", "próximas entregas", "roadmap do produto", "o que está planejado?", "report do time", "andamento dos projetos".
-  Essa habilidade se conecta ao Jira (Atlassian) e às páginas wiki internas para buscar dados ao vivo sobre o roteiro do produto e relatórios de status da equipe.
+  Essa habilidade lê o board pela CLI oficial do vendor (só leitura) e as páginas wiki internas pela URL que o usuário informar (`web_fetch`, ou texto colado; sem MCP) para buscar dados ao vivo sobre o roteiro do produto e relatórios de status da equipe.
 ---
 
 # Status Roadmap Preview
@@ -25,7 +25,7 @@ Use este fluxo sempre que alguém perguntar sobre:
 ## Regras
 
 - Se não tiver informações suficientes sobre o `$TASK_MANAGER` utilizado pelo usuário, pergunte qual é o `$TASK_MANAGER` e adapte a resposta de acordo.
-- Sempre utilize MCPs configurados especificos do `$TASK_MANAGER` utilizado para buscar informações atualizadas (pré-requisito manual: o `/jarvis-init` não configura MCP de board)
+- Leia o board pela CLI oficial do `$TASK_MANAGER` (`acli` no Jira, `gh` no GitHub, `glab` no GitLab), com o login dela, sem REST nem MCP (`eng.integrations-rules.md`). Só leitura: nada é comentado nem criado no board. Sem a CLI logada (ou com `TASK_MANAGER_ACCESS=manual`), peça ao usuário para exportar ou colar os dados.
 - Procure na pasta de trabalho para entender mais sobre o projeto.
 - Caso não tiver informações sobre o projeto, fontes de dados ou `$TASK_MANAGER`, informe ao usuário que não tem informações suficientes e peça para ele fornecer mais detalhes.
 

package/skills/product-specs/SKILL.md

@@ -2,7 +2,7 @@
 name: product-specs
 description: Ações e fluxos de trabalho para criar, modificar, analisar e atualizar especificações de produto como PRDs, FRDs, Storys, e tarefas de gerenciamento de produtos e projetos.
 argument-hint: "Peça para criar, atualizar ou modificar uma especificação de PRD, FRD ou Story."
-allowed-tools: conversation_search, google_drive_search, google_drive_fetch, slack, figma
+allowed-tools: conversation_search, google_drive_search, google_drive_fetch, figma
 disable-model-invocation: false
 license: AGPL-3.0
 metadata:

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

@@ -1,43 +1,98 @@
 ---
 name: product-specs-update
 description: >
-  Sincroniza especificações de produto (PRD/FRD) em cascata e mantém dois
-  índices atualizados: um local (projeto atual) e um global no Google Drive
-  (todos os projetos). Trigger: quando um PRD ou FRD é criado ou modificado,
-  ou quando o usuário pede para sincronizar ou indexar specs.
-allowed-tools: Read Write Edit Grep Glob Bash MCP
+  Sincroniza especificações de produto (PRD/FRD) em cascata e mantém o
+  índice local de specs (`$PROD_DOCS/specs-index.md`) atualizado. Trigger:
+  quando um PRD ou FRD é criado ou modificado, ou quando o usuário pede para
+  sincronizar ou indexar specs.
+argument-hint: "[path-do-arquivo-criado-ou-modificado]"
+disable-model-invocation: false
+allowed-tools: Read Write Edit Grep Glob Bash
+license: AGPL-3.0
 metadata:
   author: jarvis-team
-  version: "1.0"
+  version: "2.0"
   area: product
-argument-hint: "[path-do-arquivo-criado-ou-modificado]"
-disable-model-invocation: false
 ---
 
 # Update Specs — Sincronização de Especificações de Produto
 
-Você é responsável por manter PRDs, FRDs e os índices de specs sempre
-consistentes. Quando uma spec muda, você propaga em cascata e atualiza
-dois índices: o local do projeto na pasta `docs` e o global no repositório `$CENTRAL_DOCS_REPO`.
+## Objetivo
 
-O Central Docs é a pasta que centralizamos todas as especificações de produto. Ele serve como referência para todos os projetos e deve ser atualizada sempre que houver mudanças em qualquer spec.
+Manter PRDs, FRDs e o índice de specs sempre consistentes. Quando uma spec
+muda, você propaga em cascata (a seção `## Solução` do PRD e o `related_prd`
+da FRD) e atualiza o índice local do projeto (`$PROD_DOCS/specs-index.md`).
 
+O índice é só local: PRD e FRD são documentos de trabalho e não vão para o
+Central docs, que guarda só o que foi implementado (`feature-*` e
+`delivery-*`, publicados pelo `/eng.spec-consolidate`). Para saber o que já
+foi implementado, leia o índice do Central docs com
+`jarvis docs fetch {SQUAD}/index.md` (skill `jarvis-docs-central`); este skill
+não escreve nada lá.
 
 ## Entrada
 
 - `$ARGUMENTS` — (Opcional) Path do arquivo criado ou modificado.
-- Pergunte para o usuário qual o path do Centarl Docs, que é onde devemos adicionar e atualizar as especificações de produto.
+
+## Recursos
+
+- `rules/product/prod-rules.md`: layout de `$PROD_DOCS` e status das specs
+- `templates/product/prod-prd-template.md` e `prod-frd-template.md`: frontmatter (`id`, `name`, `status`, `related_prd`)
+- Template do índice local: seção "Templates", abaixo
 
 ---
 
 ## Pré-requisito — Carregar ENV.md
 
-Antes de qualquer ação, ler o `ENV.md` e extrair as variáveis necessárias:
+Antes de qualquer ação, ler o `$IDE/ENV.md`. `$IDE` é a pasta da IDE ativa
+(`.claude/`, `.cursor/`, `.windsurf/`…), e não o valor de `IDE=` do `ENV.md`:
+troque-a pela pasta real antes de rodar.
 ```bash
-cat ENV.md
+cat "$IDE/ENV.md"
 ```
 
-Se não existir um `ENV.md`, crie executando a skill `jarvis-init`  com  Skill tool.
+Resolver `$PROD_DOCS` até o caminho real, expandindo as variáveis do próprio
+`ENV.md` (ex.: `PROD_DOCS=$JARVIS_DOCS/$PROD_FOLDER_NAME` → `docs/jarvis/product`,
+relativo à pasta do workspace). Os comandos abaixo usam esse caminho, entre
+aspas. Se `$PROD_DOCS` ficar vazio, pare e avise: um `grep -r` sem caminho lê
+a entrada padrão e fica parado.
+
+Se não existir um `ENV.md`, crie executando a skill `jarvis-init` com Skill tool.
+
+---
+
+## Quando Usar
+
+- Um PRD ou FRD foi criado ou modificado (pelos `/prod.spec.*` ou à mão)
+- O usuário pede para sincronizar specs ou reconstruir o índice local
+
+**Não usar** para publicar specs ou índice no Central docs: ele recebe só a
+consolidação do `/eng.spec-consolidate`.
+
+## Padrões Críticos
+
+- **Frontmatter, não a linha solta.** Leia `id`, `name`, `status` e
+  `related_prd` só do bloco entre os dois primeiros `---`. O `related_prd`
+  aparece de vários jeitos e todos valem: vazio, `[]`, `PRD-001` na mesma
+  linha ou lista em várias linhas (`related_prd:` seguido de `  - PRD-001`).
+  Só trate como vazio depois de olhar as linhas de baixo.
+- **FRD é quem tem `id: FRD-`.** Breakdowns, revisões e arquivos de `issues/`
+  também podem ter `related_prd`, mas não são FRDs.
+- **Spec é identificada pelo caminho.** O mesmo `id` pode existir em pastas
+  diferentes (dois `PRD-001`). Liste as duas e avise o id repetido; nunca
+  junte nem descarte nenhuma.
+- **Só local.** Nada é publicado fora da máquina; toda gravação mostra o
+  diff e aguarda confirmação.
+
+Leitura do frontmatter (usada em todos os passos):
+```bash
+# Bloco do frontmatter
+awk '/^---[[:space:]]*$/{n++; next} n==1' "{arquivo}"
+
+# Só os PRDs do related_prd, em qualquer um dos formatos (um por linha; "[]" = vazio)
+awk '/^---[[:space:]]*$/{n++; next} n==1' "{arquivo}" \
+  | awk '/^related_prd:/{p=1; sub(/^related_prd:[[:space:]]*/,""); if($0!="")print; next} p&&/^[[:space:]]+-/{sub(/^[[:space:]]+-[[:space:]]*/,""); print; next} {p=0}'
+```
 
 ---
 
@@ -48,7 +103,7 @@ $ARGUMENTS fornecido?
       id começa com "PRD"? → Fluxo PRD  
       id começa com "FRD"? → Fluxo FRD  
       Nem um nem outro?    → Avisar e encerrar
-  → NÃO: Ir direto para Reconstrução Completa dos Índices
+  → NÃO: Ir direto para Reconstrução do Índice
 ```
 
 ---
@@ -57,19 +112,20 @@ $ARGUMENTS fornecido?
 
 ### 1. Fluxo FRD — quando uma FRD foi criada ou modificada
 
-Extrair do frontmatter:
-```bash
-grep -E "^(id|name|status|related_prd):" {arquivo_frd}
-```
+Extrair do frontmatter `id`, `name`, `status` e `related_prd` (ver "Padrões
+Críticos").
 
-**Se `related_prd` estiver ausente ou vazio**, perguntar:
+**Se `related_prd` estiver ausente ou vazio** (sem nenhum `PRD-xxx` em
+nenhum dos formatos), perguntar:
 ```
 A FRD "{id}: {name}" não tem PRD pai definido.
-→ Qual é o path do PRD relacionado?
+→ Qual é o id do PRD relacionado? (ex.: PRD-001)
 ```
-Atualizar o frontmatter da FRD com o valor informado antes de continuar.
+Atualizar o frontmatter da FRD com o id informado antes de continuar.
 
-**Abrir o PRD referenciado** e verificar a seção `## Solução`:
+**Abrir o PRD referenciado** e verificar a seção `## Solução`. Se houver mais
+de um PRD com esse id, use o da mesma pasta da FRD; sem PRD na mesma pasta,
+pergunte qual é:
 
 - FRD **não aparece na lista** → Adicionar entry:
   `- **[{id}]({path_relativo}) ({status}):** {name}`
@@ -81,40 +137,48 @@ Mostrar diff proposto ao usuário. Aguardar confirmação antes de escrever.
 
 ### 2. Fluxo PRD — quando um PRD foi criado ou modificado
 
-Extrair do frontmatter:
-```bash
-grep -E "^(id|name|status):" {arquivo_prd}
-```
+Extrair do frontmatter `id`, `name` e `status`.
 
-Buscar FRDs filhas nos dois diretórios:
+Buscar as FRDs de todo o `$PROD_DOCS` (na pasta do PRD ou em pasta própria):
 ```bash
-grep -rl "related_prd:" $PROD_DOCS --include="*.md"
+grep -rlE --include="*.md" --exclude-dir=issues "^id: FRD-" "$PROD_DOCS"
 ```
 
-Filtrar apenas as que apontam para este PRD. Para cada FRD encontrada,
-verificar na seção `## Solução` do PRD se o entry está presente e com
-status correto. Atualizar divergências.
+Ficar só com as que têm o id deste PRD no `related_prd`. Se o id do PRD se
+repete em outra pasta, ficar só com as FRDs da mesma pasta deste PRD e
+perguntar sobre as de pasta própria. Para cada FRD encontrada, verificar na
+seção `## Solução` do PRD se o entry está presente e com status correto.
+Atualizar divergências.
 
 Mostrar diff proposto ao usuário. Aguardar confirmação antes de escrever.
 
 ---
 
-### 3. Reconstrução dos Índices
+### 3. Reconstrução do Índice
 
 Executado sempre após os fluxos acima, ou diretamente quando `$ARGUMENTS`
 está vazio.
 
 #### 3.1 Escanear specs locais
+Layout de `$PROD_DOCS` (`prod-rules.md`): cada PRD fica em
+`prd-{id}-{nome}/prd-{id}-{nome}.md`, com as FRDs na mesma pasta
+(`frd-{id}-{nome}.md`); uma FRD sem PRD pai pode ter pasta própria
+(`frd-{id}-{nome}/`). A varredura é recursiva e lê o `id` do frontmatter:
 ```bash
-# PRDs
-find $PROD_DOCS -maxdepth 1 -name "*.md" | xargs grep -l "^id: PRD"
-
-# FRDs
-find $PROD_DOCS_FRD -name "*.md" | xargs grep -l "^id: FRD"
+# PRDs e FRDs em qualquer pasta de $PROD_DOCS (épicos e histórias de issues/ ficam de fora)
+grep -rlE --include="*.md" --exclude-dir=issues "^id: (PRD|FRD)-" "$PROD_DOCS"
 ```
 
-Para cada arquivo, extrair via grep: `id`, `name`, `status`
-(e `related_prd` nas FRDs).
+Arquivos sem `id: PRD-`/`id: FRD-` (revisões, breakdowns) ficam de fora.
+
+Para cada arquivo, extrair do frontmatter `id`, `name`, `status` e, nas FRDs,
+`related_prd` (ver "Padrões Críticos").
+
+Identificar cada spec pelo **caminho**, e não só pelo `id`. Com id repetido,
+listar as duas no índice e avisar o usuário. Para pôr uma FRD sob o PRD certo
+em "Relação PRD → FRDs": o PRD com o id do `related_prd` na mesma pasta da
+FRD; se não houver um na mesma pasta e o id se repetir, perguntar ao usuário
+em vez de escolher. FRD sem `related_prd` vai para "FRDs sem PRD pai".
 
 #### 3.2 Obter projeto e repositório para cada PRD
 
@@ -131,24 +195,11 @@ O PRD "{id}: {name}" ainda não tem projeto ou repositório mapeado.
 #### 3.3 Gerar o índice local
 
 Escrever ou atualizar `$PROD_DOCS/specs-index.md` seguindo o template
-de Índice Local abaixo.
+de Índice Local abaixo. Mostrar o diff proposto e aguardar confirmação
+antes de gravar.
 
-#### 3.4 Escanear specs no Drive (se MCP disponível)
-
-Acessar `$CENTRAL_DOCS_REPO` via MCP e listar todos os arquivos `.md`.
-
-Para cada arquivo encontrado, extrair os metadados YAML (`id`, `name`,
-`status`, `related_prd`). Consolidar com os dados locais, deduplizando
-por `id`.
-
-#### 3.5 Gerar o índice global no Drive (se MCP disponível)
-
-Verificar se `specs-index.md` já existe na raiz da pasta do Drive.
-Reutilizar mapeamentos de projeto/repositório já registrados. Perguntar
-apenas o que estiver faltando.
-
-Escrever ou atualizar o `specs-index.md` no Drive seguindo o template
-de Índice Global abaixo.
+O índice fica só na máquina: não é publicado no Central docs nem em
+outro lugar.
 
 ### Skills invocados durante a execução do skill
 
@@ -165,7 +216,7 @@ de Índice Global abaixo.
 # Índice de Especificações — {WORKSPACE}
 
 Índice das especificações do projeto atual. Atualizado automaticamente
-pela skill `prod-update-specs`.
+pela skill `product-specs-update`.
 
 _Última atualização: {YYYY-MM-DD}_
 
@@ -175,69 +226,23 @@ _Última atualização: {YYYY-MM-DD}_
 
 | Spec | Status | Projeto | Repositório Git |
 |------|--------|---------|-----------------|
-| [PRD-001 — Nome](./prd-001.md) | in_progress | Projeto A | [repo-a](url) |
-| [FRD-001 — Nome](./frds/frd-001.md) | in_review | Projeto A | [repo-a](url) |
+| [PRD-001 — Nome](./prd-001-nome/prd-001-nome.md) | in_progress | Projeto A | [repo-a](url) |
+| [FRD-001 — Nome](./prd-001-nome/frd-001-nome.md) | in_review | Projeto A | [repo-a](url) |
+| [FRD-002 — Nome](./frd-002-nome/frd-002-nome.md) | backlog | Projeto A | [repo-a](url) |
 
 ---
 
 ## Relação PRD → FRDs
 
 ### PRD-001: Nome do PRD
-- [FRD-001 — Nome](./frds/frd-001.md) · `in_review`
-- [FRD-002 — Nome](./frds/frd-002.md) · `in_progress`
-```
-
----
+- [FRD-001 — Nome](./prd-001-nome/frd-001-nome.md) · `in_review`
 
-### Índice Global (`specs-index.md` no Drive)
-```markdown
-# Índice Global de Especificações
-
-Índice consolidado de todas as especificações de produto, abrangendo todos
-os projetos. Atualizado automaticamente pela skill `prod-update-specs`.
-
-_Última atualização: {YYYY-MM-DD}_
-
----
-
-## Relação de Arquivos e Projetos
-
-| Spec | Status | Projeto | Repositório Git |
-|------|--------|---------|-----------------|
-| [PRD-001 — Nome](link-drive) | in_progress | Projeto A | [repo-a](url) |
-| [PRD-002 — Nome](link-drive) | in_review   | Projeto B | [repo-b](url) |
-| [FRD-001 — Nome](link-drive) | in_progress | Projeto A | [repo-a](url) |
-
----
-
-## Projetos
-
-| Projeto | Specs relacionadas |
-|---------|--------------------|
-| Projeto A | PRD-001, FRD-001, FRD-002 |
-| Projeto B | PRD-002, FRD-003 |
-
----
-
-## Repositórios
-
-| Repositório | Specs relacionadas |
-|-------------|-------------------|
-| [repo-a](url) | PRD-001, FRD-001, FRD-002 |
-| [repo-b](url) | PRD-002, FRD-003 |
-
----
-
-## Relação PRD → FRDs
-
-### PRD-001: Nome — Projeto A
-- [FRD-001 — Nome](link-drive) · `in_progress`
-- [FRD-002 — Nome](link-drive) · `in_review`
-
-### PRD-002: Nome — Projeto B
-- [FRD-003 — Nome](link-drive) · `icebox`
+### FRDs sem PRD pai
+- [FRD-002 — Nome](./frd-002-nome/frd-002-nome.md) · `backlog`
 ```
 
+Os links são relativos ao `specs-index.md`, que fica na raiz de `$PROD_DOCS`.
+
 ---
 
 ## Regras
@@ -247,24 +252,25 @@ _Última atualização: {YYYY-MM-DD}_
 - Sobrescrever mapeamentos de projeto/repositório já registrados sem perguntar
 - Escrever mudanças em cascata sem mostrar o diff antes
 - Alterar o bloco de versionamento dos docs
+- Publicar o índice ou as specs no Central docs ou em qualquer lugar fora da máquina
+- Escolher sozinho entre dois PRDs com o mesmo id
 
 ### Sempre
 - Mostrar resumo das mudanças propostas e aguardar confirmação
 - Preservar paths relativos corretos entre os arquivos
-- Tratar Drive como indisponível graciosamente — nunca bloquear o fluxo local
-- Reutilizar mapeamentos de projeto/repo já existentes nos índices
+- Reutilizar mapeamentos de projeto/repo já existentes no índice
+- Ler o `related_prd` em todos os formatos antes de tratá-lo como vazio
 
 ---
 
 ## Checklist de Conclusão
 
-- [ ] ENV.md lido — `$PROD_DOCS`, `$PROD_DOCS_FRD` e `$CENTRAL_DOCS_REPO` extraídos
-- [ ] Disponibilidade do Drive MCP verificada
+- [ ] ENV.md lido — `$PROD_DOCS` resolvido até o caminho real
 - [ ] Tipo do arquivo identificado (PRD / FRD / scan completo)
 - [ ] Cascata de atualizações mapeada e confirmada pelo usuário
+- [ ] Ids repetidos avisados e resolvidos (mesma pasta ou pergunta)
 - [ ] Projeto e repositório obtidos para specs sem mapeamento
 - [ ] Índice local gerado em `$PROD_DOCS/specs-index.md`
-- [ ] Índice global gerado no Drive (se MCP disponível)
 - [ ] Links internos validados
 
 ---
@@ -274,6 +280,17 @@ _Última atualização: {YYYY-MM-DD}_
 | Artefato | Escopo | Condição |
 |----------|--------|----------|
 | `$PROD_DOCS/specs-index.md` | Projeto atual | Sempre |
-| `specs-index.md` no Drive | Todos os projetos | MCP conectado ou Integração ativa |
 | PRDs afetados | Seção "Solução" sincronizada | Quando FRD muda |
-| FRDs afetadas | `related_prd` preenchido | Quando ausente |
+| FRDs afetadas | `related_prd` preenchido | Quando ausente |
+
+## Mensagem de Conclusão
+
+```
+✅ Specs sincronizadas
+
+📄 Índice: $PROD_DOCS/specs-index.md ({n} PRDs, {m} FRDs)
+🔁 Cascata: {k} arquivos atualizados (PRD "Solução" / FRD related_prd)
+⚠️ Ids repetidos: {lista ou "nenhum"}
+
+O índice é local: nada foi publicado.
+```

package/templates/ENV-template.md

@@ -7,7 +7,9 @@
 # =============================================================================
 
 
-# --- Workspace e identidade --------------------------------------------------
+# =============================================================================
+# Workspace e identidade
+# =============================================================================
 # Workspace = a pasta que contém $IDE/. Não é o nome de um repo.
 # Vazio: o CLI usa o nome dessa pasta. Preencha só se quiser outro slug.
 #
@@ -38,14 +40,18 @@ MAX_AI_EXECUTION_PERCENTAGE=80
 ENABLE_CDD=true
 
 
-# --- Organização (obrigatório — opções vêm do taxonomy.md) -------------------
+# =============================================================================
+# Organização (obrigatório — opções vêm do taxonomy.md)
+# =============================================================================
 SQUAD=[CORE]
 HUB=[AI, FRONTEND, BACKEND, QA, DATA, FULLCYCLE]
 AREA=[ENGINEERING, PRODUCT]
 POSITION=[JUNIOR, PLENO, SENIOR, TECH LEAD, SPECIALIST, PM, TPM, GPM, CTO, GENERALIST]
 
 
-# --- IDE e pastas ------------------------------------------------------------
+# =============================================================================
+# IDE e pastas
+# =============================================================================
 # Qual IDE este ENV.md alimenta. FLOWS_FOLDER: workflows (maioria) ou commands (Claude).
 IDE=[windsurf, claude, cursor, codex, opencode, gemini, antigravity]
 DOCS_FOLDER=docs
@@ -94,7 +100,9 @@ PROD_MODE=
 ARTIFACT_STYLE=ai-generated
 
 
-# --- Especializações por área -------------------------------------------------
+# =============================================================================
+# Especializações por área
+# =============================================================================
 # Skills especializados que o Jarvis carrega junto com o skill base de cada área.
 # Lista de nomes de skill separados por vírgula. Ex: eng-backend-golang,eng-backend-nestjs
 # Vazio = só o skill base de cada área (eng-backend, eng-frontend, eng-qa,
@@ -110,7 +118,9 @@ AUTOMATION_SPECIALIZATIONS=
 PLATFORM_SPECIALIZATIONS=
 
 
-# --- Task manager (opcional) -------------------------------------------------
+# =============================================================================
+# Task manager (opcional)
+# =============================================================================
 # Board de cards: jira (só Jira Cloud), github ou gitlab. Vazio = freelance: o workflow
 # pergunta um número de controle próprio (TASK_MANAGER_KEY) e as ações viram .md.
 # O Jarvis fala com o board pela CLI oficial, com o login dela (gh auth login,
@@ -127,7 +137,9 @@ TASK_MANAGER_ACCESS=[cli, manual]
 TASK_MANAGER_URL_BASE=
 
 
-# --- Controle de versão (opcional) -------------------------------------------
+# =============================================================================
+# Controle de versão (opcional)
+# =============================================================================
 # Host de git do projeto: github ou gitlab. O repositório e o host vêm do
 # git remote get-url origin. PR/MR pela CLI oficial (gh pr create, glab mr create),
 # com o login dela. Nenhum token vai neste arquivo.
@@ -137,13 +149,17 @@ VERSION_CONTROL=[github, gitlab]
 VERSION_CONTROL_ACCESS=[cli, manual]
 
 
-# --- Mensageria (opcional) ---------------------------------------------------
+# =============================================================================
+# Mensageria (opcional)
+# =============================================================================
 MESSAGE_BROKER=[rabbitmq, kafka, sqs]
 MESSAGE_BROKER_URL_API=
 MESSAGE_BROKER_API_AUTH=
 
 
-# --- Banco de dados (opcional) -----------------------------------------------
+# =============================================================================
+# Banco de dados (opcional)
+# =============================================================================
 DATABASE=[mysql, postgres, mongodb]
 USER_DATABASE=
 PASSWORD_DATABASE=
@@ -151,7 +167,9 @@ HOST_DATABASE=
 PORT_DATABASE=
 
 
-# --- Chat / comunicador (opcional) -------------------------------------------
+# =============================================================================
+# Chat / comunicador (opcional)
+# =============================================================================
 # slack: BOT_TOKEN + SIGNING_SECRET + APP_TOKEN (Socket Mode)
 # discord: BOT_TOKEN (Bot) + ALERTS_CHANNEL = ID do canal
 # teams: BOT_TOKEN = URL do Incoming Webhook (SIGNING/APP vazios)
@@ -162,29 +180,39 @@ MESSAGE_COMUNICATOR_APP_TOKEN=
 ALERTS_CHANNEL=
 
 
-# --- Object storage (opcional) -----------------------------------------------
+# =============================================================================
+# Object storage (opcional)
+# =============================================================================
 OBJECT_STORAGE=[aws_s3, gcs, azure_blob]
 TOKEN_OBJECT_STORAGE=
 
 
-# --- Observabilidade (opcional) ----------------------------------------------
+# =============================================================================
+# Observabilidade (opcional)
+# =============================================================================
 OBSERVABILITY=[sentry, datadog, grafana]
 TOKEN_OBSERVABILITY=
 OBSERVABILITY_ORG=
 
 
-# --- SMTP (opcional) ---------------------------------------------------------
+# =============================================================================
+# SMTP (opcional)
+# =============================================================================
 SMTP=[google, ses, sendgrid]
 
 
-# --- RTK — Token Killer (opcional) -------------------------------------------
+# =============================================================================
+# RTK — Token Killer (opcional)
+# =============================================================================
 # Proxy CLI em Rust que comprime output de shell (economia 60–90% de tokens).
 # Instale com: cargo install rtk (requer Rust).
 # false = a rule RTK não é copiada para $IDE/rules/.
 RTK_ENABLED=false
 
 
-# --- Advisor (opcional) ------------------------------------------------------
+# =============================================================================
+# Advisor (opcional)
+# =============================================================================
 # Modelos oferecidos quando o usuário escolhe usar o Advisor no início do eng.start,
 # separados por vírgula. Até 4 viram opções da pergunta; o resto fica em "Outro".
 # Vazio ou ausente = o Advisor usa "Sonnet 5.5" (fallback).
@@ -194,7 +222,9 @@ RTK_ENABLED=false
 ADVISOR_MODELS="Sonnet 5.5,Opus 5.5,Opus 5,Fable 5.1"
 
 
-# --- Data Engineering (só se HUB=DATA) ---------------------------------------
+# =============================================================================
+# Data Engineering (só se HUB=DATA)
+# =============================================================================
 # Obrigatório quando HUB=DATA. Omitir o bloco inteiro se o HUB for outro.
 DATA_ORCHESTRATOR=[airflow, prefect, dagster, glue-scheduler]
 DATA_ETL_TOOL=[aws_glue, dbt, spark, pandas]
@@ -207,7 +237,9 @@ DATA_WAREHOUSE=[redshift, snowflake, bigquery]
 DATA_REPO=[data-pipelines, etl-jobs, analytics-pipelines]
 
 
-# --- Code quality (opcional) -------------------------------------------------
+# =============================================================================
+# Code quality (opcional)
+# =============================================================================
 # Análise estática / quality gate. Em branco = sem MCP de code quality.
 CODE_QUALITY_TOOL=[sonarqube, codeclimate, deepsource]
 # URL da instância (self-hosted).
@@ -215,22 +247,18 @@ CODE_QUALITY_URL=
 CODE_QUALITY_TOKEN=
 
 
-# --- QA / suíte de testes (opcional) -----------------------------------------
+# =============================================================================
+# QA / suíte de testes (opcional)
+# =============================================================================
 # Caminho relativo à raiz do projeto.
 # Cypress E2E: cypress | e2e | tests/e2e
 # Unit/integração: tests | test | src/__tests__
 TEST_FOLDER=
 
 
-# --- QA / release sign-off (opcional) ----------------------------------------
-# Branches que exigem sign-off QA antes do deploy (vírgula, aceita glob).
-# Em branco = validação no CI desligada.
-QA_SIGNOFF_BRANCHES=main,release/*
-# Validade do sign-off em horas. Mais antigo que isso o CI rejeita.
-QA_SIGNOFF_MAX_AGE=24
-
-
-# --- Reportar bug no próprio Jarvis (opcional) ------------------------------
+# =============================================================================
+# Reportar bug no próprio Jarvis (opcional)
+# =============================================================================
 # URL completa do repositório do Jarvis (oficial por padrão; troque só para um fork interno).
 # Usado pelo skill /jarvis-report-issue, pela CLI do host (gh issue create; login: gh auth login).
 # O repositório do projeto vem do .git, não daqui. Vazio: o upgrade preenche com o oficial.
@@ -238,7 +266,9 @@ QA_SIGNOFF_MAX_AGE=24
 JARVIS_PROJECT=https://github.com/phelipperibeiro/jarvis-framework
 
 
-# --- Central docs -------------------------------------------------------------
+# =============================================================================
+# Central docs
+# =============================================================================
 # O registro do que FOI IMPLEMENTADO: um documento completo por funcionalidade e um registro
 # por entrega, gerados pelo /eng.spec-consolidate depois de cada PR. Ligado por padrão.
 # Nunca dentro do versionamento de um repositório de código.

package/templates/cdd-aplicado-a-prompts.md

@@ -179,4 +179,4 @@ eng.work (Fase 0) ← herda
 1. ~~**Aplicar CDD nos agents de QA restantes**~~: ✅ `eng.qa.test-architect.md`, `eng.qa.test-planner.md`
 2. ~~**Criar skill de detecção de contexto**~~: ✅ Implementado em `/jarvis-context-detect`
 3. ~~**Adicionar escape hatches explícitos**~~: ✅ Implementado via `--override`
-4. **Integração com Jira**: Detectar tipo de tarefa automaticamente via API do Jira
+4. **Integração com o board**: Detectar tipo de tarefa automaticamente pela CLI oficial do board