Compilação de práticas avançadas de Agentic Engineering para uso de…

INEMA

e ai usa os doc de referencias

Basico

cria o PRD, e salve os documentos e sempre limpe com /clear

dublado

Aqui vão hacks práticos de Agentic Engineering, direto do espírito de Organização— coisas que pouca gente faz, mas que mudam totalmente o jogo 👇

🧠 Hacks de Contexto (os mais importantes)⌗

1️⃣ Planeje longo, execute curto⌗

Planejamento pode ter conversa longa
Execução sempre após ****/clear****
Regra de ouro:

Planejamento = humano + IA Execução = IA focada

2️⃣ 1 plano = 1 feature⌗

Nunca execute duas coisas no mesmo plano.

Se misturar → alucinação
Feature grande? Quebre em planos menores

3️⃣ O plano é o contrato⌗

Durante execução:

❌ não discutir
❌ não explicar de novo
✅ só executar o plano

Se algo mudou → novo plano + reset

⚙️ Hacks de Commands⌗

4️⃣ Tudo vira command⌗

Critério simples:

Escreveu o mesmo prompt 2x → vira command

Exemplos pouco óbvios:

/fix-tests
/sync-prd
/post-mortem
/system-evolve

5️⃣ Command de “auto-crítica”⌗

Crie um command que sempre pergunte:

O que divergiu do plano?
O que quebrou regra?
O que melhorar no sistema?

Isso é system evolution automatizada.

📁 Hacks de Arquivos⌗

6️⃣ Regras globais ≤ 200 linhas⌗

Se passar disso:

Estão erradas
Quebre em /reference/*

7️⃣ Reference docs podem ser gigantes⌗

1.000+ linhas ✔
Só são carregados quando necessário
Melhor lugar para:
Fluxos complexos
Auth
Edge cases

🐞 Hacks de Bugs⌗

8️⃣ Todo bug gera um ativo⌗

Bug nunca é “só um bug”. Ele vira:

Nova regra
Novo command
Nova checklist no plano

Sem isso → bug volta.

9️⃣ Checklist anti-alucinação⌗

No plano, sempre inclua:

Arquivos afetados
Imports esperados
Comportamento proibido

Isso reduz erro drasticamente.

🚀 Hacks de Produtividade⌗

🔟 Pergunta mágica diária⌗

Depois do prime:

“Com base no PRD, qual a menor feature útil que podemos construir agora?”

Isso evita overengineering.

1️⃣1️⃣ Menor unidade possível⌗

Prefira:

5 planos pequenos em vez de
1 plano grande

IA funciona melhor em incrementos curtos.

1️⃣2️⃣ Evolução > Prompt perfeito⌗

Se você está:

Reescrevendo prompts toda hora ❌
Ajustando sistema raramente ❌

Você está jogando errado.

🧩 Hack mental final (o mais importante)⌗

Você não está usando uma IA. Você está construindo um sistema que usa IA.

Um conjunto bem definido de arquivos, cada um com uma função específica dentro do sistema agentic. Abaixo está exatamente essa estrutura de arquivos + para que serve cada um 👇

📁 Estrutura de arquivos (e funções)⌗

1️⃣ PRD.md⌗

Função: North Star do projeto

Define o que será construído
Escopo completo do produto
Base para decidir qual feature vem depois

Conteúdo típico:

Missão
Usuários-alvo
In scope / Out of scope
Arquitetura
Features

📌 Usado em:

Planejamento
Prime
Decisão de próximas features

2️⃣ claude.md / agents.md (Regras Globais)⌗

Função: Regras que valem sempre

Carregado no início de toda conversa
Deve ser curto e leve

Contém:

Tech stack
Estrutura do projeto
Convenções de código
Estratégia de testes
Logging
Comandos básicos

📌 Não deve conter regras específicas de feature

3️⃣ /reference/ (Regras Modulares / Contexto Específico)⌗

Função: Contexto profundo por tipo de tarefa

Só lido quando necessário
Pode ser grande (centenas de linhas)

Exemplos de arquivos:

api.md → padrões de API
frontend.md → padrões de UI / componentes
auth.md → fluxo de autenticação
db.md → modelos e migrations
deploy.md → CI/CD e infra

📌 Referenciado pelo claude.md

4️⃣ /commands/ (Workflows)⌗

Função: Automatizar prompts repetidos

Cada arquivo é um processo reutilizável
Reduz erro humano e inconsistência

Exemplos:

create-prd.md
prime.md
plan-feature.md
execute.md
commit.md
code-review.md
validate.md

📌 Tudo que você escreve mais de 2 vezes vira um command

5️⃣ plan-.md (Plano Estruturado)⌗

Função: Contrato entre planejamento e execução

Gerado ao final do planejamento
ÚNICA entrada usada na execução

Contém:

Descrição da feature
User story
Arquivos afetados
Passos de implementação
Critérios de sucesso
Testes esperados

📌 Usado após context reset

6️⃣ execução sem contexto⌗

Função: Garantir foco e raciocínio

Nova conversa ou /clear
Claude recebe somente o plano
Sem PRD, sem histórico, sem conversa

📌 Maximiza capacidade de reasoning

7️⃣ system-evolution.md (implícito)⌗

Função: Aprender com erros

Não é sempre um arquivo formal
Pode virar:
Nova regra
Novo command
Novo reference doc

Exemplo:

Claude errou import → nova regra
Esqueceu testes → atualizar plano
Errou auth → criar auth.md

🧠 Mapa mental rápido⌗

PRD.md ↓ claude.md (global) ↓ reference/*.md (quando necessário) ↓ commands/*.md ↓ plan-feature.md ↓ /clear ↓ execute.md ↓ system evolution

💡 Frase-chave⌗

Não corrija o bug. Corrija o sistema que permitiu o bug.

Uma estrutura/sistema de trabalho bem clara para usar o Claude Code (ou qualquer coding agent). A estrutura é esta 👇

Estrutura usada pelos engenheiros agentic⌗

PRD First Development

Criar primeiro um PRD (Product Requirements Document) em markdown
Esse documento vira o north star do projeto
Serve para quebrar o sistema em features pequenas

Prime (carregar contexto)

No início de cada conversa, rodar um prime command
Carrega:
- PRD
- Estrutura do projeto
- Regras globais
- Depois disso, a pergunta padrão é:
“Com base no PRD, o que devemos construir agora?”

Arquitetura modular de regras

Regras globais leves (agents.md / claude.md)
Regras específicas separadas em arquivos:
- API
- Frontend
- Auth
- Deploy
- As regras específicas só são carregadas quando necessárias

Commandificação (workflows)

Tudo que você escreve mais de 2 vezes vira um command
Exemplos:
- Criar PRD
- Planejar feature
- Executar feature
- Commit
- Code review
- Validação
- Commands = prompts reutilizáveis em markdown

Planejamento → Context Reset → Execução

Planeja a feature
Gera um plano estruturado (markdown)
Limpa o contexto (/clear ou nova conversa)
Executa passando somente o plano
Nada de conversa longa durante execução

System Evolution (a mais importante)

Não corrigir só o bug
Corrigir o sistema que permitiu o bug
Ajustes possíveis:
- Regras globais
- Regras específicas
- Commands
- Estrutura do plano
- O agente fica mais inteligente com o tempo

Resumo em uma frase⌗

PRD → Prime → Planejar → Limpar contexto → Executar → Evoluir o sistema

github.com/coleam00/habit-tracker ↗

Aqui está como “limpar a memória” ou contexto no Claude Code (referente ao que o vídeo menciona como context reset para começar uma nova tarefa com o assistente):

✅ 1. Comando básico: `/clear`⌗

No Claude Code, você pode digitar apenas ****/clear**** no terminal ou na interface de chat.
Isso apaga toda a conversa/contexto acumulado na janela atual, começando “com a mente limpa” para a próxima tarefa — exatamente o que o vídeo recomenda para separar planejamento de execução.

👉 Observação: Às vezes pode haver um bug onde parte do contexto reaparece após enviar novos prompts, mas em muitos casos ainda funciona para limpar a história de conversas recentes.

✅ 2. Reiniciar totalmente o Claude Code⌗

Se quiser fazer uma limpeza ainda mais forte do que /clear:

Feche e abra novamente o cliente/terminal onde está rodando o Claude Code.
Isso reinicia a sessão inteira, apagando todo o contexto carregado na memória de curto prazo daquela instância.

❗ Importante: Contexto vs. “memória persistente”⌗

Existem dois conceitos diferentes:

🧠 Contexto ativo

É o que Claude “lembra” da conversa atual — o que /clear e reiniciar limpam.

📁 Memória do Claude (persistente entre sessões)

Claude pode armazenar informações permanentes, como preferências ou dados importantes, em arquivos como CLAUDE.md ou pelo recurso de memória oficial da Anthropic, dependendo da sua conta e configuração.
Isso não é apagado por ****/clear****, só removido se você editar ou deletar esses arquivos/entradas manualmente ou desativar o recurso de memória nas configurações da Claude.

📌 Em resumo:

****/clear**** e reiniciar limpam a memória de curto prazo (contexto da conversa atual).
Memória persistente (como arquivos CLAUDE.md ou memória de conta) precisa ser gerenciada manualmente se você quiser apagar ou alterar.

5 técnicas que separam os melhores Engenheiros Agentic

Apresento 5 práticas-chave para extrair muito mais valor de assistentes de código com IA (como Claude, Cursor etc.), focando em processo, contexto e evolução do sistema, não em novas ferramentas.

PRD First (Product Requirements Document) Antes de codar, crie um PRD em markdown que defina todo o escopo do projeto.

Serve como north star do agente.
Ajuda a quebrar o trabalho em features menores.
Vale tanto para projetos novos (greenfield) quanto existentes (brownfield).

Prime Command (carregar contexto certo) Sempre comece uma conversa “primando” o agente com o contexto essencial do projeto (código, PRD, estrutura). Depois, basta perguntar: “Com base no PRD, o que devemos construir agora?”
Arquitetura modular de regras

Regras globais devem ser curtas e leves.
Regras específicas (API, frontend, auth, deploy) ficam em documentos separados.
O agente só carrega regras detalhadas quando necessário, preservando o contexto.

Commandificar tudo (workflows reutilizáveis) Qualquer prompt usado mais de duas vezes deve virar um comando. Exemplos: criar PRD, planejar feature, executar código, commits, code review, validações. → Ganha consistência, velocidade e reutilização.
Context Reset entre planejamento e execução

Planeje a feature → gere um documento estruturado.
Limpe o contexto (nova conversa).
Execute usando apenas esse documento. Isso libera espaço mental/contextual para o agente raciocinar melhor ao codar.

Evolução do sistema (a mais importante) Não conserte só o bug — conserte o sistema que permitiu o bug.

Ajuste regras, comandos ou documentos de referência.
Trate erros recorrentes como oportunidades de melhorar o agente. Com o tempo, o agente fica mais confiável e poderoso.

Mensagem central: Os melhores engenheiros agentic focam menos em “promptar melhor” e mais em processos, documentação, gestão de contexto e melhoria contínua do sistema.

1% Engenehiro de Agentic

chatgpt.com ↗