Desenvolvimento Orientado por Contexto

Guia para implementar e manter o contexto como um artefato gerenciado ao lado do código, permitindo interações consistentes com IA e alinhamento da equipe através de documentação estruturada do projeto.

Não use esta habilidade quando

• A tarefa não estiver relacionada ao desenvolvimento orientado por contexto
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça passos acionáveis e verificação.
• Use o fluxo de trabalho, relacionamentos de artefatos e lista de verificação de validação abaixo quando orientação detalhada de implementação for necessária.

Use esta habilidade quando

• Configurando novos projetos com Conductor
• Entendendo a relação entre artefatos de contexto
• Mantendo a consistência em sessões de desenvolvimento assistidas por IA
• Integrando membros da equipe a um projeto Conductor existente
• Decidindo quando atualizar documentos de contexto
• Gerenciando contextos de projetos greenfield vs. brownfield

Filosofia Central

O Desenvolvimento Orientado por Contexto trata o contexto do projeto como um artefato de primeira classe, gerenciado ao lado do código. Em vez de depender de prompts ad-hoc ou documentação espalhada, estabeleça uma base persistente e estruturada que informe todas as interações com IA.

Princípios chave:

1. Contexto precede o código: Defina o que você está construindo e como antes da implementação
2. Documentação viva: Artefatos de contexto evoluem com o projeto
3. Fonte única da verdade: Um local canônico para cada tipo de informação
4. Alinhamento com IA: Contexto consistente produz comportamento consistente da IA

O Fluxo de Trabalho

Siga o fluxo de trabalho Contexto → Especificação e Planejamento → Implementação:

1. Fase de Contexto: Estabeleça ou verifique se os artefatos de contexto do projeto existem e estão atualizados
2. Fase de Especificação: Defina requisitos e critérios de aceitação para unidades de trabalho
3. Fase de Planejamento: Divida as especificações em tarefas escalonadas e acionáveis
4. Fase de Implementação: Execute tarefas seguindo padrões de fluxo de trabalho estabelecidos

Relacionamentos de Artefatos

product.md - Define O QUÊ e POR QUÊ

Propósito: Captura a visão do produto, objetivos, usuários-alvo e contexto de negócios.

Conteúdo:

• Nome do produto e descrição em uma linha
• Declaração do problema e abordagem da solução
• Personas de usuários-alvo
• Principais funcionalidades e capacidades
• Métricas de sucesso e KPIs
• Roadmap do produto (alto nível)

Atualizar quando:

• A visão ou os objetivos do produto mudam
• Novas funcionalidades principais são planejadas
• O público-alvo muda
• As prioridades de negócios evoluem

product-guidelines.md - Define COMO Comunicar

Propósito: Estabelece a voz da marca, padrões de mensagens e padrões de comunicação.

Conteúdo:

• Diretrizes de voz e tom da marca
• Terminologia e glossário
• Convenções de mensagens de erro
• Padrões de texto voltados para o usuário
• Estilo de documentação

Atualizar quando:

• As diretrizes da marca mudam
• Nova terminologia é introduzida
• Os padrões de comunicação precisam de refinamento

tech-stack.md - Define COM O QUÊ

Propósito: Documenta escolhas de tecnologia, dependências e decisões arquiteturais.

Conteúdo:

• Linguagens e frameworks primários
• Dependências chave com versões
• Infraestrutura e alvos de implantação
• Ferramentas de desenvolvimento e ambiente
• Frameworks de teste
• Ferramentas de qualidade de código

Atualizar quando:

• Adicionando novas dependências
• Atualizando versões principais
• Mudando a infraestrutura
• Adotando novas ferramentas ou padrões

workflow.md - Define COMO Trabalhar

Propósito: Estabelece práticas de desenvolvimento, portões de qualidade e fluxos de trabalho da equipe.

Conteúdo:

• Metodologia de desenvolvimento (TDD, etc.)
• Fluxo de trabalho Git e convenções de commit
• Requisitos de revisão de código
• Requisitos de teste e metas de cobertura
• Portões de garantia de qualidade
• Procedimentos de implantação

Atualizar quando:

• As práticas da equipe evoluem
• Os padrões de qualidade mudam
• Novos padrões de fluxo de trabalho são adotados

tracks.md - Rastreia O QUE ESTÁ ACONTECENDO

Propósito: Registro de todas as unidades de trabalho com status e metadados.

Conteúdo:

• Tracks ativos com status atual
• Tracks concluídos com datas de conclusão
• Metadados do track (tipo, prioridade, atribuído)
• Links para diretórios de tracks individuais

Atualizar quando:

• Novos tracks são criados
• O status do track muda
• Tracks são concluídos ou arquivados

Princípios de Manutenção de Contexto

Mantenha os Artefatos Sincronizados

Garanta que as mudanças em um artefato se reflitam em documentos relacionados:

• Nova funcionalidade em product.md → Atualizar tech-stack.md se novas dependências forem necessárias
• Track concluído → Atualizar product.md para refletir novas capacidades
• Mudança de fluxo de trabalho → Atualizar todos os planos de track afetados

…