> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Como operar uma agência de software de IA com BMAD, Claude Code e Cursor

Um playbook prático para agências que entregam SaaS de clientes com agentes de IA: ciclos de planejamento BMAD, implementação com Claude Code e Cursor, e uma licença que cobre projetos comerciais ilimitados para clientes.

_Publicado 2026-11-03._
_Atualizado em 2026-11-08._

> **Como as agências de software de IA entregam o trabalho do cliente mais rápido?**
> Depende de quanto do stack já está resolvido. Agências de IA lucrativas combinam um ciclo de planejamento como BMAD (agentes Analyst, PM, Architect e QA que decompõem o brief em histórias) com agentes de implementação como Claude Code e Cursor, dentro de um repositório que já cuida de auth, billing, multi-tenant e testes. Uma licença supastack cobre projetos comerciais ilimitados para clientes — uma compra financia cada projeto, de MVPs web em um repo de plataforma única a builds de iOS, Android e desktop no monorepo unificado.

## O modelo de agência de IA: vender resultados, não horas

Agências tradicionais cobram horas; agências de IA cobram por entregável. Quando um agente de planejamento decompõe o brief de um cliente durante a noite e um agente de implementação entrega diffs testados pela manhã, a economia unitária se inverte: MVPs a preço fixo viram produtos de alta margem.

A pegadinha está nos fundamentos. Agentes só são rápidos quando o repositório já responde os 80% entediantes — auth, organizações, webhooks de billing, e-mail, jobs em segundo plano, testes. Começar cada projeto de cliente a partir de um repo vazio queima a vantagem de velocidade reconstruindo encanamento que o cliente nunca pagará.


## Um pipeline BMAD + Claude Code que realmente entrega

Fluxos de trabalho no estilo BMAD funcionam como um revezamento de agentes especializados: o Analyst transforma uma call de cliente em requisitos, o PM escreve o PRD, o Architect o mapeia no codebase existente, o Dev (Claude Code ou Cursor) implementa história por história e o QA executa as verificações de aceitação. Cada passagem é um artefato markdown que o próximo agente lê — nenhum contexto vive apenas numa janela de chat.

É aqui que os guardrails do repositório decidem o sucesso. `AGENTS.md` diz a cada agente onde moram auth, billing e propriedade de dados; os documentos de arquivos `.ai/` registram por que as decisões foram tomadas; as Agent Skills fornecem procedimentos repetíveis. Sem eles, o agente Architect projeta contra um codebase que não vê e o agente Dev escreve código que viola limites nunca declarados.

A etapa de verificação é inegociável no trabalho de cliente. Um portão de testes local determinístico sem credenciais reais — `pnpm verify:local` contra provedores fake — permite ao agente QA provar que webhooks de pagamento, sessões de auth e permissões de workspace ainda passam antes de o diff chegar à sua revisão, muito menos ao cliente.


## Feito para agências de IA e fluxos de trabalho agênticos (BMAD, Claude Code, Cursor)

Uma parcela crescente dos compradores do supastack opera agências de software de IA com ele. Agentes de planejamento no estilo BMAD (Analyst, PM, Architect, QA) transformam o brief de um cliente em histórias delimitadas; Claude Code e Cursor as implementam em um repositório que já responde auth, billing, multi-tenant e testes; `AGENTS.md`, documentos `.ai/` e Agent Skills mantêm cada agente nos padrões existentes.

Seja entregando um MVP web em cinco minutos a partir de um repo de plataforma única, ou builds de iOS, Android e desktop a partir do monorepo unificado, uma licença permite construir projetos comerciais ilimitados para clientes — sem taxa por projeto, um seat por desenvolvedor com acesso ao repositório.

- Repos de plataforma única para entregas rápidas só web; o monorepo unificado para projetos de iOS, Android e Desktop
- AGENTS.md, documentação de arquivos em .ai/ e Agent Skills que mantêm os agentes BMAD, Claude Code e Cursor dentro da arquitetura
- Um portão de testes local sem credenciais que captura regressões dos agentes antes que o cliente as veja
- Uma licença, projetos de cliente ilimitados — compre em nome de um cliente e fique com a margem em cada projeto


## O playbook de projetos: dois caminhos de entrega

Retainers de MVP web: clone o repo de plataforma única para a superfície que o cliente precisa — Next.js ou TanStack Start —, rode o passe de planejamento BMAD sobre o brief e deixe os agentes entregarem auth, billing e a primeira feature em dias. Cinco minutos de scaffolding, o resto é trabalho específico do cliente.

Builds multiplataforma: para clientes que compram iOS + Android + Desktop junto com web, trabalhe no monorepo unificado. Pacotes compartilhados fazem o agente escrever uma regra de billing ou uma checagem de permissão uma vez e cada app cliente a herdar — os entregáveis de mobile e desktop custam dias, não um segundo time.

- Cobre preço fixo: sua margem são os 80% pré-construídos do repo, não horas faturáveis.
- Uma licença, projetos ilimitados: compre uma vez, reutilize em cada projeto de cliente.
- Entregue limpo: clientes recebem um repo testado com docs que seus próprios agentes conseguem ler, não um despejo de caixa-preta.


## Perguntas frequentes sobre operar uma agência de software de IA

O que fundadores de agências perguntam antes de construir sobre o supastack:

- Uma licença cobre mesmo todos os clientes?: Sim — a licença permite produtos finais comerciais ilimitados para você, sua empresa ou seus clientes. Você não pode revender ou redistribuir o código-fonte do kit, e cada desenvolvedor com acesso ao repositório tem seu próprio seat.
- Quais agentes o repo suporta de fábrica?: Claude Code, Cursor, Windsurf, Copilot, Devin e qualquer agente que leia markdown — `AGENTS.md`, `CLAUDE.md` e os docs `.ai/` são agnósticos de ferramenta, e planos multiagente no estilo BMAD se encaixam por cima.
- Como manter a qualidade alta quando os agentes escrevem a maior parte do código?: Coloque cada história atrás da suíte de testes determinística do repo e exija que o agente a execute antes da sua revisão; 144 arquivos de teste capturam regressões de auth, billing e tenancy automaticamente.