Memória, skills e regras

Como dar contexto duradouro ao agente com memória do projeto, skills, prompts, hooks e regras, e como ele aprende com os próprios erros.

O agente não começa do zero a cada conversa. Ele lembra o que é importante no projeto, carrega procedimentos conforme a tarefa e segue as regras da sua equipe.

Tudo é gerenciado no painel do projeto, aba Agente, com as subabas Skills, Prompts, Hooks, Regras e Instalar. No topo, você escolhe o escopo: Platform (o agente do Yuli) ou Assinaturas (Claude Code, Kiro, Codex e Antigravity).

Memória do projeto

O que o agente deve lembrar: instruções, decisões, convenções e dados do projeto.

Salvar: diga “lembre que…” no chat ou adicione manualmente.
Ver e editar: cabeçalho do chat → Mais ações → Memória do projeto.
Onde fica: .ai/memory/, versionável com o projeto.

Grupo	Exemplo
Instruções	“Responda sempre com exemplos em Java 17.”
Decisões	“Usamos arquitetura hexagonal no módulo de pagamentos.”
Convenções	“Os DTOs terminam em `Dto` e ficam em `api/dto`.”
Dados do projeto	“O perfil local usa a base `orders_dev`.”

As entradas que chegam com o repositório aparecem como “do repositório — não confirmado” e não são enviadas ao modelo até que você as confirme. Assim, um repositório de terceiros não pode dar instruções ao agente.

Memória da equipe

A memória compartilhada da equipe fica em .ai/team.json, versionada com o projeto. Ela pode ser vista em Opções globais → Equipe.

Skills

Uma skill é um procedimento que o agente carrega apenas quando a tarefa precisa dele. O Yuli traz 19 incluídas:

Área	Skills
Código	Explicar código, Implementar funcionalidade, Refatoração segura, `refactor-or-evolve`
Testes	Escrever testes unitários, Estratégia de testes
Qualidade e revisão	Revisão de código, Revisão de segurança, Revisão de integração
Diagnóstico	Depurar até a causa raiz, Corrigir erros de build, `gradle-java-build`
Design	Análise de requisitos, Design de arquitetura, `ui-ux-design`
Dados	Explorador de banco de dados
Documentação	`document-system` (documentar o sistema sob demanda), `sdlc-documentation`
Git	Mensagem de commit

As skills incluídas são Somente leitura e são atualizadas com o aplicativo. Para adaptar uma, use Duplicar para personalizar.

Skills próprias

Crie as suas na subaba Skills ou importe-as com Importar skills, prompts e hooks. O Yuli aceita SKILL.md, PROMPT.md, comandos do Claude Code, .prompt.md do Copilot e hooks.json.

Suas skills, prompts e hooks são salvos na sua pasta de usuário (no Windows, %APPDATA%\.yulicode\), para acompanhar você em todos os seus projetos.

Como se combinam

Em Configuração do agente:

Modo	O que usa
Automática	Só o que é do Yuli.
Personalizada	Só o que é seu.
Recomendada + as minhas (padrão)	Ambos. Se um nome coincidir, o seu prevalece.

Prompts

Os prompts são as instruções base do agente: identidade, ciclo de vida de tarefas grandes, líder da equipe, sub-agente… O Yuli os traz calibrados. Você pode duplicá-los e ajustá-los.

Os prompts internos estão em inglês para maior precisão e menos tokens. A resposta sai sempre no idioma de quem escreve.

Hooks

Um hook intercepta uma ação do agente: por exemplo, formatar o que foi modificado ou validar uma proposta antes de aplicá-la. Os scripts são Node.js, recebem o evento em JSON, e um código de saída diferente de zero bloqueia a ação. O motivo do bloqueio chega ao agente para que ele ajuste o plano.

Evento	Quando
Antes de usar uma ferramenta	Antes de cada ferramenta.
Depois de usar uma ferramenta	Depois de cada ferramenta.
Ao concluir uma proposta	Quando o agente termina de propor uma alteração.
Antes de autorizar	Antes que você aprove.
Depois de aplicar alterações	Quando a alteração chegou ao disco.

O Yuli inclui hooks prontos: Bloquear comandos perigosos, Não ler segredos, Proteger arquivos sensíveis, Sem segredos no código, Sem marcadores de conflito e Sem arquivos gigantes.

Regras do projeto

As regras são instruções que o agente sempre segue naquele projeto.

Arquivo	Escopo
`.agentrules`, `yuli.md` ou `.cursorrules` na raiz	O projeto inteiro.
`.agentrules` em uma subpasta	Essa pasta. O arquivo mais próximo prevalece.
`.ai/rules/*.md`	Regras da equipe.

Na subaba Regras: + Criar .agentrules, Regras recomendadas e Importar pacote (.zip).

Regras aprendidas

O Yuli aprende com os erros repetidos. Quando um mesmo achado aparece 3 vezes ou mais em pelo menos 2 tarefas dentro de 30 dias, ele se torna uma regra em .ai/rules/learned.md.

Revise-as na Central de Governança → Agentes → Aprendizado. Você pode rejeitar uma candidata; ela só volta a ser proposta se a evidência dobrar.

Para o seu agente de assinatura

No escopo Assinaturas, cada agente tem sua seção com o arquivo de regras que o Yuli entrega a ele, seu estado e “O que o Yuli entrega”: as regras da sessão e cada skill do Yuli com seu custo em tokens.