Comece aqui: sua primeira alteração verificada

Objetivo: abra um projeto de trabalho pequeno, explique um comportamento, mude-o com Copilot e prove o resultado. Esta primeira rota usa JavaScript, mas você não precisa escolhê-la como sua linguagem de longo prazo.

[!TIP] Use um kit, não o repositório inteiro. Baixe 01-interface.zip. Nenhuma instalação de pacote, Python, .NET, Docker, pagamento, repositório GitHub ou implantação em nuvem é necessária.

1. Prepare apenas o que este exercício precisa

Ainda não conhece as ferramentas ou as contas? Siga Pré-requisitos e contas para o cadastro pessoal no GitHub, Copilot Free e outros planos, VS Code em comparação com Insiders, instalação da CLI em cada sistema operacional e uso opcional de Codespaces ou Azure. Depois, volte aqui; nenhuma das ofertas opcionais de nuvem é necessária para este laboratório.

[!NOTE] Você pode inspecionar o projeto e executar testes locais sem o Copilot. Se o acesso estiver bloqueado, registre baseline local concluída; etapas do agente não executadas. Não afirme um exercício completo do Copilot nem altere cobrança ou política automaticamente.

2. Baixe, extraia e abra

1. Baixe o ZIP acima. Na prévia de arquivos do GitHub, use Download raw file.
2. Escolha uma nova pasta em sua unidade de trabalho, fora de outro repositório.
3. Use Extract All no Windows ou a ação de extração do seu gerenciador de arquivos no macOS/Linux.
4. Abra o diretório extraído 01-interface no VS Code usando Arquivo → Abrir pasta.
5. Confirme que o Explorador mostra os seguintes arquivos:

01-interface/
  KIT-START.md          First-run guide
  KIT-LESSON.md         Complete exercise
  KIT-MANIFEST.json     Original file hashes
  KIT-VERIFY.cjs        Integrity check
  greeting.mjs          Code you will investigate
  greeting.test.mjs     Existing tests

O arquivo também inclui licenças e guia de configuração. Para verificação de hash, instruções específicas do sistema ou publicação no GitHub, use o guia de downloads.

Ponto de controle: os arquivos estão extraídos e podem ser editados. Você não está olhando a prévia do ZIP nem editando o starter original do currículo.

3. Execute a linha de base intocada

Selecione Terminal → Novo terminal no VS Code. O terminal é uma interface de comandos para o seu computador; não é o Copilot Chat. O diretório de trabalho dele deve ser 01-interface, a pasta que contém os dois arquivos de saudação.

node KIT-VERIFY.cjs
node --test --test-concurrency=1 greeting.test.mjs

O comando de integridade confirma os bytes empacotados antes de editar. O segundo comando executa os testes reais. Espere 2 testes, 2 aprovados e 0 falhas no fixture intocado; a duração e o formato da saída podem variar.

Registre o comando e a saída em uma nota de evidência local. Não copie os números esperados na nota a menos que sua execução realmente os informe.

4. Entenda o conceito antes de mudar o código

A função formata um nome. Os testes já rejeitam entrada vazia ou que não seja string. O novo requisito é: remover os espaços em branco ao redor sem perder esses erros.

Com greeting.mjs aberto, escolha um papel Ask compatível. Anexe o arquivo se necessário e envie:

Explain how greeting handles blank names and surrounding whitespace.
Cite the actual implementation and current tests. Do not edit or run commands.
Separate existing behavior from missing test coverage.

Compare a resposta com os arquivos. Uma explicação plausível sem evidência de fonte não basta.

5. Planeje, implemente e desafie

Em um papel Plan compatível, envie:

Plan trimming surrounding whitespace before formatting a greeting, while preserving
errors for blank and non-string values. Include " Ada ", "", "   ", null and a number.
Limit changes to greeting.mjs and greeting.test.mjs. Name the check and reset path.
Do not implement yet.

1. Revise os arquivos afetados e os casos de teste antes de aprovar.
2. Peça a Agent que implemente apenas esse plano revisado.
3. Inspecione os comandos propostos e o diff completo. Não aceite testes enfraquecidos.
4. Execute você mesmo o mesmo comando de teste da etapa 3.
5. Adicione ou confirme uma asserção para os espaços em branco ao redor.
6. Altere temporariamente uma saudação esperada para um valor obviamente errado, execute novamente e observe a asserção falhar. Restaure essa asserção e execute novamente com sucesso.

Ponto de controle: tanto os erros originais quanto o novo comportamento de espaço em branco estão em teste. A asserção errada deliberada falhou. Uma UI verde por si só não é evidência.

Por que a transferência de papéis importa

---
config:
  theme: base
  look: classic
  themeVariables:
    darkMode: false
    background: "#ffffff"
    primaryColor: "#f5f5f5"
    primaryTextColor: "#111111"
    primaryBorderColor: "#555555"
    secondaryColor: "#e0e0e0"
    secondaryTextColor: "#111111"
    secondaryBorderColor: "#666666"
    tertiaryColor: "#bdbdbd"
    tertiaryTextColor: "#111111"
    tertiaryBorderColor: "#444444"
    lineColor: "#444444"
    textColor: "#111111"
    mainBkg: "#f5f5f5"
    nodeBorder: "#555555"
    clusterBkg: "#ffffff"
    clusterBorder: "#999999"
    edgeLabelBackground: "#ffffff"
    actorBkg: "#e0e0e0"
    actorBorder: "#555555"
    actorTextColor: "#111111"
    actorLineColor: "#777777"
    signalColor: "#333333"
    signalTextColor: "#111111"
    labelBoxBkgColor: "#f5f5f5"
    labelBoxBorderColor: "#777777"
    labelTextColor: "#111111"
    loopTextColor: "#111111"
    activationBkgColor: "#bdbdbd"
    activationBorderColor: "#555555"
    noteBkgColor: "#f5f5f5"
    noteTextColor: "#111111"
    noteBorderColor: "#777777"
    attributeBackgroundColorOdd: "#f5f5f5"
    attributeBackgroundColorEven: "#e0e0e0"
---
sequenceDiagram
    accTitle: Transferências entre a pessoa em aprendizagem e os papéis de agente
    accDescr: A pessoa solicita investigação, um plano delimitado, implementação e revisão independente, recebendo um artefato de evidência diferente em cada etapa.
    participant L as Aprendiz
    participant A as Ask
    participant P as Plan
    participant G as Agent
    participant R as Revisor

    L->>A: Investigar o estado atual
    A-->>L: Fatos, restrições, incógnitas
    L->>P: Projetar uma alteração delimitada
    P-->>L: Escopo, riscos, verificações, restauração
    L->>G: Implementar o plano aprovado
    G-->>L: Diff e validação executada
    L->>R: Questionar a alegação de conclusão
    R-->>L: Descobertas e lacunas de evidências

Legenda. Os participantes são a pessoa em aprendizagem e os papéis de agente. As setas contínuas são solicitações; as tracejadas são descobertas, planos, alterações ou resultados de revisão retornados.

Explicação. A pessoa em aprendizagem é responsável pela aceitação em cada limite. Uma transferência de papel leva o contexto da tarefa, mas não comprova que um teste ou uma revisão foi executado.

Use o guia de harnesses ao escolher onde o agente executa. Ask, Plan e Agent descrevem responsabilidades; nem todo CLI ou runtime os apresenta como três botões idênticos.

6. Finalize, redefina e escolha o próximo passo

• O estado inicial está documentado.
• O escopo e as exclusões são explícitos.
• O harness e o ambiente escolhidos estão justificados.
• As verificações relevantes foram realmente executadas.
• A saída e o status de saída foram registrados.
• As descobertas da revisão foram resolvidas ou aceitas.
• Os recursos temporários e as credenciais foram removidos.

Para uma redefinição, salve sua evidência e extraia o ZIP original em outro diretório não usado. Se você criou uma linha de base Git, restaure apenas os arquivos de exercício nomeados depois de inspecionar seu diff. Não faça hard reset de outro repositório.

O que pode esperar

O histórico do Git e a publicação no GitHub são opcionais para este primeiro exercício local. Codespaces e Dev Containers são ambientes alternativos, não etapas obrigatórias extras. Compilar todo o site de aprendizado é uma tarefa de manutenção. MCP, Spec Kit, agentes paralelos, a nuvem e o SDK vêm mais adiante em a progressão.