jarvis-ai-framework 2.0.0 → 2.1.1

package/skills/eng-backend-rabbitmq/SKILL.md

@@ -281,33 +281,25 @@ curl -s -X DELETE -u "$AUTH" \
   "$MB_URL/queues/%2F/{nome-fila}/contents"
 ```
 
----
+### Skills invocados durante a execução do skill
 
-## Referência de Endpoints
-
-| Operação | Método | Endpoint |
-|----------|--------|----------|
-| Status geral | GET | `/api/overview` |
-| Listar filas | GET | `/api/queues` |
-| Detalhes de fila | GET | `/api/queues/{vhost}/{name}` |
-| Criar fila | PUT | `/api/queues/{vhost}/{name}` |
-| Deletar fila | DELETE | `/api/queues/{vhost}/{name}` |
-| Purgar fila | DELETE | `/api/queues/{vhost}/{name}/contents` |
-| Consumir mensagens | POST | `/api/queues/{vhost}/{name}/get` |
-| Listar exchanges | GET | `/api/exchanges/{vhost}` |
-| Criar exchange | PUT | `/api/exchanges/{vhost}/{name}` |
-| Deletar exchange | DELETE | `/api/exchanges/{vhost}/{name}` |
-| Publicar mensagem | POST | `/api/exchanges/{vhost}/{name}/publish` |
-| Listar bindings | GET | `/api/bindings/{vhost}` |
-| Criar binding (fila) | POST | `/api/bindings/{vhost}/e/{exchange}/q/{queue}` |
-| Deletar binding | DELETE | `/api/bindings/{vhost}/e/{exchange}/q/{queue}/{props}` |
-| Listar connections | GET | `/api/connections` |
-| Fechar connection | DELETE | `/api/connections/{name}` |
-| Listar channels | GET | `/api/channels` |
-| Listar vhosts | GET | `/api/vhosts` |
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
 
 ---
 
+## Referências (leia só o tema que a tarefa pedir)
+
+Leia **só** o arquivo do tema que a tarefa pedir; o restante fica fora do contexto.
+
+| Tema | Quando ler | Arquivo |
+|------|-----------|---------|
+| Referência de Endpoints | Precisar do endpoint exato, método ou payload da Management API | `references/1-referencia-endpoints.md` |
+| Código de Consumer/Producer | A tarefa pedir código de consumer ou producer (Node.js com amqplib ou Python com pika) | `references/2-codigo-consumer-producer.md` |
+| Arquiteturas Comuns (DLX, retry, fanout, topic) | A tarefa pedir Dead Letter Exchange, retry com delay, fanout ou topic routing | `references/3-arquiteturas-comuns.md` |
+| Troubleshooting do RabbitMQ | Houver fila acumulando, mensagens indo para dead letter, loop de consumer, erro 406 ou mensagens que não chegam | `references/4-troubleshooting.md` |
+
 ## Regras
 
 ### Nunca
@@ -326,281 +318,6 @@ curl -s -X DELETE -u "$AUTH" \
 
 ---
 
-## Criar Código de Consumer/Producer
-
-Quando o usuário pedir para criar código, gerar implementação completa e funcional. Verificar a linguagem/framework do projeto antes de escolher a biblioteca.
-
-### Node.js com amqplib
-
-```javascript
-// consumer.js
-const amqp = require('amqplib');
-
-async function startConsumer() {
-  const conn = await amqp.connect(process.env.RABBITMQ_URL);
-  const channel = await conn.createChannel();
-
-  const queue = 'nome-da-fila';
-  await channel.assertQueue(queue, { durable: true });
-  channel.prefetch(1); // processa 1 mensagem por vez
-
-  console.log(`Aguardando mensagens em ${queue}`);
-
-  channel.consume(queue, async (msg) => {
-    if (!msg) return;
-    try {
-      const payload = JSON.parse(msg.content.toString());
-      console.log('Mensagem recebida:', payload);
-
-      // processar aqui...
-
-      channel.ack(msg); // confirmar processamento
-    } catch (err) {
-      console.error('Erro ao processar:', err);
-      channel.nack(msg, false, false); // rejeitar sem requeue → vai para DLX
-    }
-  });
-}
-
-startConsumer().catch(console.error);
-```
-
-```javascript
-// producer.js
-const amqp = require('amqplib');
-
-async function publish(exchange, routingKey, payload) {
-  const conn = await amqp.connect(process.env.RABBITMQ_URL);
-  const channel = await conn.createChannel();
-
-  channel.publish(
-    exchange,
-    routingKey,
-    Buffer.from(JSON.stringify(payload)),
-    { persistent: true, contentType: 'application/json' }
-  );
-
-  await channel.close();
-  await conn.close();
-}
-```
-
-### Python com pika
-
-```python
-# consumer.py
-import pika, json, os
-
-def on_message(channel, method, properties, body):
-    try:
-        payload = json.loads(body)
-        print(f"Mensagem recebida: {payload}")
-        # processar aqui...
-        channel.basic_ack(delivery_tag=method.delivery_tag)
-    except Exception as e:
-        print(f"Erro: {e}")
-        channel.basic_nack(delivery_tag=method.delivery_tag, requeue=False)
-
-params = pika.URLParameters(os.environ['RABBITMQ_URL'])
-conn = pika.BlockingConnection(params)
-ch = conn.channel()
-ch.basic_qos(prefetch_count=1)
-ch.basic_consume('nome-da-fila', on_message)
-ch.start_consuming()
-```
-
-> Sempre ler o projeto para detectar a linguagem e adaptar o código antes de gerar.
-
----
-
-## Arquiteturas Comuns
-
-### Dead Letter Exchange (DLX) — Fila com rejeição controlada
-
-```
-Fila principal → (nack/expired) → DLX Exchange → Fila de Dead Letters
-```
-
-```bash
-# 1. Criar DLX exchange
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"type":"direct","durable":true}' \
-  "$MB_URL/exchanges/%2F/dlx.minha-fila"
-
-# 2. Criar fila de dead letters
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"durable":true}' \
-  "$MB_URL/queues/%2F/minha-fila.dead"
-
-# 3. Criar binding DLX → fila dead
-curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"routing_key":"minha-fila"}' \
-  "$MB_URL/bindings/%2F/e/dlx.minha-fila/q/minha-fila.dead"
-
-# 4. Criar fila principal apontando para DLX
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{
-    "durable": true,
-    "arguments": {
-      "x-dead-letter-exchange": "dlx.minha-fila",
-      "x-dead-letter-routing-key": "minha-fila",
-      "x-message-ttl": 86400000
-    }
-  }' \
-  "$MB_URL/queues/%2F/minha-fila"
-```
-
-### Retry com Delay (usando TTL + DLX como fila de espera)
-
-```
-Fila principal → (nack) → DLX Exchange → Fila retry (TTL 30s) → republica → Fila principal
-```
-
-```bash
-# Fila de retry com TTL de 30 segundos e DLX apontando de volta para a fila principal
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{
-    "durable": true,
-    "arguments": {
-      "x-message-ttl": 30000,
-      "x-dead-letter-exchange": "",
-      "x-dead-letter-routing-key": "minha-fila"
-    }
-  }' \
-  "$MB_URL/queues/%2F/minha-fila.retry"
-```
-
-### Fanout — Broadcast para múltiplas filas
-
-```
-Exchange fanout → Fila A
-               → Fila B
-               → Fila C
-```
-
-```bash
-# Exchange fanout (routing_key é ignorada)
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"type":"fanout","durable":true}' \
-  "$MB_URL/exchanges/%2F/events.broadcast"
-
-# Cada fila se liga sem routing_key
-curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"routing_key":""}' \
-  "$MB_URL/bindings/%2F/e/events.broadcast/q/servico-a"
-```
-
-### Topic Routing — Roteamento por padrão
-
-```
-Exchange topic → "pedido.criado"    → fila pedidos
-              → "pedido.*"         → fila auditoria
-              → "*.erro"           → fila alertas
-```
-
-```bash
-curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"type":"topic","durable":true}' \
-  "$MB_URL/exchanges/%2F/events.topic"
-
-# Binding com wildcard
-curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
-  -d '{"routing_key":"pedido.*"}' \
-  "$MB_URL/bindings/%2F/e/events.topic/q/fila-auditoria"
-```
-
----
-
-## Troubleshooting
-
-### Diagnóstico inicial — sempre começar aqui
-
-```bash
-AUTH=$(grep "MESSAGE_BROKER_API_AUTH" $IDE/ENV.md | cut -d'=' -f2)
-MB_URL=$(grep "MESSAGE_BROKER_URL_API" $IDE/ENV.md | cut -d'=' -f2)
-
-# Visão geral do cluster
-curl -s -u "$AUTH" "$MB_URL/overview" | python3 -m json.tool
-
-# Filas com problemas (messages_ready > 0 e consumers = 0)
-curl -s -u "$AUTH" "$MB_URL/queues" | python3 -c "
-import json,sys
-qs = json.load(sys.stdin)
-for q in qs:
-    ready = q.get('messages_ready', 0)
-    consumers = q.get('consumers', 0)
-    if ready > 0 and consumers == 0:
-        print(f\"ALERTA: {q['name']} | mensagens={ready} | consumers=0\")
-"
-```
-
-### Problema: Fila acumulando mensagens (consumer parado)
-
-1. Verificar se há consumers ativos na fila:
-```bash
-curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -m json.tool | grep -E "consumers|messages"
-```
-2. Verificar connections abertas:
-```bash
-curl -s -u "$AUTH" "$MB_URL/connections" | python3 -m json.tool
-```
-3. Checar se o consumer está com unacked alto (travado no processamento):
-```bash
-curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -c "
-import json,sys; q=json.load(sys.stdin)
-print('messages_ready:', q.get('messages_ready'))
-print('messages_unacknowledged:', q.get('messages_unacknowledged'))
-print('consumers:', q.get('consumers'))
-"
-```
-
-### Problema: Mensagens indo para Dead Letter inesperadamente
-
-Causas comuns:
-- `x-message-ttl` expirando antes do consumer processar → aumentar TTL ou aumentar prefetch
-- Consumer fazendo `nack` com `requeue=false` por erro no código → checar logs do consumer
-- Fila com `x-max-length` atingido → verificar se fila está lotada
-
-```bash
-# Ver argumentos da fila (TTL, DLX, max-length)
-curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -c "
-import json,sys; q=json.load(sys.stdin)
-print(json.dumps(q.get('arguments', {}), indent=2))
-"
-```
-
-### Problema: Consumer recebe mensagem mas não processa (loop infinito)
-
-Sintoma: `messages_unacknowledged` cresce, `messages_ready` não zera.
-
-Solução: Verificar prefetch — consumer pode estar segurando todas as mensagens:
-```bash
-# Ver detalhes dos channels (prefetch_count)
-curl -s -u "$AUTH" "$MB_URL/channels" | python3 -m json.tool
-```
-
-### Problema: 406 PRECONDITION_FAILED ao criar fila/exchange
-
-A fila/exchange já existe com parâmetros diferentes. Verificar parâmetros atuais:
-```bash
-curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -m json.tool
-```
-Se precisar mudar: deletar e recriar (confirmar com o usuário antes).
-
-### Problema: Mensagens publicadas mas não chegam na fila
-
-Verificar se o binding existe com a routing_key correta:
-```bash
-curl -s -u "$AUTH" "$MB_URL/bindings/%2F" | python3 -c "
-import json,sys
-for b in json.load(sys.stdin):
-    if b.get('source') == 'nome-exchange':
-        print(b)
-"
-```
-
----
-
 ## Tratamento de Erros
 
 ### 401 Unauthorized

package/skills/eng-backend-rabbitmq/references/1-referencia-endpoints.md

@@ -0,0 +1,28 @@
+# Referência de Endpoints
+
+> Parte do skill `eng-backend-rabbitmq`. Leia este arquivo quando precisar do endpoint exato, método ou payload da Management API.
+
+## Referência de Endpoints
+
+| Operação | Método | Endpoint |
+|----------|--------|----------|
+| Status geral | GET | `/api/overview` |
+| Listar filas | GET | `/api/queues` |
+| Detalhes de fila | GET | `/api/queues/{vhost}/{name}` |
+| Criar fila | PUT | `/api/queues/{vhost}/{name}` |
+| Deletar fila | DELETE | `/api/queues/{vhost}/{name}` |
+| Purgar fila | DELETE | `/api/queues/{vhost}/{name}/contents` |
+| Consumir mensagens | POST | `/api/queues/{vhost}/{name}/get` |
+| Listar exchanges | GET | `/api/exchanges/{vhost}` |
+| Criar exchange | PUT | `/api/exchanges/{vhost}/{name}` |
+| Deletar exchange | DELETE | `/api/exchanges/{vhost}/{name}` |
+| Publicar mensagem | POST | `/api/exchanges/{vhost}/{name}/publish` |
+| Listar bindings | GET | `/api/bindings/{vhost}` |
+| Criar binding (fila) | POST | `/api/bindings/{vhost}/e/{exchange}/q/{queue}` |
+| Deletar binding | DELETE | `/api/bindings/{vhost}/e/{exchange}/q/{queue}/{props}` |
+| Listar connections | GET | `/api/connections` |
+| Fechar connection | DELETE | `/api/connections/{name}` |
+| Listar channels | GET | `/api/channels` |
+| Listar vhosts | GET | `/api/vhosts` |
+
+---

package/skills/eng-backend-rabbitmq/references/2-codigo-consumer-producer.md

@@ -0,0 +1,90 @@
+# Código de Consumer/Producer
+
+> Parte do skill `eng-backend-rabbitmq`. Leia este arquivo quando a tarefa pedir código de consumer ou producer (Node.js com amqplib ou Python com pika).
+
+## Criar Código de Consumer/Producer
+
+Quando o usuário pedir para criar código, gerar implementação completa e funcional. Verificar a linguagem/framework do projeto antes de escolher a biblioteca.
+
+### Node.js com amqplib
+
+```javascript
+// consumer.js
+const amqp = require('amqplib');
+
+async function startConsumer() {
+  const conn = await amqp.connect(process.env.RABBITMQ_URL);
+  const channel = await conn.createChannel();
+
+  const queue = 'nome-da-fila';
+  await channel.assertQueue(queue, { durable: true });
+  channel.prefetch(1); // processa 1 mensagem por vez
+
+  console.log(`Aguardando mensagens em ${queue}`);
+
+  channel.consume(queue, async (msg) => {
+    if (!msg) return;
+    try {
+      const payload = JSON.parse(msg.content.toString());
+      console.log('Mensagem recebida:', payload);
+
+      // processar aqui...
+
+      channel.ack(msg); // confirmar processamento
+    } catch (err) {
+      console.error('Erro ao processar:', err);
+      channel.nack(msg, false, false); // rejeitar sem requeue → vai para DLX
+    }
+  });
+}
+
+startConsumer().catch(console.error);
+```
+
+```javascript
+// producer.js
+const amqp = require('amqplib');
+
+async function publish(exchange, routingKey, payload) {
+  const conn = await amqp.connect(process.env.RABBITMQ_URL);
+  const channel = await conn.createChannel();
+
+  channel.publish(
+    exchange,
+    routingKey,
+    Buffer.from(JSON.stringify(payload)),
+    { persistent: true, contentType: 'application/json' }
+  );
+
+  await channel.close();
+  await conn.close();
+}
+```
+
+### Python com pika
+
+```python
+# consumer.py
+import pika, json, os
+
+def on_message(channel, method, properties, body):
+    try:
+        payload = json.loads(body)
+        print(f"Mensagem recebida: {payload}")
+        # processar aqui...
+        channel.basic_ack(delivery_tag=method.delivery_tag)
+    except Exception as e:
+        print(f"Erro: {e}")
+        channel.basic_nack(delivery_tag=method.delivery_tag, requeue=False)
+
+params = pika.URLParameters(os.environ['RABBITMQ_URL'])
+conn = pika.BlockingConnection(params)
+ch = conn.channel()
+ch.basic_qos(prefetch_count=1)
+ch.basic_consume('nome-da-fila', on_message)
+ch.start_consuming()
+```
+
+> Sempre ler o projeto para detectar a linguagem e adaptar o código antes de gerar.
+
+---

package/skills/eng-backend-rabbitmq/references/3-arquiteturas-comuns.md

@@ -0,0 +1,101 @@
+# Arquiteturas Comuns (DLX, retry, fanout, topic)
+
+> Parte do skill `eng-backend-rabbitmq`. Leia este arquivo quando a tarefa pedir Dead Letter Exchange, retry com delay, fanout ou topic routing.
+
+## Arquiteturas Comuns
+
+### Dead Letter Exchange (DLX) — Fila com rejeição controlada
+
+```
+Fila principal → (nack/expired) → DLX Exchange → Fila de Dead Letters
+```
+
+```bash
+# 1. Criar DLX exchange
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"type":"direct","durable":true}' \
+  "$MB_URL/exchanges/%2F/dlx.minha-fila"
+
+# 2. Criar fila de dead letters
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"durable":true}' \
+  "$MB_URL/queues/%2F/minha-fila.dead"
+
+# 3. Criar binding DLX → fila dead
+curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"routing_key":"minha-fila"}' \
+  "$MB_URL/bindings/%2F/e/dlx.minha-fila/q/minha-fila.dead"
+
+# 4. Criar fila principal apontando para DLX
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{
+    "durable": true,
+    "arguments": {
+      "x-dead-letter-exchange": "dlx.minha-fila",
+      "x-dead-letter-routing-key": "minha-fila",
+      "x-message-ttl": 86400000
+    }
+  }' \
+  "$MB_URL/queues/%2F/minha-fila"
+```
+
+### Retry com Delay (usando TTL + DLX como fila de espera)
+
+```
+Fila principal → (nack) → DLX Exchange → Fila retry (TTL 30s) → republica → Fila principal
+```
+
+```bash
+# Fila de retry com TTL de 30 segundos e DLX apontando de volta para a fila principal
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{
+    "durable": true,
+    "arguments": {
+      "x-message-ttl": 30000,
+      "x-dead-letter-exchange": "",
+      "x-dead-letter-routing-key": "minha-fila"
+    }
+  }' \
+  "$MB_URL/queues/%2F/minha-fila.retry"
+```
+
+### Fanout — Broadcast para múltiplas filas
+
+```
+Exchange fanout → Fila A
+               → Fila B
+               → Fila C
+```
+
+```bash
+# Exchange fanout (routing_key é ignorada)
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"type":"fanout","durable":true}' \
+  "$MB_URL/exchanges/%2F/events.broadcast"
+
+# Cada fila se liga sem routing_key
+curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"routing_key":""}' \
+  "$MB_URL/bindings/%2F/e/events.broadcast/q/servico-a"
+```
+
+### Topic Routing — Roteamento por padrão
+
+```
+Exchange topic → "pedido.criado"    → fila pedidos
+              → "pedido.*"         → fila auditoria
+              → "*.erro"           → fila alertas
+```
+
+```bash
+curl -s -X PUT -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"type":"topic","durable":true}' \
+  "$MB_URL/exchanges/%2F/events.topic"
+
+# Binding com wildcard
+curl -s -X POST -u "$AUTH" -H "Content-Type: application/json" \
+  -d '{"routing_key":"pedido.*"}' \
+  "$MB_URL/bindings/%2F/e/events.topic/q/fila-auditoria"
+```
+
+---

package/skills/eng-backend-rabbitmq/references/4-troubleshooting.md

@@ -0,0 +1,93 @@
+# Troubleshooting do RabbitMQ
+
+> Parte do skill `eng-backend-rabbitmq`. Leia este arquivo quando houver fila acumulando, mensagens indo para dead letter, loop de consumer, erro 406 ou mensagens que não chegam.
+
+## Troubleshooting
+
+### Diagnóstico inicial — sempre começar aqui
+
+```bash
+AUTH=$(grep "MESSAGE_BROKER_API_AUTH" $IDE/ENV.md | cut -d'=' -f2)
+MB_URL=$(grep "MESSAGE_BROKER_URL_API" $IDE/ENV.md | cut -d'=' -f2)
+
+# Visão geral do cluster
+curl -s -u "$AUTH" "$MB_URL/overview" | python3 -m json.tool
+
+# Filas com problemas (messages_ready > 0 e consumers = 0)
+curl -s -u "$AUTH" "$MB_URL/queues" | python3 -c "
+import json,sys
+qs = json.load(sys.stdin)
+for q in qs:
+    ready = q.get('messages_ready', 0)
+    consumers = q.get('consumers', 0)
+    if ready > 0 and consumers == 0:
+        print(f\"ALERTA: {q['name']} | mensagens={ready} | consumers=0\")
+"
+```
+
+### Problema: Fila acumulando mensagens (consumer parado)
+
+1. Verificar se há consumers ativos na fila:
+```bash
+curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -m json.tool | grep -E "consumers|messages"
+```
+2. Verificar connections abertas:
+```bash
+curl -s -u "$AUTH" "$MB_URL/connections" | python3 -m json.tool
+```
+3. Checar se o consumer está com unacked alto (travado no processamento):
+```bash
+curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -c "
+import json,sys; q=json.load(sys.stdin)
+print('messages_ready:', q.get('messages_ready'))
+print('messages_unacknowledged:', q.get('messages_unacknowledged'))
+print('consumers:', q.get('consumers'))
+"
+```
+
+### Problema: Mensagens indo para Dead Letter inesperadamente
+
+Causas comuns:
+- `x-message-ttl` expirando antes do consumer processar → aumentar TTL ou aumentar prefetch
+- Consumer fazendo `nack` com `requeue=false` por erro no código → checar logs do consumer
+- Fila com `x-max-length` atingido → verificar se fila está lotada
+
+```bash
+# Ver argumentos da fila (TTL, DLX, max-length)
+curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -c "
+import json,sys; q=json.load(sys.stdin)
+print(json.dumps(q.get('arguments', {}), indent=2))
+"
+```
+
+### Problema: Consumer recebe mensagem mas não processa (loop infinito)
+
+Sintoma: `messages_unacknowledged` cresce, `messages_ready` não zera.
+
+Solução: Verificar prefetch — consumer pode estar segurando todas as mensagens:
+```bash
+# Ver detalhes dos channels (prefetch_count)
+curl -s -u "$AUTH" "$MB_URL/channels" | python3 -m json.tool
+```
+
+### Problema: 406 PRECONDITION_FAILED ao criar fila/exchange
+
+A fila/exchange já existe com parâmetros diferentes. Verificar parâmetros atuais:
+```bash
+curl -s -u "$AUTH" "$MB_URL/queues/%2F/nome-da-fila" | python3 -m json.tool
+```
+Se precisar mudar: deletar e recriar (confirmar com o usuário antes).
+
+### Problema: Mensagens publicadas mas não chegam na fila
+
+Verificar se o binding existe com a routing_key correta:
+```bash
+curl -s -u "$AUTH" "$MB_URL/bindings/%2F" | python3 -c "
+import json,sys
+for b in json.load(sys.stdin):
+    if b.get('source') == 'nome-exchange':
+        print(b)
+"
+```
+
+---

package/skills/eng-data-bi/SKILL.md

@@ -150,6 +150,12 @@ Se existir `$IDE/rules/engineering/data/data-rules.md`, ler e aplicar as conven
 3. **Registrar o compartilhamento**
    - Anotar no contrato de dados quem está consumindo
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
 ---
 
 ## Boas Práticas de Performance

package/skills/eng-data-debug/SKILL.md

@@ -288,6 +288,12 @@ Após a correção:
 | Métrica errada | Gold | Join ou regra de negócio |
 | Dashboard não atualiza | Gold / Cache | Data da última ingestão em gold |
 
+### Skills invocados durante a execução do skill
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — skill autocontida | — |
+
 ---
 
 ## Regras Críticas