Pular para o conteúdo
03 · Adoção

Engenharia de Software com Claude Code em 4 Semanas

Um arquiteto da Base/labs dedicado por 4 semanas leva seu time a desenvolver software com IA, com método. Você sai com o primeiro harness e um tutorial.

4 semanas em período integral, ou diluídas em até 12 semanas · 1 arquiteto Base/labs dedicado · 1 time do cliente de até 10 pessoas

  • CLAUDE.md contexto do projeto S1
  • .claude/skills/ procedimentos do time S2
  • .claude/agents/ subagentes de revisão S2
  • .claude/settings.json permissões e hooks S1
  • docs/specs/<feature>/spec.md documento 1 S1
  • docs/specs/<feature>/plano.md documento 2 S2
  • docs/specs/<feature>/tarefas.md documento 3 S2
  • docs/harness-tutorial.md tutorial de uso S4
Exemplo do que fica versionado no seu repositório
semanas
4
arquiteto dedicado
1
pessoas no time
até 10
portões de revisão
4
Claude Partner Network — Certified Services Partner

Base/labs is Certified in the Claude Partner Network. A Base/labs é Certified no Claude Partner Network. Nosso time é certificado em Claude.

Para quem

Empresas com times de engenharia de software que querem usar o Claude Code como método de trabalho, e não só como um autocomplete mais esperto, começando por um time de até 10 pessoas. O objetivo é entregar mudanças reais com mais velocidade, sem perder controle de qualidade e segurança. O harness é o conjunto de instruções, regras e verificações que orienta o agente de IA no código da sua empresa.

O problema que resolve

Claude Code sem método vira "vibe coding": um pedido vago, o modelo adivinha os requisitos que ninguém disse, e o resultado é escopo que cresce no meio da tarefa, implementação pela metade e código que não segue os padrões do projeto. Quanto maior a mudança, maior o estrago. A resposta não é um prompt melhor, e sim processo e ambiente: primeiro se decide o que construir, depois como, e só então se escreve código, dentro de um harness que limita e verifica o que o agente faz.

Quem conduz o trabalho

Um arquiteto sênior da Base/labs, definido na proposta, fica dedicado ao seu time durante todo o período. Em caso de ausência prolongada, um substituto de mesmo nível assume, com handover.

Sem método

  • Pedido vago, e o modelo adivinha o que ninguém disse
  • O escopo cresce no meio da tarefa
  • Implementação pela metade
  • Código fora dos padrões do projeto

Com spec, plano e tarefas

  • A spec aprovada define o que construir
  • O plano aprovado define em quais passos
  • Cada tarefa nasce com o teste que a valida
  • Um revisor independente confere contra a spec
Método

O processo spec-driven, na prática

Em vez de um prompt solto, cada mudança passa por três documentos (spec, plano e lista de tarefas) e quatro portões de revisão: aprovação da spec, aprovação do plano, revisão de cada tarefa e revisão final antes do merge. Os documentos são arquivos no repositório: sobrevivem entre sessões, entram no pull request e podem ser lidos por qualquer pessoa do time.

1. Spec: o quê e por quê

Documento 1. O agente conduz perguntas de design (formato, fontes de dados, casos de borda, o que fica fora do escopo) e escreve a especificação. Portão 1: uma pessoa do time revisa e aprova a spec antes de existir qualquer plano.

2. Plano: em quais passos

Documento 2. A partir da spec aprovada, o plano define o que é "pronto" e quais arquivos mudam. Portão 2: a revisão humana aprova o plano antes de qualquer código.

3. Tarefas e código: uma de cada vez

Documento 3: a lista ordenada de tarefas, cada uma com o teste que a valida. Para cada tarefa: um teste que falha, o código que o faz passar, refatoração e, no portão 3, a revisão de um subagente que lê a mudança sem o contexto de quem a escreveu. Se uma tarefa contradiz a spec, o trabalho para e volta para a spec.

4. Revisão final: contra a spec

Portão 4: um revisor independente confere o conjunto da mudança com a spec e o plano antes do merge, e uma pessoa aprova.

Harness

O harness: o ambiente que controla o agente

A qualidade do que o agente entrega depende do ambiente em que ele trabalha, não só do modelo. Harness engineering é projetar esse ambiente. O entregável mais importante das 4 semanas é a primeira versão do harness da sua empresa, com um tutorial curto de como usá-lo. O arquiteto a constrói junto com o time piloto, e ela fica no repositório.

ContextoMemóriaSkillsFerramentasRestriçõesVerificaçãoAgentede código

Contexto

O que o agente precisa saber do projeto: arquitetura, padrões de código, comandos de build e teste e decisões já tomadas, em um CLAUDE.md enxuto.

Memória

O que precisa sobreviver entre sessões: specs, planos e convenções versionados no repositório, em vez de depender do histórico de uma conversa.

Skills

Procedimentos repetíveis do time (abrir uma spec, revisar um PR, gerar um relatório), com passos determinísticos onde o resultado não pode variar.

Ferramentas

O que o agente pode usar: servidores MCP aprovados, integração com o CI, o rastreador de tarefas e o repositório, cada um com permissões mínimas.

Restrições

Guardrails e política de permissões que definem o que o agente não faz, com hooks para as regras que não admitem exceção e limites claros de autonomia.

Verificação

Testes, checagens automáticas e revisão independente que provam que a mudança faz o que a spec pede antes de chegar ao merge.

O que entregamos

O que entregamos

Entregável principal

A primeira versão do harness da sua empresa, no repositório: CLAUDE.md, skills, hooks, permissões e templates de spec, plano e tarefas. É o entregável mais importante do trabalho.

Um tutorial curto de como usar o harness no dia a dia, para o time e para quem entrar depois.

Um arquiteto da Base/labs dedicado ao trabalho durante todo o período, conduzindo-o na prática.

Um relatório antes/depois, com cycle time, tempo de revisão e retrabalho medidos no histórico do Git. Quatro semanas é um período curto para conclusões estatísticas, e o relatório diz isso.

Em uso real ao final das 4 semanas: tarefa e spec, implementação (feature, correção e hotfix), revisão de PR, o CI/CD que o time já tem, validação de QA e detecção de bugs, vulnerabilidades e problemas de performance com apoio de IA.

Introduzidos e demonstrados, para o time evoluir depois: agentes de longa duração, integrações via MCP e monitoramento.

Como funciona

Como funciona

01

Antes de começar (fora das 4 semanas)

Poucos dias de preparação antes do início, com a liderança de engenharia, segurança, identidade e rede e o dono do repositório. Fechamos as decisões que precisam existir antes de qualquer pessoa instalar a ferramenta, escolhemos o time (até 10 pessoas, incluindo QA, PO e tech lead que participem), o repositório e as features reais, e capturamos a linha de base no histórico do Git. As 4 semanas começam com tudo pronto.

02

Semana 1: harness v1 e primeira spec

O arquiteto faz um diagnóstico do repositório e monta a primeira versão do harness. O time termina a semana com a spec aprovada de uma feature real, escrita com o agente.

03

Semana 2: da spec ao PR

Plano e tarefas com testes, implementação com TDD, skills com passos determinísticos e revisão por subagente, em pair com o arquiteto. Feature, correção e hotfix passam pelo fluxo normal de pull request, e as primeiras mudanças chegam ao merge. O harness é ajustado a cada aprendizado.

04

Semana 3: do PR à produção

Em uso real: o CI/CD do time, a validação de QA, a detecção de bugs, vulnerabilidades e performance nos PRs do piloto e um segundo ciclo de mudanças maiores, que tocam vários arquivos. Introduzidos e demonstrados: agentes de longa duração, integrações via MCP e monitoramento. Começamos a escrever o tutorial a partir do uso real.

05

Semana 4: autonomia e handover

O time roda o ciclo completo sozinho e o arquiteto só revisa. Definimos juntos os limites de autonomia dos agentes. Seu time assume o harness e recebe o tutorial final e o relatório antes/depois.

FAQ

Perguntas frequentes

O trabalho

Como funciona a dedicação do arquiteto?

Um arquiteto da Base/labs fica dedicado ao seu time. O formato de referência é de 4 semanas em período integral. As 4 semanas também podem ser diluídas em até 12 semanas: a dedicação do arquiteto é proporcional, e cada etapa do cronograma se estica na mesma proporção. Combinamos isso ao desenhar a proposta.

O que é o harness?

É o ambiente que cerca o agente de código: contexto do projeto, memória entre sessões, skills, ferramentas, restrições e verificação. Em vez de depender de um prompt perfeito, o time projeta esse ambiente uma vez e o reaproveita em toda tarefa. A primeira versão do harness da sua empresa, com um tutorial curto de uso, é o principal entregável do trabalho.

Por que um único time de até 10 pessoas?

Porque um arquiteto dedicado consegue acompanhar de perto um time desse tamanho, em trabalho real, durante as 4 semanas. O harness que sobra serve de base para levar o processo a outros times depois.

Quem conta nas 10 pessoas?

Todos que participam do trabalho no dia a dia: desenvolvedores, QA, PO e tech lead.

Isso é só treinamento?

Não. É um trabalho de engenharia: o time entrega mudanças reais do seu backlog, pelo fluxo normal de pull request, com o arquiteto ao lado.

Qual a diferença para o modo de planejamento do Claude Code?

O modo de planejamento gera um plano dentro da própria sessão. No processo spec-driven, spec e plano são arquivos no repositório, revisados por pessoas e reaproveitados entre sessões e entre times.

Vocês usam Spec Kit, Superpowers ou BMAD?

Escolhemos o fluxo pelo seu contexto. Frameworks abertos como esses ajudam a estruturar o processo, e o que importa é que spec e plano fiquem no repositório e passem por revisão. Para mudanças pequenas, como um ajuste de estilo, o processo completo é exagero, e ensinamos o time a distinguir.

Comercial

As licenças do Claude estão incluídas? Quem paga o consumo?

Não. As licenças e o consumo de tokens ficam com a sua empresa, contratados direto com a Anthropic ou pelo marketplace da sua nuvem. O plano necessário e a estimativa de consumo são definidos junto, no começo do trabalho.

Existe critério de aceite ou garantia? E se a feature escolhida não ficar pronta?

Não prometemos resultado de produtividade. O aceite é pela entrega dos itens combinados: o harness, o tutorial e o relatório antes/depois. Se a feature do piloto não couber nas 4 semanas, ajustamos o escopo dela, e isso não impede o aceite.

Esforço e logística

Quanto do tempo do meu time fica comprometido? O time para as outras entregas?

O time segue com as suas entregas. As features do piloto saem do backlog atual, então não são trabalho extra. O tempo adicional é o do pair com o arquiteto e o das revisões.

O trabalho é remoto ou presencial?

Remoto por padrão. Se fizer sentido, o presencial pode ser combinado na proposta.

Quanto tempo entre a assinatura e o início?

A combinar na proposta, porque depende dos acessos e das decisões iniciais de plataforma, segurança, identidade e rede, que fazem parte da preparação antes das 4 semanas.

Técnico

Funciona com a minha stack, com monorepo ou com sistema legado?

O Claude Code trabalha sobre repositórios Git, a partir do terminal, e o método não depende de uma linguagem específica. Monorepos e as plataformas de repositório e de CI do seu time são avaliados na preparação. Para sistemas legados que precisam ser migrados, veja a oferta de modernização.

E se o repositório tiver pouca cobertura de testes?

O diagnóstico mede a cobertura. Onde ela é baixa, os testes que protegem o comportamento atual são escritos antes da mudança, e escolhemos o escopo do piloto para caber nas 4 semanas. Se o repositório pedir um trabalho muito maior que isso, indicamos a oferta de modernização.

Por que Claude Code, e o time pode continuar usando outras ferramentas?

A oferta é construída sobre o Claude Code. O método (spec, plano, tarefas e revisão) e o harness ficam no repositório, e o seu time pode continuar usando outras ferramentas no dia a dia.

Quem mantém o harness quando o Claude Code mudar?

O seu time, que recebe o harness e o tutorial no handover. Se quiser apoio nos ajustes, a empresa pode contratar mais horas do arquiteto.

Segurança e jurídico

Meu código é usado para treinar o modelo? E a LGPD?

Segundo as políticas públicas da Anthropic, entradas e saídas de produtos comerciais (como Claude Enterprise, a API e o Claude Code sob termos comerciais) não são usadas para treinar os modelos por padrão, a menos que o cliente opte por isso. O que vale para a sua empresa são os termos que você contratar, e a rota de acesso ao modelo (Claude Enterprise, Console ou uma nuvem como Bedrock, Google Cloud ou Foundry) é decidida na preparação. A avaliação de LGPD é feita com o seu time jurídico e de privacidade nessa mesma etapa.

Que acesso o arquiteto precisa? Vocês assinam NDA?

Acesso mínimo ao repositório e ao CI do time piloto, sem acesso a produção, conforme a política do seu time de segurança. A Base/labs assina NDA antes do início.

De quem é a propriedade do harness, das skills e dos templates?

Da sua empresa. Tudo o que é produzido no trabalho fica versionado no seu repositório.

Como impedimos que o agente faça algo destrutivo?

A política de permissões define o que o agente pode acessar e executar. Arquivos sensíveis e comandos destrutivos entram em uma lista de bloqueio, e as regras que não admitem exceção viram hooks, verificações automáticas, em vez de um pedido no prompt. Toda mudança passa por pull request com revisão humana.

Resultados

Qual ganho de produtividade posso esperar?

Não prometemos um número. Medimos o antes e o depois no histórico do Git (cycle time, tempo de revisão e retrabalho) e entregamos um relatório. Quatro semanas é um período curto para conclusões estatísticas, e o relatório deixa isso claro.

Depois do projeto

Como levo o processo para outros times?

O harness e o tutorial ficam com o seu time e servem de base para os demais. Para acompanhar essa expansão, a empresa pode contratar mais horas do arquiteto ou conversar sobre o Squad Claude Certificado.

Posso contratar mais horas do arquiteto depois da conclusão?

Sim. Não há suporte incluído depois do handover, mas a empresa pode contratar mais horas do arquiteto, avulsas, para acompanhamento, por exemplo para revisar o harness, tirar dúvidas ou apoiar a chegada de outros times.

Ofertas relacionadas

Quer conversar sobre esta oferta?

Começamos por uma conversa para entender o seu escopo. Cada oferta tem escopo e preço fechados por fase.