Um resumo pessoal de notícias com IA precisa de mais do que uma instrução para resumir links. Ele precisa recolhar de fontes que o leitor pode acessar, reconhecer itens já vistos, separar critérios factuais de julgamentos e manter um registo guardado, com links, do que enviou. A competência build-signal-engine de Cole Medin instrui um agente de programação a construir esse sistema no seu repositório. A competência é um procedimento de construção; o código gerado e seu comportamento dependem das suas respostas, fontes, serviços e testes.

Este guia é para quem já usa Claude Code, controla uma pasta de projeto e pode decidir quais feeds ou APIs tem permissão para usar. Vai precisar de acesso às fontes e credenciais dos serviços pagos de dados ou modelos que escolher. Os ficheiros da competência estão sob a licença MIT do repositório; uso do agente, recolha de fontes e chamadas a modelos ainda podem custar dinheiro. A BIG CHANGE inspecionou a competência no commit 847be0848ae7b997ae4420bc0eac267177a066a2 e a documentação dos fornecedores. Não instalamos a competência, construímos um mecanismo nem executamos um resumo.

1. Adicione ao projeto a versão fixada da competência

Em uma pasta de trabalho separada, clone o repositório de competências de Cole Medin e selecione o commit fixado:

Terminal
git clone https://github.com/coleam00/skills.git skills-source
git -C skills-source checkout --detach 847be0848ae7b997ae4420bc0eac267177a066a2

Copie o diretório completo skills-source/.claude/skills/build-signal-engine/ para <your-project>/.claude/skills/build-signal-engine/. Mantenha references/ e templates/ ao lado de SKILL.md: as instruções usam caminhos relativos para esses ficheiros. Inclua a MIT LICENSE e o aviso de direitos autorais do repositório na cópia. A instalação local ao projeto evita trazer outras competências e vincula o guia a uma versão que pode ser revisada.

Abra o repositório no Claude Code e inicie uma nova sessão para ele descobrir a competência do projeto. Verifique se build-signal-engine aparece entre as competências disponíveis e invoque /build-signal-engine com o caminho do repositório onde o mecanismo será construído. A documentação de competências do Claude Code descreve a descoberta de .claude/skills/<name>/SKILL.md e a chamada /skill-name. Se a descoberta falhar, confira a grafia do diretório e se SKILL.md está diretamente dentro dele antes de mudar fontes ou fornecedores. Inspecione a competência e seus ficheiros auxiliares antes de permitir gravação ou execução de código.

2. Aprove um perfil feito com seus próprios exemplos

A competência começa com uma entrevista. Diga ao agente que informação mudaria uma decisão sua, onde apareceu primeiro um item que o leitor realmente perdeu e onde leria o resumo. Forneça itens reais que queria ver e outros que descartaria, com links quando possível. Escolha fontes permitidas, critérios factuais como idade ou interação, tamanho do resumo e destino. O agente deve transformar as respostas em PROFILE.md usando templates/PROFILE.md e mostrá-lo para aprovação antes de construir.

Leia a lista de fontes e as perguntas de decisão. Uma pergunta sobre se um item relata uma novidade concreta precisa ter significado específico para seu trabalho. Os exemplos de inclusão e descarte formarão depois um pequeno conjunto de testes. Se o leitor só usa alguns feeds simples, veja se um leitor de feeds ou alertas já resolve a tarefa; um mecanismo adiciona componentes e chamadas recorrentes a serviços.

Mantenha as credenciais fora do perfil, prompts, ficheiros enviados ao repositório e registos. A competência pede um ficheiro de ambiente ignorado pelo Git e carregado pelo programa gerado. Ainda assim, o leitor precisa verificar os campos enviados a cada fornecedor, inclusive se seus interesses ou textos das fontes contêm informações sensíveis.

3. Construa uma fonte permitida e confira o armazenamento

Peça ao agente que implemente uma fonte de início ao fim antes de acrescentar outras. Para cada uma, defina um acesso permitido: feed ou API oficial, fornecedor escolhido ou outro método autorizado pelos termos. Fontes sem acesso automatizado permitido ficam de fora. references/sources.md documenta tipos e falhas de fontes; não concede direitos de acesso.

Cada item recolhido deve corresponder aos campos de templates/item_schema.md: id estável, fonte, título, URL, conteúdo, horário de publicação, interação disponível e metadados. O armazenamento também registra o que filtrou o item, o resultado da decisão e se ele apareceu em um resumo. Históricos de alterações precisam de entradas individuais datadas e IDs estáveis, em vez de tratar uma página em mudança como um único item. A competência sugere SQLite, guardado se o leitor já usa outro armazenamento.

Inspecione uma resposta real da fonte e as linhas guardadas. Na segunda recolha, confirme que IDs e URLs apontam para os mesmos itens; registre por fonte quantos foram retornados, guardados como novos e identificados como duplicados. Investigue respostas vazias inesperadas, datas ausentes, erros de interpretação ou uma segunda execução que recrie as mesmas entradas. A deduplicação evita armazenamento ou decisões posteriores repetidas para o mesmo ID; não elimina o custo de buscar novamente uma fonte paga.

4. Separe filtros factuais de decisões

Faça o código gerado aplicar regras explícitas de idade, interação numérico, idioma, tamanho e itens já vistos. Leia as quantidades descartadas por regra e examine uma amostra. Se a fonte já cobrou por uma linha, um filtro posterior não devolve o dinheiro. Limite as linhas faturáveis por execução e registre separadamente tarifas das fontes, modelo de decisão e modelo de leitura.

Para os itens restantes, a competência propõe uma solicitação de decisão tipada por item, reunindo as perguntas do perfil: relevância e se há algo novo e concreto. A referência cita Jev da TypeSafe via OpenRouter como opção; um modelo de saída estruturada é outra. A referência fixada nomeia typesafe/jev-1.13. O guia de Jev da OpenRouter de outubro de 2026 descreve 1.14 e diz que 1.13 continua disponível. Mantenha a versão fixada, a menos que revise e teste deliberadamente uma mudança. O endpoint de decisão do Jev é diferente de uma chamada de conclusão de chat. A cobertura anterior da BIG CHANGE sobre Jev explica seu papel mais amplo nas decisões de software.

Guarde um motivo para descartes claros por fatos ou baixa relevância. Envie inclusões claras e itens incertos à etapa de leitura. Uma decisão que falhou ou está malformada não tem veredito: marque para inspeção ou recuperação controlada e nunca descarte silenciosamente. O recurso à leitura também precisa de limite de custo. Se chamadas malsucedidas ou um lote grande demais excederiam o orçamento de leitura aprovado, mantenha os itens visivelmente pendentes para o leitor em vez de gastar sem limite. São verificações a exigir do mecanismo gerado, não comportamentos comprovados pela BIG CHANGE.

Avalie seus exemplos de inclusão e descarte e uma amostra etiquetada dos itens recolhidos. Revise cada item desejado que o sistema descartou e ajuste uma pergunta confusa ou escolha de fonte antes de mudar um limite. Uma probabilidade tipada pode estar errada para seu material. Preferências ou interação podem ajudar a ordenar; nenhum deles comprova importância factual.

5. Guarde o resumo com links antes de enviá-lo

O modelo de leitura deve receber os itens restantes com links para as fontes, agrupar relatos relacionados e escrever no formato aprovado. Verifique se cada entrada mantém uma URL funcional e distingue corretamente uma alteração menor, um lançamento e uma afirmação não confirmada. Leia o resumo junto das fontes; uma frase bem escrita não comprova que uma mudança aconteceu.

A competência exige guardar o ficheiro datado digests/YYYY-MM-DD.md antes do envio por e-mail, chat ou notas. Confirme que existe e abre mesmo se a entrega falhar. O ficheiro e os registos permitem rastrear por que uma notícia entrou. Verifique se a etapa de envio gerada consegue tentar novamente a partir desse ficheiro sem buscar as fontes nem pagar toda a execução outra vez.

6. Autorize e observe a execução recorrente

Antes de registar qualquer automação, peça ao agente a invocação e o procedimento de parada do mecanismo realmente gerado, o agendador para seu sistema, fuso horário local, destino, credenciais usadas, limite de linhas faturáveis, registo de execução e proteção contra duplicação. Revise o comando exato que será executado. A competência cita cron, launchd e Windows Task Scheduler, mas não fornece um comando universal do mecanismo. Autorize aquele agendamento diário específico somente após uma execução manual produzir um ficheiro com links que o leitor aceite.

Observe uma execução agendada real. Compare contagens por fonte, motivos de filtro, rotas de decisão, cobranças de tokens e serviços, caminho de saída e resultado de entrega com a execução manual. Verifique se uma segunda invocação ou uma sobreposta não duplica efeitos. Se falhar, localize a etapa no registo, preserve o resumo guardado se houver, repare o problema de fonte, decisão ou envio e repita somente o necessário sob o mesmo limite aprovado. Confira também o comando para desativar o agendador, para conseguir interromper buscas e cobranças recorrentes.

Durante uma semana, leia a saída junto das fontes importantes para o leitor. Marque omissões e ruído. Para cada omissão, identifique se o item não foi recolhido, caiu em um filtro factual, foi descartado por decisão ou omitido na leitura. Altere essa etapa e repita a verificação. Essa semana de observação fornece evidências sobre suas fontes e perguntas, mas não certifica precisão sem supervisão.

A grande mudança

A parte reutilizável da competência é separar recolha, armazenamento estável, filtros factuais, julgamentos tipados e leitura com links. Um agente pode montar essas partes em torno de um perfil aprovado pelo leitor. O leitor continua responsável por permissões, exemplos, limites de gastos e início ou interrupção do envio diário. Até o sistema passar, no seu ambiente, pelas verificações de fontes, duplicatas, omissões e execução agendada, ele segue em construção.

Fontes e leituras complementares