# MarceloCastelo.IO

> Arquitetura de software e engenharia enterprise por Marcelo Castelo Branco. Clareza antes da técnica: entender o contexto e o porquê antes de escrever código.

Este arquivo é para agentes de IA (AI agents) e modelos de linguagem (LLMs) que leem este site para alguém. O site é de Marcelo Castelo Branco, e todo o texto do site está em português do Brasil.

O site publica o livro aberto e gratuito *Antes do Código*, escrito em público. Cada página publicada do livro tem uma versão em Markdown com o texto inteiro da página, sem o menu e sem o rodapé do site. Os links das seções do livro, abaixo, levam direto para essa versão em Markdown. Cada arquivo Markdown começa pelo título da página e traz o endereço da página no site, que é o endereço para citar.

## Antes do Código

- [Índice do livro Antes do Código](https://marcelocastelo.io/livros/antes-do-codigo): O guia para quem quer entender a tecnologia — e não só usá-la. Livro aberto e gratuito de Marcelo Castelo Branco, escrito em público.

## Antes do Código, seção 1: Fundamentos da mentalidade e do aprendizado

- [Abertura: Por que a pressa e o aprendizado andam em direções opostas](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/secao-1-abertura.md): O que essa seção veio resolver, e por que ela vem antes de qualquer linguagem
- [Capítulo 1.1: A casa dos sonhos](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-1.md): Por que empolgação sozinha não termina uma obra
- [Capítulo 1.2: O Pedro e a importância da prática](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-2.md): O que separa quem assiste de quem sabe fazer
- [Capítulo 1.3: A bicicleta e o contexto](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-3.md): Por que a mesma resposta pode estar certa e errada
- [Capítulo 1.4: O que é simples de verdade](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-4.md): Simples não é fácil, e confundir os dois custa caro
- [Capítulo 1.5: A corrida, o ritmo e a consistência](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-5.md): Por que quem acelera no começo quase nunca termina
- [Capítulo 1.6: O tutorial e a ilusão de progresso](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-6.md): A diferença entre acompanhar e aprender
- [Capítulo 1.7: Como medir a evolução invisível](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-7.md): O que fazer quando o progresso não aparece
- [Capítulo 1.8: O artesão e o peso da mudança](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-1-8.md): Por que trocar de ferramenta dói, e quando vale

## Antes do Código, seção 2: Mercado, valor e direcionamento de carreira

- [Abertura: Por que o mercado não paga pelo que você sabe](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/secao-2-abertura.md): O que essa seção veio resolver, e por que ela vem antes do primeiro currículo
- [Capítulo 2.1: O motoboy e o valor gerado](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-1.md): Por que estudar mais, sozinho, não aumenta o seu salário
- [Capítulo 2.2: A construção civil e a carreira em tecnologia](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-2.md): Por que ninguém começa projetando arranha-céu
- [Capítulo 2.3: Como a tecnologia é escolhida nas empresas](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-3.md): A resposta quase nunca é a linguagem que você prefere
- [Capítulo 2.4: Como as vagas são montadas](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-4.md): O que a empresa está comprando quando abre uma vaga
- [Capítulo 2.5: A loja de roupas e o tipo de empresa](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-5.md): Trabalhar numa garagem e numa multinacional pede coisas diferentes
- [Capítulo 2.6: O chef e o prato das decisões](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-6.md): Escolher o que dá para fazer hoje, com o que você tem
- [Capítulo 2.7: O hospital e o valor do contexto](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-7.md): Quando enxergar o todo vale mais que dominar uma parte
- [Capítulo 2.8: O engenheiro e o pedreiro](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-8.md): Por que quem sabe mais nem sempre é quem faz mais falta
- [Capítulo 2.9: O mecânico que parou de ouvir o motor](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-9.md): O que se perde ao trocar a mão na massa pela decisão
- [Capítulo 2.10: O engenheiro da ponte e o prefeito](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-2-10.md): Estar tecnicamente certo não é o mesmo que resolver

## Antes do Código, seção 3: Crescimento pessoal e maturidade profissional

- [Abertura: Por que o que trava a carreira quase nunca é técnico](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/secao-3-abertura.md): O que essa seção veio resolver, e por que ela vem antes da próxima promoção
- [Capítulo 3.1: O pedreiro e o muro torto](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-1.md): O que acontece quando a culpa sobra para quem não errou
- [Capítulo 3.2: O marceneiro e o cliente que ousou opinar](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-2.md): Vinte anos de prática não garantem que você ouviu o pedido
- [Capítulo 3.3: O escultor e a primeira estátua](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-3.md): O erro que vira apelido, e o que faz ele passar
- [Capítulo 3.4: O mestre e o martelo](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-4.md): Quando o time fica em silêncio na sua chegada
- [Capítulo 3.5: O funcionário revoltado e o patrão que ele se tornou](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-5.md): Como é fácil julgar a cadeira em que você nunca sentou
- [Capítulo 3.6: O ferreiro e o ajudante](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-3-6.md): Guardar o que você sabe protege o lugar de hoje e fecha o de amanhã

## Antes do Código, seção 4: Comunicação, relacionamento e reputação

- [Abertura: Por que ser bom não basta se ninguém consegue contar com você](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/secao-4-abertura.md): O que essa seção veio resolver, e por que ela começa por quem depende do seu trabalho
- [Capítulo 4.1: A hamburgueria e o papel do líder](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-1.md): O que quem te lidera precisa receber de você, e o que você ganha em troca
- [Capítulo 4.2: A hamburgueria e o valor de mostrar resultados](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-2.md): Contar o quanto você se esforçou não é o mesmo que mostrar o que mudou
- [Capítulo 4.3: O padeiro e o valor da previsibilidade](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-3.md): O cliente não compra o pão, compra a certeza de que ele vai estar pronto
- [Capítulo 4.4: O garçom e a arte de falar com dois mundos](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-4.md): Uma língua com o cliente, outra com a cozinha, e nenhum pedido errado
- [Capítulo 4.5: O carpinteiro e o valor de ser corrigido](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-5.md): Por que “é só um centímetro” faz a gaveta emperrar
- [Capítulo 4.6: O padeiro e o ajudante que aprendeu a pensar](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-6.md): A diferença entre levar um problema e levar o problema já pensado
- [Capítulo 4.7: O jantar e o valor da confiança](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-7.md): Ninguém confia em quem não conhece, e isso vale dentro de um time
- [Capítulo 4.8: O jardim dos pequenos reconhecimentos](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-8.md): Reputação se constrói cuidando bem do pedaço que está na sua mão hoje
- [Capítulo 4.9: A fornada queimada e o elogio sincero](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-9.md): Quando todo elogio parece bajulação e toda correção parece ataque
- [Capítulo 4.10: O marceneiro e o armário que ficou](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-4-10.md): O seu nome continua onde o seu trabalho ficou

## Antes do Código, seção 5: Trabalho em equipe e cultura profissional

- [Abertura: Por que um time de gente boa pode entregar um trabalho ruim](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/secao-5-abertura.md): O que essa seção veio resolver, e por que ela vem depois de você aprender a conversar com uma pessoa de cada vez
- [Capítulo 5.1: O músico que tocava sem ouvir o maestro](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-1.md): Saber a sua parte de cor não é o mesmo que tocar com os outros
- [Capítulo 5.2: A linha de montagem e o parafuso que falta](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-2.md): A sua entrega só termina quando para de dar trabalho a quem vem depois
- [Capítulo 5.3: O barco e o remo que parou](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-3.md): Quando um remador cansa e não avisa, o barco inteiro sai do rumo
- [Capítulo 5.4: A cozinha e o garçom](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-4.md): O cliente não enxerga a cozinha nem o salão, enxerga o prato que chegou frio
- [Capítulo 5.5: A concessionária e o confronto de ideias](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-5.md): Uma ideia boa, dita do jeito errado, morre antes de ser ouvida
- [Capítulo 5.6: O valor de ser ouvido](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-6.md): Quem fala e não é ouvido aprende a ficar calado
- [Capítulo 5.7: O plantão sem chefe](https://marcelocastelo.io/assets/livros/antes-do-codigo/markdown/capitulo-5-7.md): Quando falta direção, alguém precisa organizar, mesmo sem ter o cargo

## Páginas do site

- [MarceloCastelo.IO — Arquitetura de software e engenharia enterprise](https://marcelocastelo.io/): Arquitetura de software e engenharia enterprise por Marcelo Castelo Branco. Clareza antes da técnica: entender o contexto e o porquê antes de escrever código.
- [Sobre — Marcelo Castelo Branco](https://marcelocastelo.io/sobre): Eu trabalho com software desde 2009 e ensino há mais de dez anos. Aqui eu escrevo um livro aberto, faço vídeos e cuido de uma comunidade, tudo de graça.
- [Comunidade](https://marcelocastelo.io/comunidade): A comunidade da MarceloCastelo.IO é um servidor aberto e gratuito no Discord, para aprender junto e sem julgamento, com quem está começando e quem já tem anos de profissão no mesmo lugar.
- [IA, e agora? — A IA vai matar a profissão de programador?](https://marcelocastelo.io/ia-e-agora): Não. Mas ela destruiu a porta de entrada, e quase ninguém está te contando isso com clareza. O que mudou de verdade, por que mudou, e qual caminho funciona agora — sem hype e sem pânico.
- [Livros](https://marcelocastelo.io/livros): Os livros publicados aqui, abertos e de graça, escritos em público.
- [Manifesto — Antes do código, vem a consciência](https://marcelocastelo.io/manifesto): Aprender tecnologia não é decorar frameworks nem colecionar certificados. É entender o que está por trás de cada escolha, pensar criticamente e agir com propósito.
- [Mentorias](https://marcelocastelo.io/mentorias): Hoje eu não tenho turma aberta nem agenda de mentoria. Se você quer aprender comigo, deixe o seu nome e o seu e-mail, e eu aviso quando abrir.
- [Como este site é feito](https://marcelocastelo.io/transparencia): Este site é escrito e programado com IA. Não vou esconder isso atrás de aviso em letra miúda — vou mostrar exatamente como funciona, com casos reais desta construção.
- [Treinamentos](https://marcelocastelo.io/treinamentos): Os treinamentos da MarceloCastelo.IO estão sendo preparados, e ainda não têm data nem tema anunciado. Deixe o seu nome e o seu e-mail para ser avisado quando o primeiro abrir.

## Optional

- [Privacidade](https://marcelocastelo.io/privacidade): Você lê este site inteiro sem cadastro, e quem só lê o site não recebe cookie nenhum. Esta página explica o que o site registra, o que a lista de interesse guarda e o que a área de ensino guarda de quem entra.
- [Termos de uso](https://marcelocastelo.io/termos): Este site é aberto e de graça. Esta página explica o que você pode fazer com o conteúdo do site, e o que o conteúdo do site não promete.
- [Termos de uso da área de ensino](https://marcelocastelo.io/termos/area): Os termos que você aceita ao criar a conta na área de ensino da MarceloCastelo.IO, com todas as versões.
- [Termos de uso da área de ensino, versão de 17 de outubro de 2026](https://marcelocastelo.io/termos/area/2026-10-17): O texto exato da versão de 17 de outubro de 2026 dos termos de uso da área de ensino.