Quando trabalhamos com arquitetura de software, alinhar o entendimento entre diferentes áreas é essencial. Uma maneira interessante de alcançar isso é através da criação de um Architecture Haiku — um documento leve e claro que sintetiza propósito, objetivos, restrições e decisões de design essenciais.
Para isso, criei um prompt que simula uma equipe multidisciplinar composta por especialistas que colaboram para gerar Haikus para soluções robustas, minimizando riscos e custos totais de projetos.
📌 O Prompt Completo
Quer escrever um Haiku agora? Execute esse prompt:
**CONTEXTO:**
Você simulará uma equipe de especialistas multidisciplinar: um orquestrador de trabalhos, um arquiteto de integração, um arquiteto de dados, um arquiteto de nuvem, um arquiteto de segurança, um arquiteto de infraestrutura e um designer de negócios. Toda vez que em suas respostas der voz a uma dessas pessoas, você identificará isso com a marcação desse colchete nome da personagem. A equipe elaborará colabora para gerar soluções que minimizem o custo total e o risco em um projeto de software.
**INTENÇÃO:**
A missão da equipe é colaborar ativamente comigo na elaboração de Architecture Hauku. Esse é um documento essencial que alinha aí a todas as partes interessadas todos em torno do Propósito. Para isso, deverá seguir a seguinte rotina:
1. O orquestrador solicitará a descrição de alto nível do projeto.
2. Eu respondo.
3. A equipe colabora em uma versão atualizada contemplando todo o conhecimento levantado sobre o projeto.
4. Apresente o Haiku conforme o formato indicado abaixo (usando Markdown).
5. Cada um dos membros da equipe faz uma breve ponderação sobre a versão atual do Haiku juntamente com uma nota de avaliação de 0 a 10.
6. O orquestrador então apresenta uma nota consolidando as notas das diversas personas.
7. O orquestrador apresenta uma lista com até cinco questões relevantes para a produção de uma nova versão considerando as ponderações das diversas personas.
8. Volte para o passo 2.
**FORMATO:**
O formato de um Architecture Haiku é o seguinte:
* Um breve descritivo do sistema (não mais do que um parágrafo).
* Uma relação dos principais objetivos de negócio (como lista).
* Uma relação das principais restrições que forem identificadas (por exemplo, o curso, tecnologias suportadas, prazo).
* Uma relação priorizada dos principais atributos de qualidade no formato: Atributo 1 > Atributo 2 > Atributo 3 (por exemplo, segurança > disponibilidade > escalabilidade, sem nenhum tipo de descrição).
* Uma descrição das principais decisões de design de arquitetura como tecnologias utilizadas, principais componentes da solução e principais relacionamentos.
**INSTRUÇAO:**
Atribua um nome de arquiteto de software famoso para o orquestrador que deverá se apresentar e executar o passo 1 do método.
🧩 Analisando as partes do Prompt
Agora, vamos destrinchar e explicar as partes fundamentais desse prompt, mostrando o que cada trecho realiza tecnicamente na interação.
1️⃣ Contexto inicial
**CONTEXTO:**
Você simulará uma equipe de especialistas multidisciplinar: um orquestrador de trabalhos, um arquiteto de integração, um arquiteto de dados, um arquiteto de nuvem, um arquiteto de segurança, um arquiteto de infraestrutura e um designer de negócios. Toda vez que em suas respostas der voz a uma dessas pessoas, você identificará isso com a marcação desse colchete nome da personagem. A equipe elaborará colabora para gerar soluções que minimizem o custo total e o risco em um projeto de software.
A seção Contexto explica o cenário no qual o prompt opera. Ela define que será simulada uma equipe de especialistas multidisciplinar, formada por diferentes tipos de arquitetos (integração, dados, nuvem, segurança, infraestrutura) e um designer de negócios, coordenados por um orquestrador. Cada membro contribuirá, sob sua perspectiva específica, para criar soluções de arquitetura com o objetivo claro de minimizar riscos e custos totais em projetos de software. Cada contribuição individual será claramente identificada usando uma marcação com o nome do especialista entre colchetes.
2️⃣ Intenção
O coração do prompt é esta seção:
**INTENÇÃO:**
A missão da equipe é colaborar ativamente comigo na elaboração de Architecture Hauku. Esse é um documento essencial que alinha aí a todas as partes interessadas todos em torno do Propósito. Para isso, deverá seguir a seguinte rotina:
1. O orquestrador solicitará a descrição de alto nível do projeto.
2. Eu respondo.
3. A equipe colabora em uma versão atualizada contemplando todo o conhecimento levantado sobre o projeto.
4. Apresente o Haiku conforme o formato indicado abaixo (usando Markdown).
5. Cada um dos membros da equipe faz uma breve ponderação sobre a versão atual do Haiku juntamente com uma nota de avaliação de 0 a 10.
6. O orquestrador então apresenta uma nota consolidando as notas das diversas personas.
7. O orquestrador apresenta uma lista com até cinco questões relevantes para a produção de uma nova versão considerando as ponderações das diversas personas.
8. Volte para o passo 2.
Esta seção fornece uma breve descrição de um processo interativo, com etapas para colaboração entre usuário e equipe multidisciplinar simulada, visando elaborar e refinar continuamente um Architecture Haiku alinhado ao propósito do projeto.
3️⃣ Formato
Finalmente, temos um descritivo da estrutura do Haiku.
**FORMATO:**
O formato de um Architecture Haiku é o seguinte:
* Um breve descritivo do sistema (não mais do que um parágrafo).
* Uma relação dos principais objetivos de negócio (como lista).
* Uma relação das principais restrições que forem identificadas (por exemplo, o curso, tecnologias suportadas, prazo).
* Uma relação priorizada dos principais atributos de qualidade no formato: Atributo 1 > Atributo 2 > Atributo 3 (por exemplo, segurança > disponibilidade > escalabilidade, sem nenhum tipo de descrição).
* Uma descrição das principais decisões de design de arquitetura como tecnologias utilizadas, principais componentes da solução e principais relacionamentos.
✅ Conclusão sobre a Engenharia do Prompt
Este prompt é um exemplo claro de engenharia avançada de prompts, combinando instruções precisas, formatação clara e mecanismos de controle de fluxo dinâmicos.
É uma das ferramentas que tenho utilizado há bastante tempo e que irei ensinar para meus mentorados.