🎯 Fundamentos

O que é
“Organizar meu trabalho” descreve uma intenção, mas não diz qual arquivo deve existir ao terminar.

Por que aprender
Uma saída concreta permite comparar o pedido com o resultado. Sem essa comparação, uma resposta bem escrita pode parecer concluída mesmo quando faltam informações importantes.

Conceitos-chave
Entrada · Saída · Unidade · Escopo

O que é
Uma ficha curta funciona como um acordo de trabalho.

Por que aprender
A ficha reduz idas e vindas e ajuda a identificar mudanças de escopo. Uma nova função entra em uma lista futura em vez de alterar silenciosamente o trabalho em andamento.

Conceitos-chave
Objetivo · Exclusão · Aceite · Pendência

O que é
Um bom pedido informa quais campos devem ser preservados, qual formato deve ser usado e como tratar informações ausentes.

Por que aprender
A qualidade da saída depende da clareza da transformação. Especificar o tratamento das lacunas costuma ser mais útil que acrescentar adjetivos como perfeito, completo ou profissional.

Conceitos-chave
Formato · Fidelidade · Lacuna · Separação

O que é
Faça uma comparação linha a linha.

Por que aprender
A conferência transforma uma impressão em prova. Ela também mostra onde corrigir: na extração, no formato ou na regra de negócio, sem reconstruir o processo inteiro.

Conceitos-chave
Contagem · Correspondência · Regressão · Evidência

O que é
Uma etapa termina quando entrega o combinado e passa nas verificações.

Por que aprender
Limitar o trabalho em andamento reduz a sensação de ter muitos projetos quase prontos. Você passa a acumular entregas pequenas que funcionam e podem ser combinadas.

Conceitos-chave
Etapa · Limite · Bloqueio · Melhoria

O que é
Crie uma pasta para o exercício e salve o texto de entrada antes de usar o assistente.

Por que aprender
A prática ensina a fechar uma tarefa pequena e introduz uma ideia central do curso: variar a entrada para descobrir se a solução entendeu a regra ou apenas imitou o exemplo.

Conceitos-chave
Caso comum · Caso incompleto · Variação · Conclusão

O que é
Uma skill reúne instruções e, às vezes, scripts e arquivos auxiliares para orientar uma tarefa.

Por que aprender
Reconhecer as peças permite estimar esforço e saber onde uma falha acontece. Você evita procurar um comando que nunca foi instalado ou atribuir a uma skill uma capacidade que depende de outro serviço.

Conceitos-chave
Skill · CLI · MCP · Dependência

O que é
Comece pela descrição, pelos arquivos de instrução e pelo instalador.

Por que aprender
Uma inspeção pequena e rastreável é mais útil que uma aprovação genérica. Ela vincula a decisão a uma revisão concreta e permite reavaliar apenas o que mudou.

Conceitos-chave
Revisão · Instalador · Destino · Registro

O que é
Um achado útil contém localização, evidência, impacto e contexto.

Por que aprender
Relatórios sem contexto produzem muitos alarmes e pouca orientação. A triagem ajuda a distinguir um comportamento necessário de uma permissão excessiva ou uma operação que exige cuidado adicional.

Conceitos-chave
Evidência · Impacto · Contexto · Triagem

O que é
Ferramentas automáticas identificam padrões; você precisa interpretar o resultado.

Por que aprender
A qualidade da inspeção não é medida pela quantidade de alertas eliminados. Ela depende de decisões reproduzíveis e de limitações visíveis, inclusive quando não é possível concluir.

Conceitos-chave
Confirmado · Falso positivo · Inconclusivo · Teste focado

O que é
Instale apenas depois de entender o que será alterado.

Por que aprender
O teste reduz o custo de descobrir incompatibilidades. Você aprende o comportamento do conjunto antes de permitir que ele participe de tarefas maiores ou use documentos importantes.

Conceitos-chave
Isolamento · Fixture · Reversão · Promoção

O que é
Use o exemplo fictício abaixo como se fosse parte de uma skill.

Por que aprender
Uma decisão bem escrita pode ser revisada por outra pessoa. Ela também mostra que inspeção não é um selo definitivo: novos comportamentos exigem nova análise.

Conceitos-chave
Declaração · Observação · Condição · Decisão

O que é
Uma revisão começa com a mudança que você quer avaliar e com o comportamento esperado.

Por que aprender
Contexto reduz comentários genéricos e evita que o revisor proponha mudanças que contradizem o objetivo. Também limita o custo e o alcance da revisão.

Conceitos-chave
Contrato · Diff · Hipótese · Reprodução

O que é
Em um projeto Git, o diff mostra o que mudou.

Por que aprender
Uma base clara impede que o revisor compare arquivos errados ou trate código antigo como parte da alteração atual. A inspeção do status também evita publicar dados de preparação por engano.

Conceitos-chave
Base · Status · Escopo · Ajuda local

O que é
Solicite que cada achado descreva gatilho, efeito, localização e forma de reproduzir.

Por que aprender
Achados acionáveis tornam a revisão uma ferramenta de decisão. Você consegue priorizar pelo impacto e verificar se a menor alteração realmente resolveu o caso.

Conceitos-chave
Gatilho · Efeito · Prioridade · Correção mínima

O que é
Muitos erros aparecem na segunda execução.

Por que aprender
Esses cenários são fáceis de esquecer em demonstrações. Testar repetição e interrupção revela problemas que uma leitura superficial ou uma única execução não mostra.

Conceitos-chave
Retry · Idempotência · Atomicidade · Interrupção

O que é
Quando uma correção falha repetidamente, registre o que já foi tentado e o resultado de cada tentativa.

Por que aprender
Um caso mínimo reduz a quantidade de explicações possíveis. Ele permite distinguir um problema de lógica, uma configuração incompatível e uma dependência indisponível.

Conceitos-chave
Caso mínimo · Histórico · Hipótese única · Parada

O que é
Imagine um formulário fictício que acrescenta pedidos a uma lista.

Por que aprender
A prática liga revisão, teste e comportamento de negócio. Você aprende a verificar o efeito real da correção e a reconhecer quando duas entradas aparentemente iguais representam situações diferentes.

Conceitos-chave
Identificador · Duplicação · Conflito · Teste de retorno