Erros comuns

Sincronização e tarefas

Sintoma	Causa	Solução
A tarefa não apareceu no console	sem bloco task:, sem activity:, ou a sincronização ainda não rodou	Complete o frontmatter e use Sincronizar; leia "Tarefas puladas"
Atividade duplicada, tarefa na nova	nome de activity: diferente do existente	Corrija o frontmatter para o nome existente e peça a remoção da duplicada
Mudei workspace: e a tarefa não mudou de workspace	o workspace é o do plugin; workspace: só batiza na criação	Para mudar de workspace, a skill tem que ir para outro plugin (e vira outra tarefa)
Mudei model: e o nível não mudou	o valor não é slug de nível ativo	Use tier-N; o aviso aparece no resultado da sincronização
O nível mudou, mas o modelo de IA não	a tarefa tem override de executor e modelo	Declare executor: inherit, ou peça para voltar a "Herdar do Tier"
Removi um campo do frontmatter e a tarefa manteve o valor	campo ausente = "não mexa"	Declare vazio ([], null, "")
Editei a tarefa no console e a edição sumiu	o campo está declarado no frontmatter	Faça a mudança no frontmatter
Tarefa apagada não reaparece	a sincronização trata a apagada como existente	Peça à Kobana para restaurar
Duas tarefas para a mesma skill, uma sem execuções	a pasta da skill foi renomeada	Volte o nome da pasta, ou aposente a antiga e reconfigure a nova
Mudei o frontmatter e o console não mudou	a sincronização não rodou, ou o campo foi descartado por tipo errado	Sincronizar e confira "Tarefas atualizadas" e os avisos
Flag do task: ignorada	tipo errado no YAML ("true" em vez de true)	Corrija o tipo

Agendamentos e ambientes

Sintoma	Causa	Solução
Aviso schedules ignorado (item N …)	item malformado (sem cron, paused com aspas, ambiente repetido)	Corrija o item; os agendamentos não mudam até lá
Aviso agendamentos não aplicados (ambiente "…" não existe)	nome do ambiente diferente, ou ambiente ainda não criado	Copie o nome do console, ou declare o ambiente no kadu.yaml
Agendamento criado no console não sumiu com schedules: []	a sincronização só apaga o que ela criou	Apague no console
Agendamento roda no horário errado	timezone ausente = UTC	Declare timezone: America/Sao_Paulo
Pausei no console e a sincronização retomou	o item declara paused: false	Tire o paused do item, ou declare true
Aviso kadu.yaml: … — nada aplicado	YAML quebrado, cor fora de #rrggbb, chave errada, nome repetido	Corrija o arquivo; nada muda até lá
Ambiente saiu do kadu.yaml e continua no console	ainda tem secret ou agendamento, ou foi criado no console	Remova os secrets e agendamentos, ou apague no console
Aviso secret X declarado no kadu.yaml sem valor no cofre	chave esperada não cadastrada no ambiente	Cadastre o valor em Configurações → Secrets
Aviso executor claude_code não roda o modelo …	modelo de outro provedor com cli: claude_code	Use claude-* ou um apelido; para outro provedor, cli: goose

Endpoint e webhooks

Sintoma	Causa	Solução
Aviso de endpoint sem credencial	o repositório nunca carrega credencial	Peça o cadastro da credencial; a próxima sincronização liga
Endpoint desligado no console voltou a ligar	o frontmatter declara enabled: true	Declare enabled: false
Aviso Webhook "X" criado sem credencial…	o repositório nunca carrega credencial	Cadastre a credencial no console e gere o signing secret
O receptor recusa a assinatura do webhook	o signing secret foi gerado pela sincronização, e ninguém o viu	POST /v1/webhooks/{id}/rotate-secret e configure o novo valor no receptor
Aviso auth "…" não trocado	auth: diferente do webhook existente	Troque o tipo no console (a credencial muda junto)
Webhook desativado volta a ficar ativo a cada push	enabled: true declarado	Tire o enabled para deixar a desativação por falhas valer
Aviso URL recusada	IP privado, loopback ou http	Use uma URL https pública

Execução

Sintoma	Causa	Solução
Execução termina com execution.body_skipped	o corpo não chamou mark_body_started	Marque a sentinela no começo
Um passo sumiu do histórico	evento sem message, recusado em silêncio	Sempre type e message
Execução roda até 60 minutos e falha	a skill perguntou algo	Nenhuma pergunta: decida e registre pendência
Aba Resultado mostra "success"	result usado como status	result é Markdown; contadores vão em summary
Aba Logs esvaziou no fim	os logs foram reenviados na finalização	Não reenvie logs; o wrapper finaliza
Skill roda com a variável vazia	secret na lista de permissão, mas sem valor no ambiente	Cadastre o valor; confira a ordem dos dois passos
Parâmetro ignorado	schema sem additionalProperties: false	Feche o schema
Histórico vazio entre a abertura e o fim	a tarefa orquestra auxiliares que não se instrumentam	Instrumente as auxiliares (O corpo da tarefa)
Aba Logs ilegível, milhares de linhas	log_http_call em cada requisição de uma ferramenta	Resuma o tráfego em append_log
Configuração não muda por organização, mesmo com valor no cofre	variável lida com padrão no corpo e fora de required_secrets	Inclua a variável em required_secrets
422 missing_secrets no endpoint	secret da lista sem valor no ambiente da chamada	Cadastre o valor no ambiente informado em environment_id
Unknown skill no Claude Code	skill criada depois do início da sessão	Reinicie a sessão