doftasted/AgentDock

Leia as diretrizes de desenvolvimento relevantes antes de iniciar sua tarefa.

Execute estas etapas:

1. Leia os artefatos da tarefa atual:

   • prd.md para requisitos e critérios de aceitação
   • design.md se presente para o design técnico
   • implement.md se presente para a ordem de execução e plano de validação

2. Descubra os pacotes e suas camadas de especificação:

   python3 ./.trellis/scripts/get_context.py --mode packages
   

3. Identifique quais especificações se aplicam à sua tarefa com base em:

   • Qual pacote você está modificando (ex.: cli/, docs-site/)
   • Que tipo de trabalho (backend, frontend, teste de unidade, documentação, etc.)
   • Quaisquer caminhos de especificação/pesquisa referenciados pelos artefatos da tarefa

4. Leia o índice de especificações para cada módulo relevante:

   cat .trellis/spec/<pacote>/<camada>/index.md
   

   Siga a seção "Lista de Verificação de Pré-Desenvolvimento" no índice.

5. Leia os arquivos de diretrizes específicos listados na Lista de Verificação de Pré-Desenvolvimento que são relevantes para sua tarefa. O índice NÃO é o objetivo — ele aponta para os arquivos de diretrizes reais (ex.: error-handling.md, conventions.md, mock-strategies.md). Leia esses arquivos para entender os padrões e práticas de codificação.

6. Sempre leia os guias compartilhados:

   cat .trellis/spec/guides/index.md
   

7. Para uma tarefa não trivial, declare o limite da mudança antes de escrever código. Não trivial significa que toca mais de um arquivo, cruza uma camada, altera uma interface pública ou edita código que você não acabou de escrever. Anote:

   • a menor lacuna de comportamento entre o que acontece agora e o que deve acontecer
   • onde esse comportamento realmente reside (não onde é mais fácil interceptá-lo)
   • quais arquivos você espera alterar e por que cada um é necessário
   • o que você está explicitamente não fazendo nesta tarefa
   • se uma refatoração local for necessária, como você mostrará que ela não alterou o comportamento

   Uma mudança pequena e bem delimitada não precisa disso — faça-a diretamente.

   Se o escopo real se mostrar claramente maior que este, diga isso e o porquê antes de continuar. Não amplie a mudança por conta própria.

8. Entenda os padrões e práticas de codificação que você precisa seguir e prossiga com seu plano de desenvolvimento.

Esta etapa é obrigatória antes de escrever qualquer código.