Criar Plano de Implementação

Diretiva Primária

Seu objetivo é criar um novo arquivo de plano de implementação para ${input:PlanPurpose}. Sua saída deve ser legível por máquina, determinística e estruturada para execução autônoma por outros sistemas de IA ou humanos.

Contexto de Execução

Este prompt foi projetado para comunicação IA-IA e processamento automatizado. Todas as instruções devem ser interpretadas literalmente e executadas sistematicamente sem interpretação ou esclarecimento humano.

Requisitos Principais

• Gerar planos de implementação que sejam totalmente executáveis por agentes de IA ou humanos
• Usar linguagem determinística com zero ambiguidade
• Estruturar todo o conteúdo para análise e execução automatizadas
• Garantir autossuficiência completa, sem dependências externas para compreensão

Requisitos de Estrutura do Plano

Os planos devem consistir em fases discretas e atômicas contendo tarefas executáveis. Cada fase deve ser processável independentemente por agentes de IA ou humanos, sem dependências entre fases, a menos que explicitamente declaradas.

Arquitetura de Fases

• Cada fase deve ter critérios de conclusão mensuráveis
• As tarefas dentro das fases devem ser executáveis em paralelo, a menos que dependências sejam especificadas
• Todas as descrições de tarefas devem incluir caminhos de arquivo específicos, nomes de função e detalhes exatos de implementação
• Nenhuma tarefa deve exigir interpretação ou tomada de decisão humana

Padrões de Implementação Otimizados para IA

• Usar linguagem explícita e inequívoca, sem necessidade de interpretação
• Estruturar todo o conteúdo como formatos analisáveis por máquina (tabelas, listas, dados estruturados)
• Incluir caminhos de arquivo específicos, números de linha e referências exatas de código, quando aplicável
• Definir explicitamente todas as variáveis, constantes e valores de configuração
• Fornecer contexto completo dentro de cada descrição de tarefa
• Usar prefixos padronizados para todos os identificadores (REQ-, TASK-, etc.)
• Incluir critérios de validação que possam ser verificados automaticamente

Especificações do Arquivo de Saída

• Salvar arquivos de plano de implementação no diretório /plan/
• Usar convenção de nomenclatura: [purpose]-[component]-[version].md
• Prefixo de propósito: upgrade|refactor|feature|data|infrastructure|process|architecture|design
• Exemplo: upgrade-system-command-4.md, feature-auth-module-1.md
• O arquivo deve ser Markdown válido com estrutura de front matter adequada

Estrutura de Modelo Obrigatória

Todos os planos de implementação devem aderir estritamente ao seguinte modelo. Cada seção é obrigatória e deve ser preenchida com conteúdo específico e acionável. Os agentes de IA devem validar a conformidade do modelo antes da execução.

Regras de Validação do Modelo

• Todos os campos de front matter devem estar presentes e formatados corretamente
• Todos os cabeçalhos de seção devem corresponder exatamente (sensível a maiúsculas e minúsculas)
• Todos os prefixos de identificador devem seguir o formato especificado
• As tabelas devem incluir todas as colunas necessárias
• Nenhum texto de espaço reservado pode permanecer na saída final
• Os identificadores devem ser declarados de forma exclusiva. Cada identificador (REQ-NNN, SEC-NNN, CON-NNN, GUD-NNN, PAT-NNN, GOAL-NNN, TASK-NNN, ALT-NNN, DEP-NNN, FILE-NNN, TEST-NNN, RISK-NNN, ASSUMPTION-NNN) deve ser declarado exatamente uma vez. Uma declaração é onde o identificador introduz uma linha: a célula inicial em uma linha de tabela TASK/GOAL, ou o prefixo em negrito em uma linha de marcador como - **REQ-001**: .... O mesmo identificador pode então aparecer qualquer número de vezes como uma referência em outro lugar no plano (um corpo TASK citando um REQ, um TASK citando outro TASK, a seção Dependencies apontando para um DEP já declarado anteriormente, etc.). Referências são esperadas e não colisões.

Verificação de Unicidade de Identificadores

Execute estas verificações antes de finalizar o plano. As verificações (1) e (2) visam declarações e devem retornar zero linhas. A verificação (3) é uma varredura ampla e informativa: ela também exibirá referências válidas, portanto, use-a para conscientização, em vez de como um portão.

# Defina PLAN_FILE para o plano que está sendo validado.
PLAN_FILE="/plan/<purpose>-<component>-<version>.md"

# 1) Declarações duplicadas de TASK / GOAL em linhas de tabela.
grep -oE '\| (TASK|GOAL)-[0-9]+ \|' "$PLAN_FILE" \
  | sed -E 's/.*((TASK|GOAL)-[0-9]+).*/\1/' \
  | sort | uniq -d

# 2) IDs de declaração duplicados em linhas de especificação estilo marcador.
grep -oE '^- \*\*(REQ|SEC|CON|GUD|RISK|ASSUMPTION|TASK|GOAL|FILE|TEST|PAT|ALT|DEP)-[0-9]+\*\*:' "$PLAN_FILE" \
  | sed -E 's/^- \*\*([A-Z]+-[0-9]+)\*\*:.*/\1/' \
  | sort | uniq -d

# 3) Varredura ampla de duplicatas (apenas diagnóstico; pode incluir referências válidas).

…