elophanto/EloPhanto

Decomposição de Objetivos

Descrição

Melhores práticas para decompor objetivos complexos em marcos executáveis.

Acionadores

• goal
• plan
• long-term
• multi-step
• project
• achieve
• milestone

Instruções

Princípios de Decomposição

1. Concreto sobre abstrato — Cada marco deve produzir um artefato tangível ou resultado verificável, não "pensar sobre X"
2. 3 a 10 marcos — Poucos = marcos muito complexos. Muitos = sobrecarga.
3. Pesquisa antes da ação — O primeiro marco deve sempre reunir informações
4. Verificar antes de prosseguir — Inclua etapas de verificação como critérios de sucesso, não como marcos separados
5. Antecipar incertezas — Coloque marcos incertos/arriscados no início para que o fracasso seja barato

Regras para Critérios de Sucesso

• Devem ser objetivamente verificáveis — "arquivo existe no caminho X", "3 posições encontradas", "teste passa"
• Sem critérios subjetivos — evite "boa qualidade", "bem escrito"
• Inclua quantidades quando possível — "pelo menos 3", "menos de 500 palavras"

Quando Revisar

• Novas informações invalidam premissas (a empresa não está contratando)
• Um marco revela que faltam etapas no plano
• O usuário fornece feedback que muda a direção
• 2+ falhas em marcos sugerem abordagem errada

Antipadrões

• Não crie um objetivo para tarefas concluíveis em <5 chamadas de ferramenta
• Não faça marcos que dependam de tempo externo ("aguardar resposta") — em vez disso, pause o objetivo e agende um lembrete para retomar
• Não coloque toda a complexidade em um único marco — se um marco precisar de 50+ chamadas de ferramenta, ele deve ser dividido

Exemplos

Boa Decomposição: Candidatura a Emprego

Objetivo: "Conseguir um emprego na empresa X"

1. Pesquisar X (cultura, stack, notícias recentes) — critério: resumo escrito
2. Encontrar vagas abertas — critério: 3+ vagas listadas com URLs
3. Adaptar currículo — critério: arquivo de currículo atualizado, habilidades relevantes destacadas
4. Redigir carta de apresentação — critério: arquivo de carta criado, <400 palavras
5. Enviar candidatura — critério: captura de tela da página de confirmação salva

Boa Decomposição: Site Portfólio

Objetivo: "Crie um site portfólio para mim"

1. Pesquisar tendências de design e reunir requisitos — critério: briefing de design escrito
2. Configurar projeto (Next.js + destino de implantação) — critério: projeto estruturado, servidor de desenvolvimento funciona
3. Construir páginas principais (início, sobre, projetos) — critério: 3 páginas renderizam com conteúdo placeholder
4. Adicionar conteúdo real e estilização — critério: todas as seções preenchidas, responsivo em dispositivos móveis
5. Implantar em produção — critério: URL ao vivo acessível, sem erros no console

Boa Decomposição: Auditoria de Segurança

Objetivo: "Auditar esta base de código em busca de vulnerabilidades de segurança"

1. Escanear dependências em busca de CVEs conhecidas — critério: relatório de dependências gerado
2. Revisar autenticação e gerenciamento de sessão — critério: fluxo de autenticação documentado, problemas listados
3. Verificar vulnerabilidades de injeção (SQL, XSS, comando) — critério: cada caminho de entrada testado
4. Escrever relatório de auditoria com classificações de gravidade — critério: arquivo de relatório criado, descobertas priorizadas

Decomposição Ruim

Objetivo: "Conseguir um emprego na empresa X"

1. Fazer pesquisa (muito vago, sem critérios)
2. Candidatar-se (muito amplo, deveria ser várias etapas)
3. Aguardar resposta (depende de tempo externo)

Verificar

• O entregável desta fase existe como um artefato concreto (documento, ticket, quadro, repositório) e sua localização é compartilhada, não apenas descrita
• Cada compromisso tem um proprietário, uma data de entrega e uma definição de concluído que alguém além do autor poderia verificar
• Os riscos estão listados com probabilidade/impacto e uma mitigação nomeada, não como um genérico 'riscos: a definir'
• Dependências de outras equipes/fornecedores/agentes são explícitas; uma confirmação de cada dependência está registrada ou marcada como 'pendente'
• Os critérios de sucesso para a próxima fase são numéricos ou objetivamente testáveis
• Um critério de reversão / interrupção / 'pararemos se X' está escrito antes do início do trabalho

Notas

• Sempre verifique se um goals/SKILL.md é relevante antes de criar um objetivo
• O sistema de objetivos gerencia persistência, contexto e continuação automática
• Use goal_status para verificar o progresso a qualquer momento