Todo grande projeto
começa com um passo.
Escolha uma trilha, encontre um assunto ou comece pela primeira aula. Não há prova de entrada, cadastro ou prazo para acompanhar.
61 aulas disponíveis
Computador arquivos editor e primeira execução
Este percurso começa com um arquivo de texto que o computador executa. Você aprenderá a localizar esse arquivo, modificá-lo e verificar o efeito da mudança. Essa competência será usada…
Valores variáveis objetos e coleções
O catálogo precisa distinguir um título, uma quantidade e uma autorização de exibição. Esses valores têm usos diferentes. Uma string representa texto, como Conserto de bicicletas. Um number…
Decisões repetições e acompanhamento da execução
O requisito de catálogo contém uma decisão: mostrar o registro quando ativo for true e omiti-lo quando for false. Uma condição representa essa escolha. if executa um bloco quando a condição…
Funções módulos contratos e tratamento de erros
Uma função agrupa instruções para realizar uma tarefa identificável. Parâmetros são os nomes que recebem as entradas; argumentos são os valores entregues na chamada. O retorno é o resultado…
Página navegador interação e comunicação com o servidor
Uma página web combina estrutura, apresentação e comportamento. HTML descreve os elementos, CSS define sua apresentação e JavaScript responde a ações ou transforma informações. São papéis…
Testes depuração versões e primeiro ciclo completo
Um teste executa um cenário e compara o resultado observado com uma expectativa. A expectativa precisa vir da regra, e não de copiar o resultado que o programa já produziu. Para a função de…
O que significa programar
Imagine que você recebeu a encomenda de criar o catálogo da Oficina Caracol. A frase parece simples, mas ainda não permite decidir se uma entrega está correta. Catálogo de quê? Quem pode…
A identidade da Engenharia Caracol
A Engenharia Caracol é a proposta de organização do trabalho apresentada por Graciliano Tolentino. Ela combina compreensão, estrutura, ciclos, autoridades, decisões de passagem, auditoria e…
Papéis e autoridades
Em uma equipe pequena, a mesma pessoa pode conversar com o usuário, escrever código e preparar a publicação. Acumular funções é frequente. O problema aparece quando essa concentração apaga…
Linguagem natural estruturada
O pedido melhore o catálogo transfere para o executor decisões que o solicitante talvez não pretendesse delegar. Melhorar pode significar mudar cores, reordenar serviços ou ocultar os…
Compreender profundamente o problema
O responsável pela Oficina Caracol diz: precisamos de um assistente automático porque as pessoas perguntam sempre as mesmas coisas. Essa frase contém um sintoma e uma solução preferida.…
Escopo e critérios de aceite
Escopo é o acordo sobre o que uma versão deverá oferecer e sobre o que ficará fora dela. Serve para decidir o trabalho, não apenas descrevê-lo depois. Na Oficina Caracol, dizer um catálogo…
Inventário do estado atual
Você recebe uma pasta chamada projeto final. Dentro dela há arquivos, imagens e um README. O nome da pasta não comprova conclusão, assim como encontrar um arquivo de teste não comprova que…
Preservar reparar refatorar ou reconstruir
Ao encontrar um sistema existente, o programador pode sentir vontade de recomeçar para entender tudo. A familiaridade com a própria solução é atraente, mas não elimina o conhecimento…
Fonte única de verdade
Há um preço no arquivo de dados, outro numa planilha e outro escrito diretamente na página. Qual deve orientar a correção? A fonte única de verdade é uma regra de autoridade para um domínio…
Responsabilidade única e coesão
Um arquivo curto pode misturar responsabilidades; um arquivo maior pode concentrar tarefas que pertencem ao mesmo propósito. Responsabilidade única significa organizar uma unidade em torno…
Waterfall e Caracol
A Oficina Caracol precisa listar serviços ativos. Antes de decidir se a listagem funciona, precisamos saber o que significa ativo e qual resultado caracteriza uma listagem correta. Essa…
Ciclos unidades e granularidade
Uma capacidade descreve algo que uma pessoa consegue realizar: consultar a lista pública de serviços ativos é uma capacidade; criar uma pasta não é. Um ciclo Caracol reúne trabalho…
Maturidade M0 a M8
Dizer que o catálogo está quase pronto não informa o que já foi demonstrado. A escala M0–M8 organiza estados de evidência: uma descrição não equivale a código executável, e um teste isolado…
Gates e vereditos
Gate é uma decisão de passagem vinculada a uma capacidade, uma versão e um uso. Ele responde se aquele resultado pode avançar nas condições declaradas. Não é uma reunião obrigatória nem um…
Evidência e rastreabilidade
Evidência é informação identificável que sustenta uma afirmação dentro de limites. Uma imagem pode mostrar a aparência de uma tela; não demonstra, sozinha, que inativos nunca são enviados…
Retorno controlado
Retornar significa revisar uma decisão ou artefato porque surgiu informação que altera sua validade. Não é recomeçar por insegurança nem desfazer tudo por conveniência. O retorno controlado…
Raiz diretórios e porta de entrada
A raiz é a pasta que contém o projeto. Um caminho identifica a localização de um arquivo a partir de alguma referência. Em pratica/src/catalogo.mjs, pratica é a raiz do pacote de estudo e…
Manifesto numeração e mapa geral
O manifesto é o mapa dos artefatos que o projeto reconhece como oficiais, candidatos ou históricos. Ele responde qual documento orienta o trabalho e onde localizar sua versão. Um número…
Backlog prioridades e pronto
Backlog é a lista organizada do trabalho considerado para o produto. Uma vontade como melhorar o catálogo ainda não define uma alteração executável. O item precisa dizer por que existe,…
Risco e proporcionalidade
Risco descreve a possibilidade de uma falha e suas consequências no contexto. Probabilidade e impacto orientam a avaliação; capacidade de detectar o problema e possibilidade de desfazer…
Tecnologias e compatibilidade
Stack é o conjunto de tecnologias usado para construir e executar um sistema. Na Oficina Caracol, JavaScript atende dois ambientes: navegador, que apresenta a interface, e Node, que executa…
Dependências e lockfile
Dependência é algo de que o programa precisa para funcionar ou ser desenvolvido. Ela pode ser uma biblioteca externa, um recurso de execução ou um contrato entre módulos. Neste capítulo, o…
Comandos reproduzíveis
Um comando reproduzível informa onde executar, o que precisa existir, qual ação realiza, como reconhecer sucesso e o que fazer quando falha. Seu nome isolado não basta. npm run validate,…
Da especificação para o código
Um requisito descreve uma necessidade. Um contrato descreve o comportamento que uma unidade de software deve cumprir: quais entradas recebe, quais saídas produz e o que acontece quando a…
Uma unidade por vez sem perder o todo
Uma unidade de trabalho é uma mudança pequena com fronteiras e resultado verificáveis. Ela não precisa coincidir com um arquivo. Corrigir a seleção de casos ativos pode exigir uma função e…
Protocolo de IA
Uma inteligência artificial pode produzir uma proposta convincente sem ter lido o estado atual, executado o teste ou percebido um contrato importante. O protocolo organiza o trabalho para…
Revisão de código produzido por IA
A revisão começa com uma pergunta: que observação mostraria que esta mudança está errada? Se o revisor apenas lê a explicação da IA e procura palavras familiares, ele acompanha a narrativa…
Alucinações arquiteturais
Uma alucinação arquitetural ocorre quando uma proposta trata como existente um arquivo, serviço, função, rota ou estado que não foi confirmado. Ela pode surgir de um nome plausível, de uma…
Erros e estados de falha
Um catálogo vazio é um resultado válido: o sistema leu dados corretos e não encontrou serviço ativo. Um catálogo indisponível significa que a operação não pôde produzir uma resposta…
Integração duplicação e mudanças
DRY é uma orientação para evitar a repetição de conhecimento que precisa permanecer coerente. Não é uma ordem para juntar toda sequência de linhas parecidas. Duas funções podem ter…
Estratégia de testes por risco
Testar é produzir informação sobre um comportamento, comparando o observado com um resultado esperado. A estratégia organiza onde buscar essa informação primeiro. Na Oficina Caracol, listar…
Níveis de teste e proteção contra regressões
Um nível de teste descreve o alcance da verificação. No teste unitário, uma pequena unidade é exercitada com suas dependências controladas. Na integração, verificamos a colaboração entre…
Segurança e privacidade desde o desenho
Um ativo é algo cujo valor precisamos preservar: código, credenciais, disponibilidade ou dados. Uma ameaça descreve um evento capaz de causar dano. Uma fronteira de confiança separa regiões…
Desempenho e acessibilidade em condições observáveis
Desempenho descreve como o sistema responde sob condições determinadas. Acessibilidade trata da possibilidade de pessoas com diferentes necessidades perceberem, compreenderem e operarem o…
Dados conteúdo e configuração como comportamento
Um arquivo de dados, uma variável de configuração e o texto publicado alteram o que o programa faz. O código pode estar correto e ainda apresentar um serviço encerrado se o catálogo estiver…
Build entrega e decisão final
Build é a preparação de um artefato utilizável a partir dos arquivos do projeto. Mesmo quando uma aplicação JavaScript dispensa compilação, é preciso identificar o conjunto que será…
Auditoria documental arquitetural e de código
Auditoria é uma comparação orientada por critérios e sustentada por evidências. A camada documental registra intenção e instruções; a arquitetura define responsabilidades e relações; o…
Dívida técnica e refatoração com propósito
Dívida técnica é uma condição que torna o trabalho futuro mais caro ou arriscado. O nome só ajuda quando conseguimos descrever a condição, o benefício presente e o custo esperado. Na…
Migração versão e depreciação sem surpresa
Um contrato público define o que consumidores podem esperar de uma interface. Versionar identifica a evolução desse compromisso; migrar prepara dados e consumidores para uma mudança;…
Observabilidade e resposta a incidentes
Observabilidade é a capacidade de compreender estados internos a partir de sinais do sistema. Logs registram eventos; métricas resumem medidas ao longo do tempo; rastros relacionam etapas…
Continuidade institucional e transferência do projeto
Continuidade institucional significa manter a capacidade de operar e evoluir um projeto quando mudam pessoas ou fornecedores. Ela depende de acesso autorizado, documentação suficiente,…
Excesso de documentação
A documentação ajuda quando alguém consegue decidir ou executar algo com ela. Um arquivo que repete outro sem declarar qual prevalece aumenta o trabalho: cada mudança exige conferir duas…
Paralisia por análise
Analisar é comparar possibilidades antes de comprometer recursos. A análise paralisa quando o grupo continua discutindo sem identificar qual informação poderia mudar a decisão. A saída não…
Fragmentação e visão do todo
Coesão é a relação entre responsabilidades que fazem sentido juntas. Acoplamento descreve a dependência entre partes. Um arquivo curto pode depender de tantos outros que se torna difícil…
Falsa segurança e suficientemente bom
Suficientemente bom significa atender aos critérios do recorte declarado com limites conhecidos e risco residual aceitável. Não significa aceitar qualquer coisa porque o prazo acabou.…
Perfil Essencial
O Perfil Essencial atende a um trabalho de baixo impacto e retorno viável. Ele reduz cerimônias, mas não reduz o compromisso com o comportamento anunciado. Na Oficina Caracol, uma…
Perfil Estruturado
O Perfil Estruturado torna explícitos os contratos e os controles que permitem a pessoas diferentes alterar um sistema sem depender de memória individual. Pipeline é uma sequência definida…
Perfil Crítico e crise
Um incidente é uma interrupção ou degradação que exige resposta coordenada. Uma crise acrescenta pressão, incerteza e impacto que podem superar a capacidade habitual de trabalho. O Perfil…
Checklists essenciais
Este kit é uma ferramenta de consulta e não repete o formato dos capítulos de aprendizagem. Cada item recebe um estado: aprovado, falhou, pendente ou não aplicável com justificativa.…
Modelos de governança
Os registros deste capítulo estão conectados à Oficina Caracol. Eles exemplificam conteúdo preenchido, não uma coleção de campos vazios. A execução automatizada citada ocorreu em 2 de…
Prompts para a Vida Relacional
Prompts orientam uma ferramenta de linguagem; não substituem requisitos, execução nem responsabilidade. Vida Relacional designa aqui a colaboração entre pessoas, registros, código e…
A engenharia como memória
A qualidade de um projeto não está apenas no código atual. Ela também está na capacidade de explicar por que esse código existe, quais compromissos ele cumpre e como alguém pode modificá-lo…
O código como consequência e prova
Chamar o código de consequência não reduz sua importância. Significa que a implementação responde a um problema e a compromissos identificados. A partir daí, ela também oferece resistência…
Autonomia do desenvolvedor júnior
Autonomia não é deixar uma pessoa sozinha diante de uma ambiguidade. É oferecer contexto, fronteiras, critérios e meios para que ela execute, avalie o resultado e reconheça quando precisa…
Pessoas IA e o futuro do método
Ferramentas de inteligência artificial ampliam a velocidade de leitura, comparação e geração. Também podem produzir respostas plausíveis sobre arquivos que não leram e testes que não…
Nenhuma aula encontrada. Tente um termo mais curto ou escolha outra trilha.