convez.ai
AgenteProdutividadeIntermediário
alberthoba

Kit Contexto Agentes

alberthoba/kit-contexto-agentes

Templates de contexto reutilizáveis para agentes IA multi-plataforma

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto de templates mínimas para configurar agentes de IA (Claude, Gemini, Codex, Cursor) com contexto coeso em todos os projetos. Define identidade, stack técnico, convenções e memória de projeto em arquivos reutilizáveis que os agentes carregam automaticamente.

Instalação

$npx convez-ai alberthoba/kit-contexto-agentes

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Padronizar instruções de agentes entre diferentes projetos e máquinas
  • Manter histórico de decisões técnicas e feedback em memória viva do projeto
  • Centralizar sistemas de design e conventions sem duplicação
  • Configurar Claude Code, Gemini, Codex e Cursor com contexto idêntico

Veredito

Kit pragmático que resolve um problema real: sincronizar contexto entre agentes e projetos sem overhead. Filosofia clara (mapa, não biblia) e implementação minimalista. Falta documentação em português e exemplos mais detalhados de integração.

README

A tradução para o português deste README ainda está na fila.

kit-contexto-agentes

Kit mínimo de plantillas para configurar agentes de IA (Claude Code, Gemini, Codex, Cursor) de forma coherente en todos tus proyectos.

Un kit sencillo que sujeta a cualquier agente a tu identidad, tu forma de trabajar y el contexto del proyecto — sin tener que reescribirlo cada vez.

Qué contiene

Las plantillas viven en global/:

ArchivoPara qué sirveDónde vive una vez pegado
CLAUDE.mdContexto global del usuario. Quién eres, cómo trabajas, principios de código, reglas de secretos. Una sola vez por máquina.~/.claude/CLAUDE.md
AGENTS.mdContexto estable del proyecto. Stack, comandos, mapa del repo, convenciones, reglas duras. Una copia por proyecto.Raíz del proyecto
MEMORY.mdÍndice de memoria viva. Apunta a archivos feedback_* / project_* / reference_* con cosas aprendidas durante el trabajo. Opcional.Raíz del proyecto
DESIGN.mdSistema de diseño del proyecto. Tokens, lenguaje visual, componentes. Opcional, recomendable si el proyecto tiene UI con sistema propio.Raíz del proyecto

Guías de estilo (ejemplo)

Junto a las plantillas, el repo incluye guia-estilo.md — mi guía personal de estilo de escritura (voz, ritmo, reglas concretas anti-IA). No es plantilla: es la guía real que cargo como contexto cuando trabajo en tareas de texto.

Está aquí como ejemplo de cómo rellenar la sección "Estilo de escritura" del CLAUDE.md global. Si tienes una propia, sustitúyela. Si no, parte de ésta y adáptala.

Referencia desde tu CLAUDE.md global con ruta absoluta:

## Estilo de escritura

- 📖 **Estilo Base**: `/ruta/al/repo/guia-estilo.md`
  Voz, ritmo, filosofía, léxico. Para cualquier formato de texto.

Filosofía

  • Mapa, no biblia. Las plantillas son índices navegables, no manuales para leer de cabo a rabo.
  • Multi-agente por defecto. Las plantillas están pensadas para que un solo archivo sirva a cualquier agente (Claude, Gemini, Codex, Cursor). La sección "Cómo usar" explica cómo enlazarlo para cada uno.
  • Sin scaffolding obligatorio. Sin scripts, sin JSONs, sin estructura de carpetas forzada. Pegar y rellenar.
  • No duplicar el global. Cada plantilla asume lo que ya saben los agentes desde el global y solo añade lo específico de su capa.
  • Cuándo este archivo miente. Las plantillas envejecen. Cada una incluye una pauta para que el agente verifique contra el código y avise si hay discrepancias.

Cómo usar

1. Contexto global (una sola vez por máquina)

mkdir -p ~/.claude
cp global/CLAUDE.md ~/.claude/CLAUDE.md

Rellena los [ADAPTAR: …] con tu identidad, idioma, nivel técnico y guías de estilo externas si las tienes.

Para que Gemini comparta el mismo global:

mkdir -p ~/.gemini
ln -s ~/.claude/CLAUDE.md ~/.gemini/GEMINI.md

Un solo archivo fuente, varios agentes leyendo lo mismo. Sin riesgo de divergencia.

2. Por cada proyecto nuevo

Tres modos según los agentes que vayas a usar en ese proyecto:

Modo A — Solo Claude Code:

cp /ruta/al/repo/global/AGENTS.md ./CLAUDE.md

Renombras la plantilla a CLAUDE.md directamente. Claude Code la auto-carga.

Modo B — Multi-agente (Claude + Gemini + Codex + Cursor):

cp /ruta/al/repo/global/AGENTS.md ./AGENTS.md
ln -s AGENTS.md CLAUDE.md         # Claude Code
ln -s AGENTS.md GEMINI.md         # Gemini (Antigravity, VS Code)
mkdir -p .cursor/rules            # Cursor
ln -s ../../AGENTS.md .cursor/rules/agents.mdc

AGENTS.md canónico, symlinks para los demás agentes.

Cursor no auto-carga AGENTS.md; lee reglas desde .cursor/rules/*.mdc (o un .cursorrules legacy en la raíz). El symlink anterior expone el mismo contenido sin duplicarlo.

Modo C — Patrón oficial Anthropic con import:

cp /ruta/al/repo/global/AGENTS.md ./AGENTS.md
echo "@AGENTS.md" > CLAUDE.md

CLAUDE.md es un archivo de una sola línea que importa AGENTS.md con la sintaxis oficial. Equivalente al symlink pero más explícito.

Rellena los [ADAPTAR: …] del AGENTS.md con la información real del proyecto.

3. Memoria persistente (opcional)

Si quieres mantener un índice manual de cosas aprendidas durante el trabajo:

cp /ruta/al/repo/global/MEMORY.md ./MEMORY.md

A partir de ahí, el agente crea archivos feedback_*.md / project_*.md / reference_*.md según haga falta y los indexa en MEMORY.md.

Para tener el formato exacto de cada tipo de archivo a mano, hay esqueletos en global/memory-templates/ — uno por tipo (user, feedback, project, reference) con frontmatter YAML y patrón Why: / How to apply: listos para rellenar.

Nota: Claude Code tiene además un sistema oficial de "auto-memory" en ~/.claude/projects/<proyecto>/memory/ que gestiona el propio agente. Coexiste con MEMORY.md sin conflicto.

4. Sistema de diseño (opcional)

Si el proyecto tiene UI con sistema propio (tokens, tipografía, componentes):

cp /ruta/al/repo/global/DESIGN.md ./DESIGN.md

Y referénciarlo desde AGENTS.md para que el agente lo lea cuando toque diseño:

# AGENTS.md
…
## Diseño
Para temas visuales, lee [DESIGN.md](DESIGN.md) — sistema canónico de tokens, lenguaje y componentes.

O, alternativamente, importarlo con @DESIGN.md en alguna sección del AGENTS.md.

Convenciones internas

  • [ADAPTAR: …] marca un hueco que tienes que rellenar al pegar la plantilla.
  • Las secciones marcadas como opcional se borran si no aplican.
  • En MEMORY.md, las entradas en negrita son las que el agente debe leer al arrancar.
  • En MEMORY.md, las entradas obsoletas se mueven a la sección "Archivo" en lugar de borrarse.
  • Política de poda: revisar MEMORY.md ~una vez al mes y mover lo superado al Archivo.
  • En DESIGN.md, los comentarios HTML (<!-- … -->) traen ejemplos del estilo. Se borran al rellenar.

Cadena de mando

Si un AGENTS.md de proyecto contradice tu CLAUDE.md global, manda el de proyecto. El global da contexto por defecto; el proyecto define excepciones específicas.

Créditos

Este repositorio está basado en el trabajo original de Álvaro Sánchez:

https://github.com/genteinvencible/arnes-agentes

Se han realizado pequeñas adaptaciones para facilitar su uso como plantilla reutilizable en proyectos personales.

Licencia

MIT

Ver o original no GitHub

Bom para

Relacionados