Skills e Agentes no VS Code

1 · Como ler este material

O encontro ocupa a manhã inteira, das nove à uma, em quatro blocos precedidos pelo welcome coffee. Cada bloco constrói uma etapa de um mesmo fluxo de trabalho e reserva os minutos finais para que o participante a reproduza no repositório do próprio projeto. Este material registra o que foi exposto e acrescenta o detalhamento que não cabe em tela de projeção: os caminhos exatos dos arquivos, os exemplos completos, os roteiros de aplicação e os critérios de verificação de cada etapa.

Os roteiros das quatro aplicações estão nas seções 4.6, 5.6, 6.6 e 7.6. Percorridos os quatro, o participante terá, no próprio computador, um repositório com instruções, duas skills e um agente declarados, um script de extração versionado, um relatório com origem citada e uma apresentação gerada a partir dele.

2 · Os projetos desta turma

Treze participantes responderam ao diagnóstico prévio entre 20 e 25 de agosto de 2026, um por projeto em curso. Sete projetos tratam de Operações Hospitalares, cinco de Recebíveis e um abrange os dois temas. Dez estão em implementação, em piloto ou em acompanhamento posterior à implantação, e a autoavaliação de andamento tem média de 3,9 em escala de cinco pontos.

Quanto ao uso de inteligência artificial no projeto, sete declaram uso eventual, cinco declaram uso frequente e um ainda não utiliza. Sete classificam a oportunidade de aplicação como alta, com caso de uso já definido, e seis como média, ainda a explorar. Nenhum projeto está na partida: a decisão em pauta é onde inserir um agente em fluxo que já opera.

As dificuldades apontadas — até três por participante — concentram-se em cinco categorias, e cada uma corresponde a uma decisão de desenho tratada neste material:

Dificuldade declarada	Menções	Onde é tratada
Qualidade e estrutura dos dados	8 de 13	Seções 7.1 e 7.2 — o que o dado precisa ter para servir de evidência citável.
Dependência de tecnologia e sistemas	6 de 13	Seções 6.1 e 6.5 — roteamento que encerra o caso quando a evidência não está acessível, e política de retomada.
Dependência de outras áreas	6 de 13	Seções 5.2, 5.3 e 5.5 — contrato de mensagem, critério de aceite do handoff e o que atravessa a fronteira.
Complexidade do processo	5 de 13	Seções 4.1 a 4.5 — decomposição, escolha de topologia, divisão modular e exemplo trabalhado.
Engajamento das pessoas envolvidas	4 de 13	Seções 5.4 e 6.2 — parcial declarado e decisão que permanece com a pessoa responsável.

Entre as razões pelas quais uma ideia de aplicação de IA não chegou a ser implementada, sete respostas citam falta de conhecimento técnico e três citam não saber como estruturar a solução. São as duas a que este material se dirige.

3 · O limite do trabalho com planilha

O trabalho de análise nas duas áreas representadas nesta turma segue hoje um percurso conhecido: a planilha é aberta, filtrada e copiada para uma segunda aba; os cálculos ficam em fórmulas dentro das células; o achado é escrito no corpo de um e-mail; e a apresentação é montada na véspera da reunião, com os números digitados à mão.

O percurso funciona. O que ele não produz é registro. O critério aplicado ao filtro não fica escrito em lugar algum, repetir a competência seguinte exige refazer as mesmas decisões de memória, e quem recebe a apresentação não consegue percorrer o caminho inverso, do número apresentado até o dado que o originou.

3.1 · O sintoma que aparece primeiro

Uma prova de conceito declarada nesta turma compara a tabela de conceitos, a conta emitida e o registro do prontuário dentro de uma única conversa com o assistente. Ela funciona nos primeiros casos e deixa de funcionar quando o prontuário é longo. O sintoma é o limite de espaço da conversa; a causa é reunir leitura, confronto e conclusão em uma única passagem, sem arquivo intermediário que permita conferir o que foi efetivamente lido.

3.2 · O que muda ao final da manhã

Dimensão	Trabalho em planilha e conversa	Fluxo em repositório
Critério	Existe na cabeça de quem executa.	Está escrito em arquivo que se lê e se revisa.
Repetição	Refazer as decisões a cada competência.	Nova execução da mesma skill sobre novo arquivo.
Verificação	Conferência visual do resultado final.	Conferência de contagem e soma em cada passagem.
Rastreabilidade	O caminho do número se perde.	Cada afirmação devolve o endereço de origem.
Correção	Aplicada em cada cópia, uma a uma.	Aplicada na origem e propagada por reexecução.
Transferência	Depende de quem construiu a planilha.	Quem recebe a pasta executa e obtém o mesmo resultado.

4 · Bloco 1 · O repositório, as instruções e a primeira skill · 09:00 – 10:00

O primeiro bloco converte um procedimento que hoje existe na prática de quem executa em arquivos declarados, lidos pelo Copilot e revisáveis pela área.

4.1 · A cadeia de artefatos da manhã

Cinco artefatos e quatro passagens. Entre cada par existe um arquivo que se abre, se lê e se confere; é essa passagem intermediária que permite localizar o erro quando o resultado final diverge.

Artefato	Natureza	Produzido por	Conferência
dados/conta.xlsx e dados/itens.csv	Origem recebida do prestador	Terceiro; não se altera	Registro de recebimento
derivado/conta-2026-09.csv	Derivado normalizado	Script versionado	Contagem, soma, domínio e amostra
notas/achados-2026-09.md	Análise registrada	Agente com papel declarado	Revisão humana por amostragem
deck/comite.html	Entrega	Skill de geração sobre template	Percurso inverso da cadeia
conceitos/tabela.md	Regra de negócio	Área que responde pela regra	Data da última revisão no arquivo

Estrutura de pastas

auditoria-conta/
├─ .github/
│  ├─ copilot-instructions.md      regras sempre ativas
│  ├─ instructions/
│  │  └─ extracao.instructions.md  regras dos scripts
│  ├─ skills/
│  │  ├─ extrair-conta/SKILL.md
│  │  └─ gerar-deck/SKILL.md
│  └─ agents/
│     └─ auditor.agent.md
├─ conceitos/    tabela de regras, em markdown
├─ dados/        origem recebida, não se altera
├─ derivado/     csv normalizado, gerado por script
├─ scripts/      leitores e conferências
├─ notas/        relatório de achados
└─ deck/         template e apresentação gerada

A pasta é o entregável. A conversa se perde ao fechar a janela, não se compartilha com a colega ao lado e não registra qual versão da regra produziu qual número. A pasta se anexa a um processo, se envia a um par e se executa de novo meses depois.

4.2 · Onde o Copilot lê as regras da sua área

Arquivo	Onde fica	Quando se aplica	O que escrever
AGENTS.md	Raiz do repositório	Em toda solicitação	O que o repositório é, o vocabulário da área e as regras válidas para qualquer tarefa.
copilot-instructions.md	.github/	Em toda solicitação	Alternativa específica do Copilot ao anterior. Um dos dois basta.
*.instructions.md	.github/instructions/; no perfil, ~/.copilot/instructions	Somente nos arquivos que o campo applyTo declara	Convenções de um tipo de artefato: scripts, relatórios, template do deck.

Exemplo de instrução por padrão de arquivo

---
applyTo: "scripts/**/*.py"
---
# Scripts de extração

- Ler a origem sem alterá-la; gravar sempre em derivado/.
- Declarar as colunas de saída no início do arquivo.
- Emitir ao final: linhas lidas, linhas gravadas e soma das
  colunas de valor, para conferência contra a origem.
- Registrar em comentário a aba e o intervalo lidos.

O campo applyTo aceita padrão de caminho relativo à raiz do repositório; ** aplica a instrução a todos os arquivos.

O que não colocar nesses arquivos

• Regra que muda a cada caso: pertence à skill, e não à instrução sempre ativa.
• Texto longo de contexto de negócio: consome espaço em toda solicitação, inclusive nas que não o utilizam.
• Dado sensível de paciente ou condição comercial: o arquivo é versionado e compartilhado com a equipe.
• Instrução contraditória com outra existente: o comportamento passa a depender da ordem de leitura.

4.3 · A skill: o procedimento que se repete

Uma skill é uma pasta com um arquivo SKILL.md. O modelo a carrega quando a tarefa corresponde à sua descrição, e o usuário pode invocá-la digitando / na caixa de chat.

Onde a pasta pode ficar

Escopo	Caminhos aceitos	Consequência
Repositório	.github/skills/, .claude/skills/, .agents/skills/	A skill acompanha o projeto e vale para quem receber a pasta.
Perfil do usuário	~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/	A skill acompanha a pessoa e vale em todos os seus projetos.

Campos do cabeçalho

Campo	Obrigatório	Função
name	Sim	Identificador único, em letras minúsculas, números e hifens.
description	Sim	O que a skill faz e quando usá-la. É por esse texto que o modelo decide carregá-la sozinho.
argument-hint	Não	Indicação do que informar ao invocar por barra.
user-invocable	Não	Mantém ou retira a skill do menu de barra. Padrão: mantém.
disable-model-invocation	Não	Impede o carregamento automático, deixando a skill apenas sob invocação explícita.
context	Não	Com o valor fork, executa a skill em subagente próprio, sem misturar o histórico com a conversa principal.

Exemplo completo

# .github/skills/extrair-conta/SKILL.md
---
name: extrair-conta
description: Converte a planilha de conta hospitalar e o extrato de
  itens em um CSV normalizado em derivado/, com conferência de totais.
  Use ao receber uma conta nova em xlsx ou csv, antes de qualquer análise.
argument-hint: "[caminho do arquivo recebido]"
---
# Extração da conta

## Passos
1. Abra a origem indicada e identifique aba e linha de cabeçalho.
2. Use [scripts/extrair.py](./extrair.py); se as colunas não
   corresponderem, ajuste o mapeamento no topo do script, sem alterar
   a lógica de leitura.
3. Grave em `derivado/<origem>-<AAAA-MM>.csv`.
4. Emita a conferência e compare com a origem.
5. Se a conferência divergir, pare e relate a divergência.
   Não prossiga para a análise.

## Colunas de saída
`caso_id, item, quantidade, valor_unitario, valor_total,
 linha_origem, aba_origem`

Arquivos de apoio dentro da pasta da skill são referenciados por caminho relativo, como o script do exemplo. A descrição é a parte que decide se a skill será útil: descrição vaga produz skill que nunca é acionada.

4.4 · O agente: o papel, com ferramentas delimitadas

Enquanto a skill descreve um procedimento, o agente descreve quem executa. É um arquivo *.agent.md, guardado em .github/agents/ ou .claude/agents/ no repositório, ou em ~/.copilot/agents/ ou ~/.claude/agents/ no perfil. O agente é escolhido no seletor da janela de chat, e o corpo do arquivo é acrescentado à solicitação enquanto ele estiver selecionado.

Campo	Função
name	Nome exibido no seletor de agentes.
description	Explicação breve, exibida como texto auxiliar.
tools	Ferramentas que o papel alcança. É a delimitação que impede alteração acidental.
model	Modelo a utilizar; aceita uma lista em ordem de preferência.
agents	Subagentes a quem o papel pode delegar.
handoffs	Transições declaradas para outro papel, exibidas como botão ao final da resposta.
user-invocable	Mantém ou retira o papel do seletor.

Exemplo completo

# .github/agents/auditor.agent.md
---
name: Auditor de conta
description: Confronta itens cobrados com a tabela de conceitos e
  registra achados com origem citada.
tools: ['search/codebase', 'edit/files']
model: ['Claude Opus 4.5', 'GPT-5.2']
handoffs:
  - label: Gerar deck do comitê
    agent: agent
    prompt: Gere a apresentação a partir do relatório revisado.
    send: false
---
# Instruções do papel

Você confronta itens do CSV derivado com a tabela de conceitos e
registra achados no formato da skill `auditar-itens`.

## O que você entrega
Um achado por divergência, com origem, origem primária, regra
aplicada e status.

## O que você alcança
Os arquivos de `derivado/` e de `conceitos/`.

## O que lhe é vedado
- Estimar valor quando a evidência não existir no repositório;
  declare a ausência.
- Alterar arquivos de `dados/` ou de `derivado/`.
- Concluir sobre conduta clínica; o achado é econômico.
- Apresentar como confirmado o que depende de verificação.

4.5 · Instrução, skill ou agente: critério de escolha

Recurso	Em vigor	Use para	Exemplo
Instrução sempre ativa	Em toda solicitação	Vocabulário e regras válidas para qualquer tarefa	"Nunca altere arquivos de dados/."
Instrução por padrão	Quando o arquivo casa com applyTo	Convenções de um tipo de artefato	Formato obrigatório dos scripts.
Skill	Quando a tarefa corresponde à descrição, ou por barra	Procedimento com passos, repetido a cada caso	/extrair-conta, /gerar-deck.
Agente	Enquanto selecionado na janela de chat	Papel com ferramentas restritas e critério próprio	O auditor, sem acesso a execução no terminal.

A regra prática consiste em começar pelo recurso mais restrito que resolve. Declarar como agente aquilo que é apenas um procedimento multiplica arquivos sem acrescentar controle.

Decompor o fluxo entre skills

A fronteira entre duas skills é o arquivo que uma grava e a outra lê. Onde não existe arquivo intermediário, não existe ponto de verificação. No caso condutor:

Skill	Entrada	Saída	Critério de aceite
extrair-conta	dados/conta.xlsx	derivado/itens.csv	Soma dos valores igual à da origem.
auditar-itens	derivado/itens.csv e conceitos/tabela.md	notas/achados.md	Todo achado com linha de origem.
gerar-deck	notas/achados.md	deck/comite.html	Nenhum número sem correspondência no markdown.

No caso de giro de leitos, as mesmas três etapas se aplicam sobre o extrato de internações, a regra de tempo de permanência e o painel semanal.

4.6 · Roteiro da aplicação · 09:40 – 09:55

5 · Bloco 2 · Excel e CSV: do binário ao dado conferido · 10:00 – 11:00

O segundo bloco resolve a entrada do fluxo: como a planilha passa a alimentar o trabalho sem que ninguém copie e cole, e como se sabe que o que saiu corresponde ao que entrou.

5.1 · O agente não lê a planilha; ele escreve o leitor

O arquivo .xlsx é um formato binário compactado. O que o assistente faz com competência é escrever e executar o programa que o abre. A diferença entre pedir a leitura e pedir o leitor determina a qualidade de todo o restante do fluxo.

Critério	Pedir a leitura direta	Pedir o leitor
Volume	Limitado pelo espaço da conversa; parte das linhas não é considerada.	Indiferente: o programa processa o necessário.
Conferência	Não há arquivo intermediário para conferir.	O resultado é um arquivo que se abre e se compara com a origem.
Repetição	Nova execução pode devolver número diferente.	Mesma entrada, mesmo resultado.
Registro do critério	Fica na conversa, que se perde.	Fica no script, versionado e revisável.
Correção	Reescrever o pedido e torcer.	Corrigir a linha do script e reexecutar.

No modo agente, o Copilot executa o script no terminal mediante aprovação, lê a saída, identifica o erro e corrige em ciclo até a execução concluir. O trabalho de quem conduz consiste em ler o script antes de aprovar e conferir o resumo emitido ao final.

5.2 · A skill de extração

A conferência dentro da própria skill é o que impede que um erro de leitura siga adiante e apareça apenas na apresentação. A regra de parada é a parte mais importante do arquivo.

## Passos
1. Abra a origem indicada e identifique aba e cabeçalho.
2. Use [scripts/extrair.py](./extrair.py); se as colunas não
   corresponderem, ajuste o mapeamento no topo do script, sem
   alterar a lógica de leitura.
3. Grave em `derivado/<origem>-<AAAA-MM>.csv`.
4. Emita a conferência e compare com a origem.
5. Se a conferência divergir, pare e relate a divergência.
   Não prossiga para a análise.

As duas colunas que atravessam o fluxo

linha_origem e aba_origem percorrem todas as etapas seguintes. São elas que permitem, ao final, partir de um número da apresentação e chegar à célula da planilha que o produziu. Acrescentá-las custa duas linhas no script; reconstruí-las depois, quando um valor é questionado, custa a reabertura de todo o trabalho.

Nome do arquivo derivado

Origem e competência no nome tornam o arquivo autoexplicativo e impedem que a execução do mês seguinte sobrescreva a anterior em silêncio.

5.3 · As quatro conferências

Verificação	O que compara	Divergência indica
Contagem	Linhas lidas na origem e linhas gravadas no derivado.	Filtro não declarado, linha de subtotal tratada como dado ou cabeçalho repetido.
Soma	Total das colunas de valor nos dois arquivos.	Diferença de centavos aponta conversão de tipo; diferença grande aponta linhas perdidas.
Domínio	Datas dentro da competência, quantidades não negativas, campos obrigatórios preenchidos.	Célula mesclada, formato de data inconsistente ou registro incompleto na origem.
Amostra	Três linhas conferidas à mão contra a planilha.	Deslocamento de coluna, que as três conferências anteriores não detectam.

A amostra é escolhida nos extremos: primeira linha, última linha e linha de maior valor. Campo obrigatório vazio é relatado, e nunca preenchido por suposição.

5.4 · Onde a regra mora: script ou julgamento

Fica no script	Fica no julgamento do modelo
Comparação numérica entre cobrado e autorizado.	Leitura de texto livre: evolução clínica, descrição de item, justificativa registrada.
Junção entre tabelas por identificador.	Correspondência entre descrições escritas de forma distinta para o mesmo conceito.
Cálculo de diferença, percentual e totalização.	Redação do achado em linguagem compreensível pela área.
Classificação por faixa de valor ou por data.	Sugestão de hipótese a verificar, sempre submetida a conferência.
Toda condição que se escreve sem ambiguidade.	Toda leitura que exige interpretação do que está escrito.

O primeiro executa em segundos, custa o mesmo em qualquer volume e devolve sempre o mesmo resultado. O segundo custa por execução, varia entre execuções e exige registro de origem para ser verificável.

5.5 · Dado sensível na origem

Antes de colocar qualquer arquivo em dados/, verifique o que ele contém. Identificação de paciente, valor contratual e condição comercial seguem a política da Rede D'Or. O fluxo funciona igualmente com a origem mantida fora do repositório, em pasta de rede ou unidade controlada, desde que o caminho esteja declarado nas instruções e o derivado carregue apenas o necessário à análise.

5.6 · Roteiro da aplicação · 10:35 – 10:55

6 · Bloco 3 · Markdown como registro rastreável · 11:15 – 12:00

O terceiro bloco trata do meio do fluxo: o relatório em texto que é, ao mesmo tempo, o registro do trabalho, o objeto da revisão e a entrada da apresentação.

6.1 · Por que markdown entre o dado e a apresentação

• Comparável entre versões. A diferença entre duas competências se lê linha a linha; em documento binário, a mesma comparação exige abrir os dois lado a lado.
• Editável por quem revisa. O revisor corrige a frase no próprio arquivo, e a correção fica registrada com autor e data, sem versão paralela circulando por mensagem.
• Entrada de outra etapa. A apresentação é gerada a partir dele, sem redigitação: o número existe em um único lugar do fluxo.

6.2 · O formato do achado

# notas/achados-2026-09.md

## Achado 003 — quantidade acima do autorizado

- Item: material de síntese X
- Cobrado: 4 unidades · R$ 8.240,00
- Autorizado: 2 unidades, conforme tabela §12.3
- Diferença: R$ 4.120,00
- Origem: derivado/conta-2026-09.csv, linha 418
- Origem primária: conta.xlsx, aba Itens, linha 1204
- Regra: conceitos/tabela.md §12.3
- Status: a confirmar com a equipe assistencial

## Achado 004 — item sem correspondência na tabela

- Origem: derivado/conta-2026-09.csv, linha 502
- Evidência da regra: ausente
- Status: não classificado; requer decisão humana

Campo	Função
Origem	Linha do arquivo derivado. Permite reexecutar a verificação sem refazer a leitura da planilha.
Origem primária	Célula do arquivo recebido. É o que se apresenta a terceiro que não participou do trabalho.
Regra	Parágrafo da tabela de conceitos aplicado. Regra inexistente indica referência inventada.
Status	Distingue o confirmado do que depende de verificação, e impede que hipótese circule como fato.

O achado 004 registra que a regra não foi encontrada. Essa é a forma correta de tratar evidência ausente: declará-la, em vez de estimar o valor provável.

6.3 · Uma tarefa, uma sessão

O histórico da conversa compete pelo mesmo espaço que os dados e as regras. Conversa longa degrada o resultado sem emitir aviso.

Sintoma	Conduta
Instrução dada no início deixa de ser observada.	Encerrar a sessão ao concluir a etapa e abrir outra para a seguinte.
O formato do achado muda no meio do relatório.	Fazer o estado passar pelo arquivo: a etapa seguinte lê o que a anterior gravou.
Resposta genérica, sem referência ao arquivo aberto.	Referenciar o arquivo explicitamente na solicitação.
Repetição de trabalho já feito na mesma conversa.	Reiniciar a partir do arquivo produzido, e não do histórico.

Uma skill que percorre muitos arquivos para produzir resposta curta polui a conversa principal com material intermediário. O campo context: fork no SKILL.md executa a skill em subagente próprio: a conversa principal recebe o resultado, e não o caminho percorrido até ele.

6.4 · A revisão humana

Verificação	Como se faz	Decisão
Toda afirmação tem origem	Amostra de cinco achados; abrir o derivado na linha citada.	Achado sem origem é devolvido para refazer, e não corrigido na revisão.
A origem corresponde ao afirmado	Conferir valor e quantidade da linha citada contra o texto.	Divergência em um achado exige reconferência de todos os demais.
A regra citada existe	Abrir a tabela de conceitos no parágrafo indicado.	Regra inexistente indica referência inventada; revisar as instruções do papel.
A ausência está declarada	Procurar achados com evidência ausente e verificar se houve estimativa.	Estimativa sem lastro é a falha mais grave; ajustar o vedado no arquivo do agente.
O status distingue confirmado de hipótese	Leitura da linha de status de cada achado.	Achado sem status não segue para a apresentação.

6.5 · Roteiro da aplicação · 11:43 – 11:57

7 · Bloco 4 · Do markdown à apresentação em HTML · 12:00 – 13:00

O quarto bloco fecha o fluxo: a entrega gerada a partir do relatório, a verificação da cadeia completa e a definição de quem responde pelo repositório depois desta manhã.

7.1 · Conteúdo em markdown, forma no template

Arquivo	Responde por	Frequência de mudança
notas/achados.md	O que se afirma: achados, valores e origens. É o que a área revisa.	A cada competência.
deck/template.html	Como aquilo aparece: estrutura dos slides, tipografia, cores institucionais e navegação.	Raramente; fora do ciclo mensal.
deck/comite.html	Nada: é resultado. Abre no navegador e é descartável.	Regerado a cada execução.

A consequência da separação aparece na correção: um valor errado se corrige no relatório e a apresentação é gerada de novo. Sem a separação, a mesma correção precisa ser aplicada duas vezes, e a segunda é a que se esquece na véspera da reunião.

Um arquivo HTML único abre em qualquer navegador, não depende de aplicativo instalado e se anexa a um e-mail. É também formato de texto, o que permite ao assistente escrevê-lo e revisá-lo diretamente.

7.2 · A skill de geração

# .github/skills/gerar-deck/SKILL.md
---
name: gerar-deck
description: Gera a apresentação do comitê em HTML a partir do
  relatório de achados, usando o template versionado. Use quando o
  relatório estiver revisado e for necessário apresentá-lo.
---
# Geração da apresentação

1. Leia o relatório indicado em `notas/`.
2. Use [deck/template.html](../../../deck/template.html) como
   estrutura; não altere o template.
3. Um slide por achado confirmado, na ordem do relatório.
4. Todo número exibido existe no relatório; nenhum valor é
   calculado nesta etapa.
5. Cada slide cita, em rodapé, a origem do achado.
6. Achado com status não confirmado vai para um slide final de
   pendências, e não para o corpo.
7. Grave em `deck/` e informe quantos achados entraram.

Restrição	Razão
Nenhum cálculo nesta etapa	Um total recalculado na geração pode divergir do relatório revisado, e a divergência aparece na reunião. O total pertence ao relatório, que é onde a revisão ocorreu.
O template não se altera	Forma variável a cada competência destrói a comparabilidade entre meses. Ajuste de forma é tarefa própria, feita fora do ciclo.
Pendências em slide separado	Separar o confirmado do que depende de verificação evita que a reunião decida sobre hipótese.
Origem no rodapé de cada slide	É o que permite responder à pergunta da diretoria sem reabrir o trabalho.

7.3 · A cadeia percorrida ao contrário

A verificação final consiste em partir de um número da apresentação e chegar à célula da planilha recebida:

1. Slide 7 exibe R$ 4.120,00 e alguém pergunta de onde saiu.
2. O rodapé do slide cita o Achado 003.
3. O achado cita derivado/conta-2026-09.csv, linha 418, e a regra §12.3.
4. A coluna de origem daquela linha aponta conta.xlsx, aba Itens, linha 1204.

O teste se aplica escolhendo um número qualquer e percorrendo a cadeia diante de outra pessoa. Se o percurso exigir abrir uma conversa antiga, consultar a memória de quem fez ou reabrir um cálculo em célula, a cadeia está rompida naquele ponto.

Rompimento	Correção
Número digitado direto no slide.	Proibir o cálculo na skill de geração e regerar a partir do relatório.
Coluna de origem não propagada na extração.	Acrescentar linha_origem e aba_origem ao script e reexecutar.
Arquivo derivado sobrescrito pela execução seguinte.	Incluir competência no nome do arquivo.
Relatório corrigido à mão depois de gerado o deck.	Regerar o deck após toda correção do relatório.

7.4 · Ciclo de vida do repositório

Artefato	Versiona	Dono	Revisão
Instruções sempre ativas e skills	Sim	Responsável pelo processo na área	A cada mudança de regra de negócio
Arquivo do agente	Sim	Responsável pelo processo na área	Sempre que a revisão apontar falha recorrente
Scripts de extração	Sim	Quem opera o fluxo	Quando a origem mudar de formato
Tabela de conceitos e regras	Sim	Área que responde pela regra	Periodicidade declarada, com data da última revisão no arquivo
Arquivos recebidos em dados/	Conforme política de retenção	Quem recebe do prestador	Não se altera
Derivados e apresentação	Opcional; são reproduzíveis	—	Regerados a cada competência

O repositório deixa de funcionar quando ninguém responde por ele. A designação de dono é parte do desenho, e não consequência dele: sem nome escrito em cada linha da tabela acima, a primeira mudança de formato da origem interrompe o fluxo.

7.5 · Roteiro da aplicação · 12:35 – 12:55

8 · Checklist antes da rotina

Doze verificações que decidem se o repositório continuará funcionando quando outra pessoa o executar, na competência seguinte, sem quem o construiu ao lado.

Dimensão	Verificação
Declaração	As regras que valem sempre estão em um único arquivo, sem duplicação entre AGENTS.md e copilot-instructions.md.
	Cada skill declara, na descrição, o que faz e em que situação usá-la.
	Cada agente declara o que entrega, o que alcança e o que lhe é vedado.
Dado	A origem nunca é alterada pelo fluxo.
	A extração é script versionado, e não leitura feita dentro da conversa.
	A conferência de contagem e soma precede qualquer análise, com regra de parada declarada.
Rastreabilidade	A coluna de origem atravessa todas as etapas do fluxo.
	Toda afirmação do relatório devolve arquivo e linha.
	A ausência de evidência é declarada como ausência, sem estimativa.
Continuidade	Cada artefato tem dono designado e periodicidade de revisão.
	A apresentação é gerada a partir do relatório, e nunca editada à mão.
	A decisão permanece com o profissional que responde por ela.

9 · Glossário e referências

Termo	Definição adotada neste material
Instrução sempre ativa	Arquivo de texto lido em toda solicitação, que declara o que o repositório é e as regras válidas para qualquer tarefa. Reside em AGENTS.md na raiz ou em .github/copilot-instructions.md.
Instrução por padrão de arquivo	Arquivo *.instructions.md em .github/instructions/, aplicado apenas aos arquivos que o campo applyTo declara.
Skill	Pasta com um SKILL.md que descreve um procedimento repetível. Carregada quando a tarefa corresponde à sua descrição, ou invocada com / no chat.
Agente	Arquivo *.agent.md que declara um papel: instruções, ferramentas alcançáveis, modelo e transições. Selecionado no seletor da janela de chat.
Modo agente	Modo de operação em que o assistente edita arquivos e executa comandos no terminal mediante aprovação, corrigindo erros em ciclo.
Arquivo derivado	Resultado da extração, gravado em derivado/ por script versionado, conferido contra a origem e nunca editado à mão.
Origem e origem primária	Endereço da linha no arquivo derivado e da célula no arquivo recebido, propagados por todas as etapas.
Regra de parada	Condição declarada na skill que interrompe o fluxo quando a conferência diverge.
Menor privilégio	Concessão a cada papel apenas das ferramentas exigidas pela sua etapa.
Cadeia de rastreabilidade	Percurso que liga um número da apresentação ao relatório, ao arquivo derivado e à célula de origem.

Referências

• Visual Studio Code — Use Agent Skills in VS Code, documentação de produto. Caminhos das pastas de skills e campos do SKILL.md.
• Visual Studio Code — Custom agents, documentação de produto. Arquivos *.agent.md, campos e seleção no chat.
• Visual Studio Code — Custom instructions, documentação de produto. AGENTS.md, copilot-instructions.md, arquivos *.instructions.md e o campo applyTo.
• Visual Studio Code — Build with agents in VS Code, documentação de produto. Modo agente, execução no terminal e referências de contexto.
• GitHub — About agent skills, documentação de produto. Agent Skills como formato aberto entre ferramentas.

Recursos conferidos na documentação oficial em setembro de 2026. Nomes e caminhos de produto mudam; em caso de divergência, a documentação prevalece sobre este material.