Skip to main content

01 - Gerar prompt de Implementação

📋 CONTEXTO INICIAL​

Estou implementando a versão X.X.X do meu projeto. Preciso que você:

  1. PRIMEIRO: Analise completamente os arquivos que contêm a especificação da vX.X.X:

    • README.md, roadmap.md, features.md, requirements.md,etc
    • Identifique TODOS os recursos, funcionalidades e melhorias planejadas
    • Liste dependências e pré-requisitos necessários

  2. SEGUNDO: Crie um plano de implementação estruturado seguindo estas diretrizes:

    • Divida CADA funcionalidade em micro-tarefas
    • Ordene por prioridade e dependências técnicas
    • Identifique potenciais conflitos ou riscos
    • Sugira pontos de commit no Git após cada feature major

🛠️ INFORMAÇÕES TÉCNICAS​

Stack Atual do Projeto:

Technology Stack 01​

  • Backend: Python 3.11 + FastAPI + SQLAlchemy + PostgreSQL 15
  • Frontend: Vite + React + TypeScript + Ant Design (always use Ant Design components when possible)
  • Deploy: Docker Compose + Traefik + SSL
  • Hospedagem: private vps

Technology Stack 02​

  • Backend: Python + FastAPI + SUPABASE
  • Frontend: Vite + React + TypeScript + Ant Design (always use Ant Design components when possible)
  • Deploy: Docker Compose + Traefik + SSL
  • Hospedagem: private vps

Technology Stack 03​

Next.js (para frontend e APIs) + Supabase (para banco de dados e autenticação) + Tailwind CSS (para estilização)

📝 FORMATO DE SAÍDA REQUERIDO​

Gere um documento Markdown estruturado com:

1. RESUMO EXECUTIVO​

  • Visão geral da vesãoX.X.X (máximo 5 linhas)
  • Features principais (lista bullet)
  • Estimativa de complexidade (1-10)
  • Riscos identificados

2. ANÁLISE DETALHADA​

Para CADA feature da v0.3.0, forneça:

  • Nome da Feature
  • Descrição detalhada
  • Arquivos que serão modificados
  • Dependências necessárias
  • Possíveis pontos de falha

3. PROMPTS DE IMPLEMENTAÇÃO​

Crie prompts PRONTOS PARA COPIAR E COLAR, seguindo este template:

## 🎯 PROMPT [NÚMERO] - [NOME DA FEATURE]
**Contexto**: [Breve descrição]
**Arquivos a mencionar**: [@arquivo1, @arquivo2, etc.]
**Componentes relacionados**: [Lista de componentes]

**INSTRUÇÃO DETALHADA**:
[Instrução específica e clara, sem ambiguidades]
- Passo 1: [Ação específica]
- Passo 2: [Ação específica]
- Passo 3: [Ação específica]

**VALIDAÇÃO**:
- [ ] Teste que confirma implementação
- [ ] Não quebrou funcionalidades existentes
- [ ] Segue padrões do projeto

**IMPORTANTE**: NÃO modifique NADA que não foi explicitamente pedido. Mantenha TODOS os padrões existentes.

4. CHECKLIST DE SEGURANÇA​

Para cada feature que envolva:

  • Entrada de usuário: validação server-side implementada
  • API endpoints: autenticação e autorização verificadas
  • Dados sensíveis: mantidos apenas no backend
  • Erros: mensagens genéricas para usuário, detalhadas nos logs

5. PLANO DE TESTES​

  • Testes unitários necessários

6. GIT WORKFLOW​

# Comandos Git após cada feature
git add .
git commit -m "feat(v0.3.0): [nome da feature] - [descrição breve]"
git push origin feature/v0.3.0-[nome-feature]

⚠️ REGRAS CRÍTICAS​

  1. Cada prompt deve ser AUTOCONTIDO - não assuma conhecimento de prompts anteriores
  2. SEMPRE especifique os arquivos exatos a serem modificados
  3. NUNCA deixe instruções vagas como "implemente a lógica necessária"
  4. Inclua tratamento de erros em CADA prompt
  5. Se uma feature for complexa demais (>5 passos), DIVIDA em múltiplos prompts

🚫 EVITE ESTES ERROS COMUNS​

  • Modificar código não relacionado
  • Esquecer de validar inputs
  • Ignorar padrões existentes no projeto
  • Criar features sem testes
  • Commitar alterações grandes demais

APÓS GERAR O PLANO: Revise se cada prompt está:

  • Claro e sem ambiguidades
  • Com contexto suficiente
  • Testável e validável
  • Seguindo os padrões do projeto
  • Com no máximo 5 ações por prompt