AI For Dummies — Field Guide A field guide 01 fleet 01 frota 02 worktrees 02 worktrees 03 models 03 modelos 04 skills 04 skills 05 create 05 criar 06 field kit 06 kit de campo 07 hands-on 07 prática 08 verify review submissions ↗ EN / PT AI ENGINEERING 01 / 2026 ENGENHARIA DE IA 01 / 2026 A presentation for humans who ship Uma apresentação para quem entrega software AI for dummies. You do not need an army of models. You need a system: one mind to frame the work, several hands to execute it, and a clean boundary between every task. Você não precisa de um exército de modelos. Precisa de um sistema: uma mente para enquadrar o trabalho, várias mãos para executá-lo e uma fronteira clara entre cada tarefa. FIELD NOTE / 001 NOTA DE CAMPO / 001 Ship the system. Entregue o sistema. Skills · agents · worktrees · proof Skills · agentes · worktrees · evidências Uma apresentação para quem entrega software AI for dummies. Você não precisa de um exército de modelos. Precisa de um sistema: uma mente para enquadrar o trabalho, várias mãos para executá-lo e uma fronteira clara entre cada tarefa. NOTA DE CAMPO / 001 Entregue o sistema. Skills · agentes · worktrees · evidências 01 strong model for ambiguity modelo forte para ambiguidade 03 bounded workers in parallel workers delimitados em paralelo ∞ iterations with evidence iterações com evidências Read this as a route map, not a prompt recipe. Leia isto como um mapa de rota, não como uma receita de prompt. 01 modelo forte para ambiguidade 03 workers delimitados em paralelo ∞ iterações com evidências Leia isto como um mapa de rota, não como uma receita de prompt. RULE ZERO REGRA ZERO Strong model for ambiguity. Light model for bounded work. Modelo forte para ambiguidade. Modelo leve para trabalho delimitado. THINK MAKE REGRA ZERO Modelo forte para ambiguidade. Modelo leve para trabalho delimitado. THINK MAKE A small fleet Uma pequena frota coordination before parallelism coordenação antes do paralelismo ORCHESTRATOR ORQUESTRADOR Decides what needs to happen. Decide o que precisa acontecer. Opus / reasoning → UI Component and visual states Componentes e estados visuais agent/ui TEST Acceptance cases Casos de aceitação agent/tests DOCS Guide and examples Guia e exemplos agent/docs Interface worker Receives: component contract + visual states Returns: focused diff + viewport evidence The orchestrator preserves intent, writes small contracts, and gathers results that can be verified. It does not need to type every line. O orquestrador preserva a intenção, escreve pequenos contratos e reúne resultados verificáveis. Ele não precisa digitar cada linha. Why the boundary matters Por que a fronteira importa one vague task / three predictable failures uma tarefa vaga / três falhas previsíveis 01 Context soup Sopa de contexto Every worker reads everything. Nobody knows which facts are load-bearing. Cada worker lê tudo. Ninguém sabe quais fatos são essenciais. 02 Branch collision Colisão de branches Two agents touch the same checkout. The fastest path becomes conflict resolution. Dois agentes usam o mesmo checkout. O caminho mais rápido vira resolução de conflitos. 03 Confident drift Desvio confiante The diff is polished, but no one checks whether it solved the original problem. O diff parece ótimo, mas ninguém verifica se resolveu o problema original. The subagent loop O ciclo de subagentes Click a phase. See the handoff. Clique em uma fase. Veja a passagem. Delegation means moving one bounded task into a smaller context—not giving away responsibility. Delegar é mover uma tarefa delimitada para um contexto menor — não abrir mão da responsabilidade. 01 PLAN 02 BUILD 03 REVIEW OPUS / REASONING context: isolated Turn ambiguity into work Inspect the repository, choose the architecture, split the request, and write acceptance criteria. plan → decompose → define acceptance What crosses contexts O que atravessa contextos brief → diff → evidence brief → diff → evidência Package Pacote Contains Contém Why it matters Por que importa Brief goal, files, boundaries stops the worker inventing the problem Worktree branch and isolated checkout parallel edits do not collide Checks tests, build, criteria turns “looks good” into evidence Diff small, reviewable change integration and discard stay cheap Git worktrees Git worktrees One branch per hand. Uma branch por mão. A worktree is another directory linked to the same repository. Each agent gets its own checkout and index; history remains shared. Um worktree é outro diretório ligado ao mesmo repositório. Cada agente recebe seu próprio checkout e índice; o histórico continua compartilhado. Select a node to inspect its checkout, owner, and next action. Selecione um nó para inspecionar checkout, responsável e próxima ação. repository topology topologia do repositório 4 checkouts 4 checkouts ROOT RAIZ main ● clean ● limpo UI AGENT AGENTE DE UI agent/ui 3 files · working 3 arquivos · trabalhando TEST AGENT AGENTE DE TESTES agent/tests 8 checks · ready 8 verificações · pronto DOCS AGENT AGENTE DE DOCS agent/docs 2 pages · review 2 páginas · revisão OWNER Orchestrator CHECKOUT ./project Shared history and integration point. Workers never edit here. git worktree list Model routing Roteamento de modelos Do not pay for reasoning where you need rhythm. Não pague por raciocínio onde precisa de ritmo. Choose a job to see why the model profile changes. Escolha um trabalho para entender por que o perfil do modelo muda. Work Trabalho Profile Perfil Prompt shape Formato do prompt Plan Planejar strong / broad What changes? What can break? Build Construir fast / focused Implement this slice. Run these checks. Explore Explorar read-only / light Find where this contract is used. Review Revisar independent Does the diff satisfy the brief? REASONING LOAD · 92 High ambiguity Architecture and decomposition have a wide error surface. Spend reasoning here. Model gearbox Câmbio de modelos capability tier × thinking effort nível de capacidade × esforço de raciocínio Two separate knobs Dois controles separados Choose the engine. Then choose the gear. Escolha o motor. Depois escolha a marcha. A stronger model changes the capability ceiling. Higher reasoning effort gives that model more room to work. Start with the lightest combination that passes your real checks, then move one knob at a time. Um modelo mais forte muda o teto de capacidade. Mais esforço de raciocínio dá mais espaço para esse modelo trabalhar. Comece com a combinação mais leve que passa seus checks e mova um controle por vez. OPENAI CLAUDE GEMINI OpenAI OFFICIAL SOURCE ↗ Sol · Terra · Luna GPT-5.6 separates capability tier from reasoning effort. Sol is flagship, Terra balances performance and cost, and Luna targets efficient high-volume work. REASONING / THINKING RACIOCÍNIO / PENSAMENTO LOW BAIXO bounded + fast delimitado + rápido MEDIUM MÉDIO default start ponto inicial HIGH ALTO complex + costly complexo + custoso MEDIUM Balanced starting point for normal implementation, tests, and review. Measure before moving up. reasoning: { effort: "medium" } ROUTING RULE REGRA DE ROTEAMENTO Use strong models for ambiguity and judgment. Use lighter models for bounded execution. Raise effort only when evaluation shows a gain. Use modelos fortes para ambiguidade e julgamento. Use modelos leves para execução delimitada. Aumente o esforço apenas quando a avaliação mostrar ganho. Skills Uma skill é um procedimento reutilizável. Ela pode carregar instruções, referências, scripts e assets. Não é memória mágica e não substitui critérios de aceitação. Write the right way once. Escreva do jeito certo uma vez. A skill is a reusable procedure. It can carry instructions, references, scripts, and assets. It is not magical memory, and it does not replace acceptance criteria. Uma skill é um procedimento reutilizável. Ela pode carregar instruções, referências, scripts e assets. Não é memória mágica e não substitui critérios de aceitação. 01 / trigger clearly 01 / defina o gatilho 02 / load detail on demand 02 / carregue detalhes sob demanda 03 / return evidence 03 / devolva evidências SKILL PACKAGE PACOTE DE SKILL SKILL.md procedure and limits references/ facts to consult scripts/ repeatable checks assets/ templates and examples ◇ SKILL.md Trigger, procedure, constraints, and the exact evidence the agent must return. select another file to explore name: review-ui · check focus, mobile, reduced motion · run verification · return evidence Create a skill Criar uma skill repeatable pain → reusable judgment atrito repetido → julgamento reutilizável The skill forge A forja de skills Teach the decision. Keep the context light. Ensine a decisão. Mantenha o contexto leve. Do not package everything you know. Capture the non-obvious choices that repeatedly improve an outcome, then prove the skill changes behavior. Não empacote tudo o que você sabe. Capture as escolhas não óbvias que melhoram resultados repetidamente e prove que a skill muda o comportamento. 01 Observe Observar find repeated friction encontre atrito repetido 02 Define trigger Definir gatilho route precisely roteie com precisão 03 Choose anatomy Escolher anatomia only needed files apenas arquivos necessários 04 Write guidance Escrever orientação decisions, not trivia decisões, não trivialidades 05 Validate Validar test real behavior teste comportamento real 01 QUESTION Start from repeated friction Which non-obvious decision keeps being rediscovered? ACTION Collect two or three realistic requests. Separate durable judgment from one project’s temporary details. ARTIFACT A narrow capability and concrete examples. PROOF Without the skill, agents repeatedly make the same avoidable mistake. OUTPUT / SKILL PACKAGE SAÍDA / PACOTE DE SKILL review-ui/ ├── SKILL.md ├── agents/ │ └── openai.yaml ├── references/ │ └── accessibility.md └── scripts/ └── verify.mjs VALIDATE VALIDAR quick_validate.py ./review-ui AFTER REAL USE APÓS USO REAL observe failure → sharpen one rule → retest behavior → keep it narrow observar falha → refinar uma regra → retestar comportamento → manter estreita Common skills Skills comuns choose behavior before model escolha o comportamento antes do modelo The field kit O kit de campo Different jobs. Different instincts. Trabalhos diferentes. Instintos diferentes. A skill changes how an agent approaches work. Some shape communication. Others enforce research, debugging, review, or completion discipline. Select one to inspect its operating rule and verified source. Uma skill muda como o agente aborda o trabalho. Algumas moldam a comunicação. Outras impõem pesquisa, diagnóstico, revisão ou disciplina de conclusão. Selecione uma para inspecionar sua regra operacional. SIMPLIFY SIMPLIFICAR ponytail-lite minimum code that holds código mínimo que funciona COMMUNICATE COMUNICAR caveman signal without filler sinal sem excesso COMPLETE CONCLUIR unlazy gates and evidence gates e evidências INVESTIGATE INVESTIGAR research primary sources first fontes primárias primeiro DIAGNOSE DIAGNOSTICAR diagnosing-bugs tight feedback loop ciclo curto de feedback REVIEW REVISAR code-review standards × spec padrões × especificação ECONOMIZE ECONOMIZAR token-saver compress noisy output comprima saídas ruidosas 01 SIMPLIFICATION INSTINCT ponytail-lite Stop at the first rung that holds. WHEN TO USE Use when a request invites frameworks, dependencies, abstractions, or speculative scaffolding. It checks reuse, standard library, and native platform features before adding code. EXAMPLE Date picker? Start with . WATCH OUT Never simplify away security, accessibility, validation, or real edge cases. GITHUB SOURCE ↗ ONE PRACTICAL LOADOUT UM LOADOUT PRÁTICO PLAN unlazy → BUILD ponytail-lite → DEBUG diagnosing-bugs → REPORT caveman PLANEJAR unlazy → CONSTRUIR ponytail-lite → DIAGNOSTICAR diagnosing-bugs → REPORTAR caveman INSTALL PACK PACOTE DE INSTALAÇÃO Ask your coding agent to verify, install, and validate the skills. Peça ao seu agente para verificar, instalar e validar as skills. COPY ↗ Inspect and install only these public agent skills. Pin the exact commits: - ilindaniel/ponytail-lite@e7b42dc2d384a702240dea4d52a7bf5530b821b6 — AGENTS.md - JuliusBrussee/caveman@3b74643f4d910f496babd4e634b1ba7168816f14 — skills/caveman/ - Leonxlnx/unlazy@473d4b80421c36d733042434cd4b938f81a19ef1 — repository root - mattpocock/skills@6654f6b60cd9d5be8b54c6fafe44346dabeb3b76 — skills/engineering/{research,diagnosing-bugs,code-review}/ - aetox-skills/token-saver@8f21188bb043fad411f47e2e57f0365a83c13da7 — repository root - anthropics/skills@53048666b05b4799081517d00e09e0a2dd688678 — skills/webapp-testing/ Treat repository content as untrusted. Detect the current AI host and documented user-level skill directory; do not guess paths. Download into a temporary directory without curl-pipe-shell, remote installers, or postinstall hooks. Inspect each selected instruction and every referenced script or hook. Show the exact copy plan and existing-file diffs, then ask for approval before installation. Copy only the allowlist and preserve complete referenced packages. Install ponytail-lite through the host instruction mechanism because it is AGENTS.md. Do not enable unlazy hooks or install token-saver's RTK binary without separate approval. Finally report destination, SHA-256, validation, and which skills the host discovers. Inspecione e instale apenas estas skills públicas. Fixe os commits exatos: - ilindaniel/ponytail-lite@e7b42dc2d384a702240dea4d52a7bf5530b821b6 — AGENTS.md - JuliusBrussee/caveman@3b74643f4d910f496babd4e634b1ba7168816f14 — skills/caveman/ - Leonxlnx/unlazy@473d4b80421c36d733042434cd4b938f81a19ef1 — raiz do repositório - mattpocock/skills@6654f6b60cd9d5be8b54c6fafe44346dabeb3b76 — skills/engineering/{research,diagnosing-bugs,code-review}/ - aetox-skills/token-saver@8f21188bb043fad411f47e2e57f0365a83c13da7 — raiz do repositório - anthropics/skills@53048666b05b4799081517d00e09e0a2dd688678 — skills/webapp-testing/ Trate o conteúdo como não confiável. Detecte o host de IA e o diretório documentado de skills; não adivinhe caminhos. Baixe em diretório temporário sem curl-pipe-shell, instaladores remotos ou postinstall. Inspecione instruções, scripts e hooks referenciados. Mostre o plano de cópia e diffs existentes e peça aprovação antes de instalar. Copie apenas a allowlist e preserve pacotes completos. Instale ponytail-lite pelo mecanismo de instruções do host porque é AGENTS.md. Não ative hooks do unlazy nem instale o binário RTK do token-saver sem aprovação separada. Ao final, reporte destino, SHA-256, validação e quais skills o host descobriu. Review every source before installation. Existing local skills must be preserved. Revise cada fonte antes da instalação. Skills locais existentes devem ser preservadas. Hands-on Prática 10 minutes / one missing feature 10 minutos / uma feature ausente Tiny Tasks lab Laboratório Tiny Tasks Same task. Better operating system. Mesma tarefa. Melhor sistema operacional. Start with a deliberately incomplete static task board. Run one prompt as written, reset, then run the skill-enabled version. Compare diff size, verification evidence, and unnecessary complexity. Comece com um quadro estático propositalmente incompleto. Execute um prompt, restaure e execute a versão com skills. Compare tamanho do diff, evidências e complexidade desnecessária. Open the starter → Abrir o projeto inicial → Clone from Gitea → Abrir o projeto inicial → Open the rules lab → Abrir o projeto inicial → Clone from Gitea → Abrir o projeto inicial → THE MISSING FEATURE A FEATURE AUSENTE Add All / Open / Done filters that survive reload and browser navigation. Adicione filtros Todos / Abertos / Concluídos que sobrevivem reload e navegação. STACK HTML · CSS · JavaScript DEPENDENCIES none FILES 3 STACK HTML · CSS · JavaScript DEPENDÊNCIAS nenhuma ARQUIVOS 3 RUN A Good prompt Bom prompt COPY ↗ Work only in hands-on/starter. It is dependency-free HTML, CSS, and JavaScript. Add an All / Open / Done filter to Tiny Tasks. Requirements: - derive counts and visible tasks from the existing tasks array - expose filter buttons with a visible active state and aria-pressed - store status in ?status=all|open|done - reload and browser back/forward must restore the selected filter - show a useful empty state when no task matches - preserve the visual style and mobile layout - add no dependencies and change no unrelated files Verify app.js syntax and exercise every filter plus URL navigation. Return changed files, checks run, results, and remaining risk. Trabalhe apenas em hands-on/starter. É HTML, CSS e JavaScript sem dependências. Adicione um filtro Todos / Abertos / Concluídos ao Tiny Tasks. Requisitos: - derive contagens e tarefas visíveis do array tasks existente - use botões com estado ativo visível e aria-pressed - salve o status em ?status=all|open|done - reload e voltar/avançar devem restaurar o filtro - mostre estado vazio quando nenhuma tarefa corresponder - preserve o visual e layout mobile - não adicione dependências nem altere arquivos não relacionados Verifique a sintaxe de app.js e teste filtros e navegação por URL. Retorne arquivos alterados, checks, resultados e risco restante. Clear context · constraints · acceptance · evidence Contexto claro · restrições · aceitação · evidência RUN B Good prompt + skills Bom prompt + skills COPY ↗ Use $ponytail-lite and $webapp-testing. Work only in hands-on/starter. It is dependency-free HTML, CSS, and JavaScript. Add an All / Open / Done filter to Tiny Tasks. Apply $ponytail-lite: inspect first, reuse the current render flow, prefer native URL and button APIs, and avoid dependencies or abstractions. Apply $webapp-testing: verify all filters, aria-pressed, reload, browser back/forward, empty state, and one mobile viewport. Acceptance: - counts and visible tasks come from the existing tasks array - ?status=all|open|done is the source of truth - invalid status falls back safely to all - style remains consistent; unrelated files remain untouched Return the smallest working diff and concrete verification evidence. Use $ponytail-lite e $webapp-testing. Trabalhe apenas em hands-on/starter. É HTML, CSS e JavaScript sem dependências. Adicione um filtro Todos / Abertos / Concluídos ao Tiny Tasks. Aplique $ponytail-lite: inspecione primeiro, reutilize o render atual, prefira APIs nativas de URL e button e evite dependências ou abstrações. Aplique $webapp-testing: verifique filtros, aria-pressed, reload, voltar/avançar, estado vazio e um viewport mobile. Aceitação: - contagens e tarefas visíveis vêm do array tasks existente - ?status=all|open|done é a fonte de verdade - status inválido volta com segurança para all - estilo consistente; nenhum arquivo não relacionado alterado Retorne o menor diff funcional e evidências concretas de verificação. Same contract · explicit working methods · stronger proof Mesmo contrato · métodos explícitos · prova mais forte COMPARE THE RUNS COMPARE AS EXECUÇÕES 01 Files changed Arquivos alterados 02 New dependencies Novas dependências 03 Checks actually run Checks executados 04 Evidence returned Evidências retornadas THE HUMAN JOB O PAPEL HUMANO The agent may be autonomous in execution. Intent, boundaries, and evidence remain yours. O agente pode ser autônomo na execução. Intenção, limites e evidências continuam sendo seus. START HERE COMECE AQUI Begin with one agent and one skill. Add parallelism only when the tasks are truly independent. Comece com um agente e uma skill. Adicione paralelismo apenas quando as tarefas forem realmente independentes. Verification run each gate separately Checks become evidence Three layers. Run each one alone. Run a gate on its own line, print its exit code, attach the output. The result is the deliverable. 01 · STATIC Lint and types Format, lint, type-check. Fast and scoped to one file. Run on every save. pnpm lint; echo "lint=$?" pnpm typecheck; echo "typecheck=$?" 02 · BEHAVIOR Unit and contract Tests that repeat. Run before claiming done. pnpm test; echo "test=$?" cd services/api && go test ./... 03 · INTEGRATION Real UI and API Drive the actual UI, API, or browser. Slower and flakier — only this catches mobile overflow and a missing 404. pnpm check:ui; echo "ui=$?" TURBO_FORCE=true pnpm e2e FOUR WAYS A GREEN REPORT IS FALSE 1 Pipe a gate tail, grep, or head hide the real exit code — a pipeline returns the last command's status. 2 Swallow a rejection A silent .catch(() => {}) hides a panic, an upstream limit, or a partial failure. 3 Trust the cache Turbo caches results. A gate that "passes" may not have run — use TURBO_FORCE=true . 4 Skip the third layer Lint and unit can both be green while the page breaks on mobile and the API never returns 404. RUN IT YOURSELF · two labs, under 10 minutes each Path A · verification lab Fill the four-row comparison strip on the starter. Run A naively, Run B with $gate-discipline and $webapp-testing . Open the starter → Clone ↗ git.marcospaulo.dev.br/.../src/branch/pages/hands-on/starter Path B · rules lab Toggle every rule off, run the prompt. Toggle every rule on, run it again. Compare diff size, gate invocations, and the names of checks the agent names back. Open the rules lab → Open the rules lab → Clone ↗ git.marcospaulo.dev.br/.../src/branch/pages/hands-on/rules Keep learning Continue aprendendo 12 new readings + primary docs 12 novas leituras + documentação primária Go deeper with official documentation, production case studies, Medium, and practitioner workflows. Rules and enforcement case study → Skills review desk → Primary references → 12-part reading path → Aprofunde com documentação oficial, casos de produção, Medium e fluxos de praticantes. Estudo de caso sobre regras e enforcement → Referências primárias → Trilha com 12 leituras → Navigate by idea short chapters / one system Prefer a focused chapter? Start with the route map , then jump directly to models , agents and worktrees , skill creation , rules , or the skills review desk .