Planeje através de um mapa de sistema
Crie um entendimento compartilhado antes de desenhar ou construir. O mapa mostra o comportamento do sistema; o chat mantém a discussão. Planejar nunca concede permissão para implementar o produto.
Leia o guia de planejamento antes de começar ou retomar o planejamento. Ele define o formato de origem, registros de partes, navegação e verificações. Para configuração de auxiliares e comandos, leia o README.
Comece a partir de evidências
Continue o arquivo .plan.json salvo da conversa. Leia seu objetivo, decisões, perguntas em aberto e posição atual de planejamento. Inspecione evidências relevantes do projeto antes de descrever o comportamento existente. Carregue apenas a parte atual e seus vizinhos quando a origem for grande.
Para uma nova conversa, escolha um nome de origem descritivo e único. Nunca sobrescreva o plano de outra conversa. O plano de origem é a autoridade; desenhos e manifestos gerados não são planos editáveis.
Separe fatos verificados, planos acordados, incógnitas e propostas não aceitas. Cite evidências. Nunca infira uma decisão anterior a partir de um rótulo vago ou invente fatos para preencher uma lacuna.
Defina o significado antes de desenhar
Para cada parte, registre seu trabalho único, entrada, trabalho, resultado, regras, próximo destinatário, limite e evidência. Use os nomes de campo definidos no guia.
Mantenha o armazenamento separado das ações. Distinga um estado de espera do trabalho. Conecte cada resultado à entrada esperada da próxima parte. Percorra um exemplo concreto através das partes conectadas.
Use rótulos curtos e setas nomeadas. Páginas filhas explicam sua parte pai. Conecte-as por meio de destinos detail explícitos, nunca por nomes correspondentes ou links adivinhados. Mantenha escolhas de ferramentas, perguntas de design e comentários sobre recursos removidos fora do grafo.
Colabore e avance
Responda à pergunta atual primeiro. Leia as decisões tomadas antes de fazer outra pergunta. Solicitações de alteração claras atualizam a origem preservando decisões não relacionadas. O acordo aceita apenas a proposta realmente mostrada.
Após resolver um ponto, avance para a próxima parte significativa não resolvida. Explique seu propósito, proponha uma abordagem fundamentada e, em seguida, faça uma escolha concreta quando ela mudar o design. Não transforme o planejamento em uma entrevista ou pare em "salvo".
Rotule pequenos padrões como propostas. Não decida silenciosamente permissão, privacidade, custo ou evidências factuais. Resolva confusão antes de avançar. Se nenhuma decisão material restar, resuma a prontidão e ofereça revisão ou implementação separadamente autorizada.
Verifique antes de reivindicar conclusão
Depois de alterar um plano, construa-o e inspecione as conexões afetadas e o significado das páginas filhas. Se o acesso ao navegador estiver disponível, inspecione também o desenho e a navegação. Relate verificações indisponíveis honestamente.
Testes auxiliares verificam estrutura e saída gerada, não verdade do sistema, interações reais do navegador ou compatibilidade com cada plataforma de agente.