Contexto do projeto
O contexto é um bloco de texto injetado automaticamente em todas as sessões do projeto. É a forma de garantir que o agente sempre sabe o que está trabalhando sem você precisar reexplicar.
O que incluir no contexto
Um bom contexto de projeto inclui:
- Stack tecnológica — linguagem, frameworks, ORMs, bibliotecas principais
- Objetivo do projeto — o que ele faz em uma frase
- Convenções — padrão de commits, nomenclatura, estrutura de pastas
- Restrições — o que o agente não deve fazer (ex: não modificar o schema sem confirmar)
- Diretório de trabalho — confirmação do caminho
Exemplo de contexto bem escrito:
Projeto: API de e-commerce (backend)
Stack: Node.js 20, TypeScript, Express 4, Prisma 5, PostgreSQL 16
Testes: Jest + Supertest — sempre rode os testes após mudanças
Deploy: Railway via GitHub Actions (branch main)
Convenção de commits: Conventional Commits em inglês (feat, fix, chore...)
Diretório de trabalho: /home/ubuntu/api
Regras importantes:
- Não altere o schema Prisma sem perguntar primeiro
- Sempre crie testes para novas rotas
- Logs com winston — não use console.log em produção
Refinador IA
O Refinador IA faz até 8 perguntas sobre seu projeto e gera o contexto automaticamente.
Como usar:
- Ao criar ou editar um projeto, clique em Refinar com IA
- Responda as perguntas (nome, objetivo, stack, convenções...)
- O contexto é gerado e você pode editar antes de salvar
O refinador também pode sugerir um agente personalizado adequado ao tipo de projeto.
Atualizando o contexto
O contexto pode ser editado a qualquer momento:
- No card do projeto, clique em ⚙️
- Edite o campo de contexto
- Salve — o novo contexto será usado a partir da próxima sessão
Dica
Mantenha o contexto conciso. Um contexto muito longo consome tokens desnecessariamente. Foque nas informações que o agente realmente precisa em toda conversa.