Engenharia de prompts

Exemplos de prompts:

Make the app better

Fix the bugs

Exemplos de prompts:

Add authentication

Exemplos de prompts:

Build the entire user management system with authentication, authorization, profiles, settings, and admin dashboard

Exemplos de prompts:

Update the validation logic

Exemplos de prompts:

Expecting Verdent to know your specific business rules or constraints

Exemplos de prompts:

Referencing files without including them in context

Exemplos de prompts:

Repeatedly asking for the same thing when Verdent encounters errors

Exemplos de prompts:

Requesting large refactorings or multi-file changes without using Plan Mode first

Exemplos de prompts:

Using Auto-Run or Skip Permission Mode without Git initialized

Exemplos de prompts:

Providing incomplete requirements and expecting Verdent to guess correctly

Criar novas funcionalidades com requisitos e restrições claros:

Create a POST /api/tasks endpoint that:
- Accepts task title (required), description (optional), and category_id (required)
- Validates that the category exists in the database
- Returns 400 if validation fails with descriptive error messages
- Saves the task to the database and returns the created task with 201 status
- Add this to the existing tasks router in routes/tasks.js
- Create the controller method in controllers/taskController.js
- Use the existing error handling pattern from other controllers

O que torna isso eficaz:

• Requisitos claros para entradas e validação
• Locais específicos de arquivo para implementação
• Referência a padrões existentes para manter a consistência
• Códigos de status HTTP esperados e tratamento de erros

Descrever problemas com contexto e soluções propostas:

Fix the race condition in payment processing at checkout. When multiple users submit payments simultaneously, some transactions fail with "duplicate order ID" errors. The issue appears to be in PaymentController.js around line 45 where we generate order IDs. Implement proper locking or use UUID generation to ensure unique IDs even under concurrent load.

O que torna isso eficaz:

• Descrição clara do problema com sintomas
• Localização específica do problema (arquivo e número da linha)
• Contexto sobre quando acontece (usuários simultâneos)
• Sugestões de abordagens de solução

Alterar a implementação preservando o comportamento:

Refactor the authentication middleware in middleware/auth.js to use JWT tokens instead of session cookies. Keep the same authorization logic, but:
- Replace session validation with JWT verification
- Store tokens in httpOnly cookies
- Maintain the existing user object structure that routes expect
- Update only the authentication mechanism, don't change authorization rules
- Ensure all existing routes continue to work without modification

O que torna isso eficaz:

• Objetivo claro (JWT em vez de sessões)
• Arquivo específico a refatorar
• Restrições explícitas (o que NÃO deve mudar)
• Requisito de compatibilidade retroativa

Escrever testes com cobertura abrangente:

Write comprehensive unit tests for the UserService class in services/UserService.js. Cover:
- User creation with valid and invalid data
- Email validation edge cases (empty, malformed, duplicate)
- Password hashing verification
- User lookup by ID and email
- Error handling for database failures
Use Jest and follow the testing patterns in existing service tests

O que torna isso eficaz:

• Classe/arquivo específico a testar
• Lista completa de cenários a cobrir
• Framework de testes especificado
• Referência a padrões de teste existentes

Construir componentes de UI com especificações detalhadas:

Create a reusable SearchBar component for the product catalog with:
- Text input with real-time debounced search (300ms delay)
- Category dropdown filter (fetch options from /api/categories)
- Price range slider (min $0, max $1000)
- Clear filters button
- Use Material-UI components to match existing design
- Emit search parameters via onChange callback to parent
- Include PropTypes for all props

O que torna isso eficaz:

• Lista completa de funcionalidades com detalhes específicos
• Especificações técnicas (debounce de 300ms, faixa de preço)
• Biblioteca de UI especificada (Material-UI)
• Abordagem de integração (callback para o componente pai)

Faça referência a arquivos, componentes ou subagentes específicos:

@auth.js @UserController.js Refactor authentication to use the same validation pattern

Benefícios:

• Garante que o Verdent tenha o contexto exato ao incluir explicitamente arquivos específicos
• Evita ambiguidade em bases de código grandes com nomes de arquivos semelhantes
• Garante que todo o código relevante esteja visível simultaneamente para refatoração precisa e correspondência de padrões
• Essencial ao referenciar padrões de implementação de um arquivo para aplicar em outro

Mude para o Plan Mode antes da execução em mudanças grandes:

Switch to Plan Mode
Refactor the entire API layer to use TypeScript with strict type checking

Benefícios:

• Revise a abordagem completa do Verdent antes que qualquer arquivo seja modificado
• Evita erros custosos em refatorações grandes ou mudanças arquiteturais
• Itere no plano, adicione restrições ou redirecione completamente antes do início da execução
• Peça que o Verdent entreviste você com perguntas esclarecedoras para reunir todos os requisitos antecipadamente

Delegue tarefas especializadas a subagentes integrados ou personalizados:

@Code-reviewer Review the security vulnerabilities in authentication flow
@Explorer Find all files that import the deprecated API client
@Verifier Validate the authentication logic in the middleware

Benefícios:

• Aproveite agentes especializados otimizados para tarefas específicas (exploração, verificação, revisão de código)
• Expertise focada e resultados mais rápidos do que o processamento de uso geral
• Execute várias análises em paralelo para reduzir drasticamente o tempo total de execução
• Crie subagentes personalizados com conhecimento específico de domínio para os requisitos únicos do seu projeto

Subagentes padrão integrados:

• @Verifier - Verificações rápidas de código e validação
• @Explorer - Exploração rápida da base de código e localização de arquivos
• @Code-reviewer - Avaliação da qualidade do código

Ative o raciocínio estendido para desafios sofisticados:

Think: Design the optimal database schema for a multi-tenant SaaS application

Benefícios:

• Ativa o raciocínio estendido para uma análise mais profunda de problemas complexos sob múltiplos ângulos
• Avalia abordagens alternativas e casos extremos de forma mais completa
• Produz soluções robustas onde a correção é fundamental
• Respostas mais lentas e maior uso de créditos, mas evita retrabalho custoso decorrente de soluções apressadas e subótimas

Construa sobre respostas anteriores com refinamento progressivo:

Initial: "Create a dashboard component"
Follow-up: "Add real-time data updates using WebSockets"
Follow-up: "Now add filtering and sorting capabilities"

Benefícios:

• Permite o desenvolvimento incremental com testes em cada etapa antes de adicionar complexidade
• Reduz riscos ao validar que cada camada funciona corretamente antes de construir sobre ela
• Corrija o rumo imediatamente se as iterações produzirem resultados inesperados
• Facilita identificar qual mudança específica introduziu um bug, já que cada iteração é pequena e contida

Especifique o que NÃO deve mudar junto com o que deve mudar:

Add caching to the API endpoints, but:
- Don't modify the authentication middleware
- Keep the existing error handling unchanged
- Maintain backward compatibility with mobile clients

Benefícios:

• Define explicitamente os limites para evitar modificar sistemas críticos (autenticação, pagamentos)
• Protege sistemas estáveis que devem permanecer inalterados por requisitos de conformidade ou risco
• Evita ciclos custosos de implementar mudanças, descobrir funcionalidades quebradas e refazer soluções
• Mantém a compatibilidade retroativa e protege código testado em produção de refatorações desnecessárias

Aponte para código existente como exemplos de implementação:

Implement the new ProductService following the same pattern as UserService.js, including error handling, validation, and database transaction management

Benefícios:

• Garante que novas implementações mantenham consistência com as convenções estabelecidas
• Torna a base de código mais sustentável e previsível
• Reduz drasticamente a explicação necessária - aponte para exemplos em vez de descrever abordagens em detalhe
• Aproveita padrões comprovados e testados em produção em vez de reinventar soluções
• Reduz bugs e garante integração perfeita com os sistemas existentes

Crie um arquivo todos.md para acompanhar tarefas complexas de múltiplas etapas:

Create a todos.md file with these tasks:
1. Refactor authentication to use JWT tokens
2. Update all controllers to use new auth middleware
3. Add tests for authentication flow
4. Update API documentation

Benefícios:

• Cria um roteiro claro e escrito que pode ser revisado, refinado e compartilhado com colegas de equipe
• Ajusta-se facilmente à medida que os requisitos evoluem ao longo do projeto
• Persiste entre sessões, permitindo pausar o trabalho, retomar depois e entender imediatamente onde você parou
• Serve como um artefato do projeto que documenta o que foi planejado, concluído e o que resta para manutenção e onboarding futuros

Inicie novas sessões entre diferentes todos para um contexto limpo:

After completing todo #1: "Start a new session"
Then: "Let's work on todo #2 from todos.md"

Benefícios:

• Evita contaminação de contexto, em que detalhes de tarefas anteriores influenciam indevidamente o trabalho atual
• Garante o foco apenas no todo atual, sem bagagem de tarefas anteriores
• Reduz o uso de tokens ao não carregar histórico de conversa desnecessário
• Torna as respostas mais rápidas e mais eficientes em créditos
• Cria checkpoints naturais para testar e fazer commit das mudanças, mantendo um histórico Git limpo e facilitando o isolamento de problemas

Use servidores MCP (Model Context Protocol) para injetar contexto especializado:

• Documentação específica do projeto
• Especificações de API (OpenAPI, schemas GraphQL)
• Conhecimento específico de framework

Benefícios:

• Aprimora a compreensão do Verdent sobre frameworks personalizados, ferramentas internas e domínios especializados que não estão em seus dados de treinamento
• Elimina a necessidade de explicar repetidamente sistemas personalizados ao injetar diretamente especificações de API e documentação específicas da organização
• Permite o uso correto de APIs internas e sistemas proprietários que seriam impossíveis de transmitir apenas por prompts

Inclua explicitamente arquivos relevantes no contexto:

@models/User.js @controllers/UserController.js Add password reset functionality

Quando usar:

• Ao trabalhar com arquivos fortemente acoplados (model e controller, service e testes)
• Ao referenciar padrões de implementação de um arquivo para aplicar em outro
• Ao coordenar mudanças entre vários arquivos relacionados
• Em bases de código grandes com nomes de arquivos semelhantes, onde a detecção automática pode perder contexto
• Sempre use ao pedir ao Verdent para "seguir o mesmo padrão de..." a fim de garantir que ele tenha o código exato

Inclua contexto de alto nível sobre sua stack:

This is a MERN stack application (MongoDB, Express, React, Node.js) with JWT authentication. Add role-based access control following our existing middleware pattern.

Quando usar:

• Ao implementar funcionalidades que precisam se integrar à sua stack tecnológica existente
• No primeiro trabalho em uma base de código ou em funcionalidades que abrangem múltiplas camadas (do frontend ao banco de dados)
• Quando sua stack tem opiniões fortes (GraphQL vs REST, Redux vs Context API) que afetam as escolhas de implementação
• Quando você precisa que o Verdent escolha a abordagem que se encaixa no seu sistema em vez de uma solução genérica

Aponte para código que demonstra suas convenções:

Follow the same error handling pattern used in ProductController.js - return consistent error objects with status codes and descriptive messages

Quando usar:

• Quando você quer que o novo código mantenha consistência com as convenções estabelecidas (tratamento de erros, validação, logging, testes)
• Ao implementar funcionalidade semelhante em uma nova área da base de código
• No onboarding em partes desconhecidas da base de código, onde você quer aprender e replicar padrões existentes
• Quando você quer evitar descrever padrões em detalhe e precisa que o Verdent capture nuances difíceis de articular

Indique limitações ou requisitos:

We're using TypeScript with strict mode enabled, React 18 with hooks only (no class components), and Material-UI v5 for styling

Quando usar:

• Quando seu projeto tem requisitos tecnológicos específicos (modo strict do TypeScript, apenas React hooks, sem dependências externas)
• Ao trabalhar com restrições legadas (suporte ao IE11, compatibilidade com Node.js 14)
• Quando requisitos de conformidade ditam escolhas (acessibilidade WCAG, tratamento de dados GDPR)
• Ao usar versões específicas de bibliotecas com mudanças incompatíveis entre versões
• Quando você precisa impedir que o Verdent proponha soluções que violem os limites técnicos do seu projeto

Explique regras específicas do domínio:

Users can only view tasks assigned to them or their team. Managers can view all tasks in their department. Admins can view everything.

Quando usar:

• Ao implementar funcionalidades com regras específicas do domínio que o Verdent não pode inferir apenas do código
• Lógica de autorização (quem pode acessar o quê), fluxos de trabalho de negócio (processos de aprovação, máquinas de estado)
• Regras de validação (políticas de senha, restrições de dados), restrições de domínio (limites de estoque, regras de preço)
• Ao construir modelos de dados em que relacionamentos entre entidades e cardinalidade precisam de explicação
• Ao implementar cálculos (regras de desconto, cálculo de impostos, estruturas de comissão)
• Quando você precisa que o Verdent aplique corretamente as regras de negócio da sua organização, não apenas código funcional

Compartilhe mensagens de erro ou logs ao depurar:

Getting "TypeError: Cannot read property 'id' of undefined" at UserController.js:42 when trying to update user profiles. The req.user object exists but doesn't have an id property after the recent auth middleware changes.

Quando usar:

• Sempre inclua mensagens de erro completas, stack traces e logs ao corrigir bugs
• Erros em tempo de execução (exceções, crashes), falhas de build (erros de compilação, violações de linting)
• Falhas de teste (erros de asserção, problemas de timeout), comportamento inesperado (saída errada, dados ausentes)
• Quando você tem mensagens de erro exatas com números de linha e o stack trace completo mostrando a cadeia de chamadas
• Quando você pode fornecer contexto sobre quando ocorre (sempre, intermitentemente, condições específicas)
• Quando você quer melhorar drasticamente a capacidade do Verdent de identificar causas-raiz em vez de adivinhar

O Verdent carrega automaticamente arquivos relevantes com base na sua solicitação:

• Arquivos mencionados pelo nome nos prompts
• Arquivos relacionados no mesmo diretório
• Arquivos do projeto acessados com frequência

Quando confiar nisso:

• Para referências de arquivo padrão, em que os relacionamentos são óbvios
• Ao mencionar componentes pelo nome e o Verdent precisa carregar aquele arquivo específico
• Ao trabalhar com arquivos no mesmo diretório que costumam funcionar juntos
• Ao acessar arquivos do projeto usados com frequência (package.json, arquivos de configuração)
• Funciona bem para cenários simples em bases de código bem organizadas
• Para refatorações complexas de múltiplos arquivos, partes distantes da base de código ou nomes de arquivo ambíguos, use @-menções explícitas

Configure contexto persistente por meio de arquivos de regras (Settings → Rules):

Regras de usuário (VERDENT.md): Preferências globais aplicadas a todos os projetos

Regras de projeto (AGENTS.md): Padrões específicos do projeto - padrões arquiteturais, padrões de código

Regras de plano (plan_rules.md): Personalize o formato e o conteúdo do plano no Plan Mode

Quando usar:

• Quando você fornece repetidamente o mesmo contexto entre sessões
• Regras de usuário para preferências pessoais (estilo de código, bibliotecas preferidas, padrões que você favorece)
• Regras de projeto para padrões da equipe (decisões arquiteturais, convenções de nomenclatura, requisitos de teste)
• Valiosas para o onboarding de novos membros da equipe (codifica o conhecimento tribal)
• Para manter a consistência em equipes grandes e reduzir a verbosidade dos prompts
• Invista em arquivos de regras quando seu projeto estiver maduro o suficiente para ter padrões estabelecidos que valha a pena documentar

Inclua capturas de tela, mockups ou diagramas:

@screenshot.png Implement this UI design with React components

Quando usar:

• Quando a informação visual comunica os requisitos de forma mais eficaz do que o texto
• Implementação de UI/UX (mockups de design, wireframes, fluxos de usuário)
• Depuração de problemas visuais (captura de tela de um layout quebrado, problemas de renderização)
• Compreensão de arquiteturas complexas (diagramas de sistema, schemas de banco de dados, fluxogramas)
• Essencial para design responsivo, análise de acessibilidade e reprodução de erros
• Traduzir designs de ferramentas como Figma ou Sketch em código
• Uma única captura de tela bem feita costuma transmitir detalhes que levariam parágrafos para descrever

Faça referência a documentação ou exemplos externos:

Ultrathink: Read this API documentation at https://api-docs.example.com/v1/endpoints and implement the authentication flow

Quando usar:

• Ao implementar integrações com APIs ou bibliotecas externas que tenham documentação oficial online
• Especialmente valioso quando a biblioteca tem opções de configuração complexas ou fluxos de autenticação
• Use o prefixo "Ultrathink:" para instruir o Verdent a buscar e analisar o conteúdo da web antes de gerar código
• Essencial para APIs em rápida evolução, em que a documentação é mais atual do que os dados de treinamento
• Ao seguir padrões específicos de framework (Next.js App Router, Vue Composition API)
• Garante que as implementações correspondam às versões atuais da API e sigam as recomendações oficiais

Prompt inicial:

Add authentication to the API

A resposta do Verdent pode ser genérica. Refine:

Use JWT tokens stored in httpOnly cookies, implement refresh token rotation, and follow the authentication pattern from our existing UserController

Quando usar: Começar com uma solicitação geral e depois adicionar detalhes com base na resposta inicial

Se a implementação do Verdent não corresponder às expectativas:

The validation logic is good, but use Joi schema validation instead of manual checks. Match the validation pattern in ProductController.js

Quando usar: Após revisar a saída e identificar melhorias específicas

Construa de forma incremental:

Initial: "Create a UserProfile component"
Follow-up: "Add an avatar upload feature with image preview"
Follow-up: "Add validation - max 5MB, only jpg/png formats"
Follow-up: "Show upload progress with a progress bar"

Quando usar: Construir funcionalidades progressivamente na mesma sessão

Se a implementação parecer inesperada:

Why did you use Redux instead of Context API? Can you explain the trade-offs for this use case?

Depois refine com base na compreensão:

Actually, use Context API for consistency with the rest of our application

Quando usar: Entender o raciocínio antes de solicitar mudanças

Para mudanças complexas:

Switch to Plan Mode
Show me how you would refactor the authentication system to support OAuth providers

Revise o plano, faça perguntas e itere na abordagem antes da execução.

Quando usar: Mudanças arquiteturais importantes que exigem revisão

Se o estilo do Verdent não corresponder ao seu:

The component structure is close, but use this pattern instead:
[paste example of your preferred structure]
Apply this same pattern to the remaining components

Quando usar: Estabelecer ou reforçar preferências de estilo de código

Se a saída violar restrições não declaradas:

Good approach, but don't modify the database schema - work within the existing User table structure

Quando usar: Adicionar restrições descobertas após ver a implementação inicial

Comece com a funcionalidade central e adicione recursos iterativamente:

Step 1: "Create basic CRUD endpoints for tasks"
Step 2: "Add pagination to the GET endpoint"
Step 3: "Add filtering by status and priority"
Step 4: "Add full-text search across title and description"

Quando usar: Construir funcionalidades complexas de forma incremental com testes em cada etapa