Forgy AI Kit

Contexto portátil para agentes de código

Troque de IA.
Não recomece do zero.

Uma camada versionada de instruções, arquitetura e decisões, agora com hooks que reconhecem cada projeto automaticamente — sem levar memórias pessoais junto.

Instalar com um comando Ver no GitHub
  • Sem telemetria
  • Hooks somente leitura
  • Windows, macOS e Linux
C
AgenteCodex
Fonte de verdade docs/ai-context/
ARCHITECTUREINVARIANTSDECISIONS
A
AgenteClaude

Dois agentes. Um contrato verificável.

Instalação

Um comando. Na pasta que você escolher.

O kit pode morar em qualquer pasta dedicada. Os adapters são registrados automaticamente onde cada agente espera encontrá-los.

v0.3.0
Recomendado para a primeira instalação. O terminal perguntará a pasta, os agentes e pedirá confirmação antes de gravar.
terminal
npx --yes https://github.com/leulfonseca/forgy-ai-kit/releases/download/v0.3.0/forgy-ai-kit-0.3.0.tgz install
Requisito: Node.js 18+ Instala: adapters, skills e hooks para os agentes escolhidos Preserva: suas regras atuais
Baixar release oficial v0.3.0 (.tgz) SHA-256 carregando…

O modelo

Memória ajuda. Contexto versionado protege.

O kit separa o conhecimento obrigatório do projeto das lembranças pessoais de cada agente.

01

Fonte compartilhada

AGENTS.md, CLAUDE.md e docs/ai-context/ viajam com o repositório e podem ser revisados no Git.

Canônico
02

Detecção automática

Um hook somente leitura localiza a raiz Git e informa se o projeto está pronto, precisa migrar contexto do Claude ou precisa ser inicializado.

Compatível
03

Memória local

Auto memory continua particular de cada usuário. O que vira regra durável é promovido para a documentação versionada.

Privado

Depois de instalar

Abra o projeto. Peça o trabalho.

O instalador configura a detecção automática. Depois da confiança inicial, você não precisa lembrar comandos ou prompts especiais em cada chat.

  1. 1

    Verifique a instalação

    Máquina

    O diagnóstico confirma adapters, skills, hooks dos dois agentes e a pasta canônica escolhida.

    npx --yes https://github.com/leulfonseca/forgy-ai-kit/releases/download/v0.3.0/forgy-ai-kit-0.3.0.tgz doctor --kit-dir "PASTA_ESCOLHIDA" --agents codex,claude
  2. 2

    Confie nos hooks uma vez

    Segurança

    Codex e Claude Code mantêm suas próprias barreiras de confiança. Revise o comando do hook antes da primeira execução.

    Codex/hooks

    Abra /hooks, revise o handler salvo em ~/.codex/hooks.json e marque a definição como confiável. Se o comando mudar numa atualização, revise novamente.

    Claude Codeworkspace trust

    Aceite a confiança do workspace quando o Claude solicitar. O handler entra em ~/.claude/settings.json sem remover seus outros hooks.

  3. 3

    Trabalhe normalmente

    Automático

    Abra o agente dentro da raiz Git e peça sua feature ou correção. O hook injeta o estado correto antes da primeira resposta.

    READY lê o contexto existente MIGRATE_REQUIRED preserva e migra o contexto Claude INIT_REQUIRED aciona forgy-ai-bootstrap e cria somente arquivos ausentes NO_GIT_PROJECT protege pastas agregadoras

    Quer conferir antes? O comando abaixo executa exatamente o mesmo detector sem gravar nada.

    npx --yes https://github.com/leulfonseca/forgy-ai-kit/releases/download/v0.3.0/forgy-ai-kit-0.3.0.tgz inspect --project-dir "CAMINHO_DO_PROJETO"

Limite de segurança

O que é contexto não precisa virar vazamento.

O instalador move contratos e workflows. Ele deliberadamente deixa dados pessoais e credenciais na máquina de origem.

✓

Entra no kit

  • Instruções globais gerenciadas
  • Hooks SessionStart somente leitura
  • Skills e workflows repetíveis
  • Templates de arquitetura e decisões
  • Scripts de diagnóstico e backup
×

Fica fora

  • Tokens, chaves e arquivos .env
  • Chats e transcripts pessoais
  • Auto memory do Codex ou Claude
  • Permissões históricas de deploy

Dúvidas comuns

Antes de rodar o comando.

Preciso criar uma pasta chamada ForgyDigital?

Não. Escolha qualquer pasta dedicada com --kit-dir. O nome Forgy identifica o produto, não uma estrutura obrigatória no seu computador.

O instalador apaga meu AGENTS.md ou CLAUDE.md global?

Não. Ele preserva o conteúdo existente e gerencia apenas o bloco delimitado pelos marcadores do Forgy AI Kit. Antes de substituir qualquer item gerenciado, cria um backup local.

Posso continuar usando somente um dos agentes?

Sim. Use --agents codex ou --agents claude. O contexto do repositório continua em Markdown e pode ser lido por outras ferramentas.

O hook altera meus projetos quando eu abro um chat?

Não. Ele apenas encontra a raiz Git, verifica arquivos conhecidos e injeta um estado no contexto do agente. Migração ou inicialização só acontece durante uma solicitação material e preserva arquivos existentes.

Quem tem a palavra final sobre uma decisão com risco?

Você. Uma instrução explícita e atual prevalece sobre recomendações, skills, memória e defaults do Forgy AI Kit. Se você reconhecer o risco e pedir continuidade, o agente deve registrar o risco e executar o pedido, sem trocar silenciosamente a solução. Políticas superiores da plataforma e limites técnicos reais continuam valendo.

Como removo a automação sem apagar o restante?

Execute o pacote com hooks remove --agents codex,claude. O kit remove somente o próprio handler, mantém todos os outros hooks e cria backup das configurações alteradas.

Por que não sincronizar a auto memory?

Memória não é fonte de verdade. Ela pode conter contexto pessoal, fatos antigos e inferências. Regras necessárias para não quebrar o projeto devem estar versionadas e revisáveis.

Seu próximo agente não precisa começar como um estranho.

Leve a inteligência.
Deixe o ruído.

Preparar minha máquina