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.
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.mdcontexto do projeto S1 -
.claude/skills/procedimentos do time S2 -
.claude/agents/subagentes de revisão S2 -
.claude/settings.jsonpermissões e hooks S1 -
docs/specs/<feature>/spec.mddocumento 1 S1 -
docs/specs/<feature>/plano.mddocumento 2 S2 -
docs/specs/<feature>/tarefas.mddocumento 3 S2 -
docs/harness-tutorial.mdtutorial de uso S4
- semanas
- 4
- arquiteto dedicado
- 1
- pessoas no time
- até 10
- portões de revisão
- 4
Base/labs is Certified in the Claude Partner Network. A Base/labs é Certified no Claude Partner Network. Nosso time é certificado em Claude.
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.
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.
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
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.
Para cada tarefa
- Teste que falha
- Código que passa
- Refatoração
- Revisão por subagente
Contradição com a spec? O trabalho volta para a spec.
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.
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.
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
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
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.
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.
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.
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.
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.
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.
Veja também: Claude: Governança e Custo
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.
Veja também: Modernização de Legado com Claude Code
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.
Veja também: Modernização de Legado com Claude Code
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.
Veja também: 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.
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.
