Loading...
O Problema
Código gerado por IA funciona, mas o contexto desaparece. Três meses depois, seu próprio código parece estranho.
A Solução
Context Mesh torna o contexto o artefato principal. Código se torna sua manifestação, não o contrário.
Um framework de processo para desenvolvimento AI-First que trata o contexto como a criação primária, com código como sua manifestação, possibilitando desenvolvimento sustentável assistido por IA.
Construído para colaboração eficaz humano-IA com benefícios claros que transformam seu fluxo de desenvolvimento.
Context Mesh foi projetado para simplicidade e fácil adoção. Três passos essenciais que preservam contexto ao longo do ciclo de vida do desenvolvimento.
Define o que você quer construir e por quê, cria intents de features/bugs, toma decisões técnicas, cria contexto vivo inicial e identifica padrões.
Liderar captura de intenção, validar clareza, aprovar contexto inicial, alinhar stakeholders.
Auxiliar na estruturação, sugerir organização de contexto, gerar contexto a partir de prompts, explicar antes de executar.
✅ Contexto como Criação Primária | ✅ Arquitetura Orientada por Intenção
Context Mesh usa uma estrutura de diretórios simples e clara, fácil de navegar e manter. Funciona com qualquer ferramenta ou sem ferramentas.
Estrutura organizada que humanos e IA podem entender e navegar facilmente.
Adicione subdiretórios conforme necessário. A estrutura cresce com seu projeto.
Contexto é versionado (Git), pesquisável e sempre atualizado. Rastreabilidade completa de intenção ao código.
12345context/├── intent/│ └── feature-user-auth.md # O que + Por quê + Critérios de aceitação└── decisions/ └── 002-auth.md # Como (abordagem técnica) + RacionalComece simples. Adicione complexidade apenas quando necessário.
Entendendo quando criar vs atualizar, convenções de nomenclatura e gerenciamento de arquivos.
Regra de Ouro: Pergunte a si mesmo 'Isso é um novo escopo ou evolução do escopo existente?'
| Situação | Ação | Por quê |
|---|---|---|
| Nova feature | Criar feature-*.md | Novo escopo |
| Atualizar feature existente | Atualizar feature-*.md | Mesmo escopo (Git preserva histórico) |
| Nova decisão | Criar decisions/003-*.md | Novo escopo |
| Adicionar outcomes à decisão | Atualizar decisions/002-*.md | Mesmo escopo |
Quando uma feature é removida ou um bug é resolvido, marque como deprecated/resolved mas NÃO delete. Mantenha arquivos para histórico e rastreabilidade.
Inclua no final de cada arquivo de context:
1234## Status- **Created**: YYYY-MM-DD (Phase: Intent/Build/Learn)- **Status**: [Status Type]- **Updated**: YYYY-MM-DD (Phase: Intent/Build/Learn) - [reason] (opcional)Status Types:
Context Mesh se adapta às suas necessidades. Diferentes abordagens são igualmente válidas:
When to Use:
Projetos exploratórios, requisitos não claros, protótipos rápidos
How:
Comece com intent básico, use IA para expandir context, aprenda conforme avança
When to Use:
Projetos grandes, requisitos claros, projetos em equipe
How:
Inclua decisões, padrões, planejamento DevOps no Passo 1, crie context completo antes de Build
When to Use:
Codebases legadas, assumindo projetos, refatoração
How:
Use IA para analisar código existente, gerar context do codebase, depois siga workflow normal
Context Mesh define papéis claros para humano e IA em cada passo, garantindo colaboração eficaz e mantendo controle humano.
Humano lidera, IA auxilia. Defina objetivos e valide contexto juntos.
IA constrói, humano supervisiona. Gere código com consciência total do contexto.
IA analisa, humano valida. Capture aprendizados e atualize contexto.
IA explica o que fará
Você revisa e aprova
IA executa com aprovação
Context Mesh implementa cinco princípios fundamentais que guiam o desenvolvimento AI-First.
Context Mesh integra-se perfeitamente com Scrum, Kanban, DevOps ou seu próprio processo de desenvolvimento.
Context Mesh usa Definition of Done apenas no nível técnico/feature - critérios que toda implementação de feature deve atender antes de ser considerada completa.
Acceptance Criteria:
Acceptance Criteria (em arquivos feature-*.md) - O que a feature precisa fazer funcionalmente (ex: 'Usuário pode fazer login', 'Dados são salvos')
Definition of Done:
Definition of Done - Critérios de processo que devem ser atendidos durante implementação (ex: 'Testes passando', 'Code review feito', 'Context atualizado')
Context Mesh adapta o padrão AGENTS.md (veja agents.md) para funcionar perfeitamente com nossa estrutura de context. AGENTS.md atua como um roteador que direciona agentes de IA para arquivos Context Mesh.
Um formato aberto usado por mais de 20.000 projetos open-source (veja agents.md). Context Mesh adapta este padrão para funcionar com nossa estrutura de context.
Saiba mais sobre o padrão AGENTS.mdNosso AGENTS.md foca em rotear agentes de IA para arquivos Context Mesh (intent, decisions, patterns) ao invés de duplicar context. Mantenha conciso - deve principalmente indicar onde encontrar context.
Importante: AGENTS.md deve ser mantido atualizado para refletir mudanças no context vivo. Novas features, decisões e padrões devem ser adicionados às seções apropriadas.
Segurança está integrada ao Context Mesh desde o início. Considere segurança em cada passo.
Comece em minutos com nosso guia de início rápido. Apenas copie, cole e deixe a IA criar sua estrutura de contexto.