A missão
Produza um plano de implementação que respeite o repositório já à sua frente.
Planeja arquitetura, estrutura do repositório, etapas de entrega, infraestrutura, testes e preparação para implantação.
O Agente Técnico registra arquitetura, responsabilidades, fluxos de dados, alternativas, testes, observabilidade, migrações, implantação e reversão. Ele prioriza entregas verticais e convenções existentes, em vez de arquitetura projetada isoladamente.
O que trazer
Traga o repositório, limites atuais, restrições e um marco verificável.
O agente precisa de contexto técnico suficiente para distinguir uma restrição real de uma preferência e uma migração necessária de infraestrutura especulativa.
- 01
O produto, o repositório, o serviço ou o limite técnico que está sendo planejado.
- 02
Linguagens, frameworks, armazenamentos de dados, infraestrutura e convenções do repositório.
- 03
Limites atuais, fluxos de dados, responsáveis, dívida técnica conhecida e registros de decisões relevantes.
- 04
Entrega, confiabilidade, segurança, migração, orçamento, compatibilidade e restrições operacionais.
- 05
O resultado técnico verificável de forma independente e a versão-alvo.
O que você recebe
Decisões de arquitetura diretamente ligadas a um caminho de entrega orientado por testes.
Os registros de decisões, as etapas de entrega e o manual de lançamento permanecem conectados, mantendo implementação, verificação, implantação e reversão coerentes entre si.
- 01
Arquitetura e registros de decisões
tech/architecture.mdPronto quando
Limites, propriedade dos dados, escolhas e concessões e opções rejeitadas são registrados.
- 02
Plano de entrega orientado por testes
tech/delivery-plan.jsonPronto quando
Etapas de entrega, dependências, testes, responsáveis e critérios de aceitação são explícitos.
- 03
Manual operacional de lançamento e reversão
tech/release-runbook.mdPronto quando
Uma compilação pode ser acompanhada, verificada, implantada e revertida com segurança.
O método
Inspecione primeiro, torne as decisões visíveis e entregue em etapas reversíveis.
O plano se baseia no espaço de trabalho vinculado ao código-fonte e transforma cada efeito relevante no host em uma solicitação explícita.
- 1
Inspecionar
Leia as convenções do repositório, os limites, a propriedade dos dados, o comportamento de implantação e as restrições conhecidas.
- 2
Decidir
Registre alternativas, escolhas e concessões, responsáveis, interfaces e opções rejeitadas.
- 3
Dividir em etapas
Crie entregas verticais orientadas por testes, com migrações, observabilidade e evidências de aceitação.
- 4
Lançamento
Defina solicitações de compilação, secrets, implantação, verificação, recuperação e reversão, com aprovações.
Sinais e limites de segurança
Uma arquitetura elegante falha quando avança além do produto validado.
Scripts ocultos, dados sem responsável, falta de evidências de reversão, acesso amplo a secrets ou implantação antes da revisão de segurança interrompem o plano de entrega.
Sinais de que o trabalho é útil
- Tempo até uma versão verificada
- Taxa de falha de alterações
- Confiabilidade do fluxo de trabalho principal
Razões para pausar
- A arquitetura vai além das necessidades validadas do produto
- A implantação avança sem etapas de aprovação de segurança e reversão
Limite de aprovação
Alteração do repositório · Implantação · Acesso a secrets
Apêndice técnico
O contrato exato que fundamenta o perfil.
Útil para operadores que precisam inspecionar a versão imutável do Kit, os limites tipados e a interface de verificação.
- Kit
- company-suite@0.1.0
- Ponto de entrada
- plan-tech
- Função
- plan-tech
- Ambiente de execução
- python@3.12
- Entrada
- specialist-brief.schema.json
- Saída
- specialist-plan.schema.json
Verificação
specialist-plan-quality · tech-readiness
Sistemas conectados
Adios Git · Adios Workspace · Adios Deployments · Adios Secrets