Padrões Avançados

Leve suas habilidades em Context Mesh para o próximo nível com estes padrões e técnicas avançadas.

12 min de leitura

Agentes Compostos

Orquestre múltiplos agentes para implementar funcionalidades complexas.

context/agents/agent-full-feature.md

123456789101112131415161718192021222324252627
# Agent: Full Feature Implementation
 
## Purpose
Orchestrate multiple sub-agents to implement a complete feature.
 
## Sub-Agents
1. @context/agents/agent-database.md - Schema changes
2. @context/agents/agent-api.md - API endpoints
3. @context/agents/agent-ui.md - Frontend components
4. @context/agents/agent-tests.md - Test coverage
 
## Execution Order
1. Execute agent-database first (creates schema)
2. Execute agent-api second (needs schema)
3. Execute agent-ui third (needs API)
4. Execute agent-tests last (needs all components)
 
## Dependencies
- agent-api depends on agent-database
- agent-ui depends on agent-api
- agent-tests depends on all above
 
## Rollback Plan
If any agent fails:
1. Document the failure in evolution/
2. Revert database migrations if needed
3. Reset to last known good state

Benefícios

• Divida tarefas complexas em partes gerenciáveis
• Dependências claras entre tarefas
• Fácil paralelizar trabalho independente

Considerações

• Defina pontos de entrega claros
• Trate falhas graciosamente
• Documente procedimentos de rollback

Herança de Contexto

Construa estruturas hierárquicas de contexto para projetos complexos.

1234567891011121314
context/
├── intent/
│   ├── project-intent.md          # Root intent
│   ├── feature-auth.md            # Inherits from project
│   └── feature-auth-oauth.md      # Inherits from feature-auth
├── decisions/
│   ├── 001-architecture.md        # Project-level decision
│   └── 001a-auth-architecture.md  # Extends 001
├── knowledge/
│   ├── patterns/
│   │   ├── _base-component.md     # Base pattern
│   │   └── form-component.md      # Extends base
│   └── anti-patterns/
│       └── prop-drilling.md       # References patterns/

Use Prefixos para Nomes

Use prefixos como 001a- para mostrar relação com decisões pai.

Referencie Contexto Pai

Sempre referencie documentos pai usando sintaxe @.

Execução Condicional

Crie agentes que se adaptam baseado na configuração do projeto.

context/agents/agent-auth-setup.md

12345678910111213141516171819202122232425262728293031
# Agent: Setup Authentication
 
## Conditional Execution
 
### If using NextAuth.js
1. Install next-auth and @auth/prisma-adapter
2. Create app/api/auth/[...nextauth]/route.ts
3. Configure providers in lib/auth.ts
 
### If using Clerk
1. Install @clerk/nextjs
2. Add ClerkProvider to layout
3. Configure middleware
 
### If using Supabase Auth
1. Install @supabase/ssr
2. Create lib/supabase/client.ts and server.ts
3. Set up auth middleware
 
## Environment Variables Required
### NextAuth.js
- NEXTAUTH_SECRET
- NEXTAUTH_URL
 
### Clerk
- NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
- CLERK_SECRET_KEY
 
### Supabase
- NEXT_PUBLIC_SUPABASE_URL
- NEXT_PUBLIC_SUPABASE_ANON_KEY

Rastreamento de Evolução

Rastreie como seu contexto evolui ao longo do tempo com changelogs detalhados.

context/evolution/changelog.md

1234567891011121314151617181920212223
# Evolution Changelog
 
## [2024-01-15] Sprint 3 Retrospective
 
### What Worked
- Agent-based development increased velocity by 40%
- Decision records prevented 3 architectural mistakes
- Pattern library reduced code review time
 
### What Didn't Work
- Some agents had too broad scope
- Knowledge patterns needed more examples
- Missing anti-patterns caused repeated mistakes
 
### Changes Made
- Split large agents into smaller, focused ones
- Added code examples to all patterns
- Created anti-pattern: "Mixing server/client state"
 
### Updated Files
- Modified: context/agents/agent-feature.md
- Created: context/knowledge/anti-patterns/state-mixing.md
- Updated: context/knowledge/patterns/state-management.md

Dica Pro

Agende retrospectivas regulares para atualizar seu changelog de evolução e melhorar padrões.

Escalando Context Mesh

Como escalar Context Mesh para diferentes tamanhos de projeto.

Projetos Pequenos (1-2 desenvolvedores)

Mantenha simples: intenção do projeto, decisões chave e alguns padrões.

Projetos Médios (3-10 desenvolvedores)

Adicione intenções de funcionalidade, padrões mais detalhados e agentes especializados.

Projetos Grandes (10+ desenvolvedores)

Use diretórios de contexto específicos por domínio e bibliotecas de padrões compartilhados.

Próximos Passos

Tem dúvidas? Confira estes recursos.

FAQ Glossário

123456789101112131415161718192021222324252627 # Agent: Full Feature Implementation ## Purpose Orchestrate multiple sub-agents to implement a complete feature. ## Sub-Agents 1. @context/agents/agent-database.md - Schema changes 2. @context/agents/agent-api.md - API endpoints 3. @context/agents/agent-ui.md - Frontend components 4. @context/agents/agent-tests.md - Test coverage ## Execution Order 1. Execute agent-database first (creates schema) 2. Execute agent-api second (needs schema) 3. Execute agent-ui third (needs API) 4. Execute agent-tests last (needs all components) ## Dependencies - agent-api depends on agent-database - agent-ui depends on agent-api - agent-tests depends on all above ## Rollback Plan If any agent fails: 1. Document the failure in evolution/ 2. Revert database migrations if needed 3. Reset to last known good state

1234567891011121314 context/ ├── intent/ │ ├── project-intent.md # Root intent │ ├── feature-auth.md # Inherits from project │ └── feature-auth-oauth.md # Inherits from feature-auth ├── decisions/ │ ├── 001-architecture.md # Project-level decision │ └── 001a-auth-architecture.md # Extends 001 ├── knowledge/ │ ├── patterns/ │ │ ├── _base-component.md # Base pattern │ │ └── form-component.md # Extends base │ └── anti-patterns/ │ └── prop-drilling.md # References patterns/

12345678910111213141516171819202122232425262728293031 # Agent: Setup Authentication ## Conditional Execution ### If using NextAuth.js 1. Install next-auth and @auth/prisma-adapter 2. Create app/api/auth/[...nextauth]/route.ts 3. Configure providers in lib/auth.ts ### If using Clerk 1. Install @clerk/nextjs 2. Add ClerkProvider to layout 3. Configure middleware ### If using Supabase Auth 1. Install @supabase/ssr 2. Create lib/supabase/client.ts and server.ts 3. Set up auth middleware ## Environment Variables Required ### NextAuth.js - NEXTAUTH_SECRET - NEXTAUTH_URL ### Clerk - NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY - CLERK_SECRET_KEY ### Supabase - NEXT_PUBLIC_SUPABASE_URL - NEXT_PUBLIC_SUPABASE_ANON_KEY

1234567891011121314151617181920212223 # Evolution Changelog ## [2024-01-15] Sprint 3 Retrospective ### What Worked - Agent-based development increased velocity by 40% - Decision records prevented 3 architectural mistakes - Pattern library reduced code review time ### What Didn't Work - Some agents had too broad scope - Knowledge patterns needed more examples - Missing anti-patterns caused repeated mistakes ### Changes Made - Split large agents into smaller, focused ones - Added code examples to all patterns - Created anti-pattern: "Mixing server/client state" ### Updated Files - Modified: context/agents/agent-feature.md - Created: context/knowledge/anti-patterns/state-mixing.md - Updated: context/knowledge/patterns/state-management.md