Hacer el repo AI-native

[ArielParra]

Qué hay que hacer

Configurar el repo del blog con todas las herramientas, archivos y
convenciones necesarias para que colaboradores puedan usar agentes IA
(Claude Code, OpenCode, Antigravity, Kiro, etc.) de forma efectiva y sin fricción.

Por qué

Los colaboradores que usen IA para modificar el blog necesitan que el
agente entienda profundamente el proyecto: estructura, convenciones,
relaciones entre archivos y contexto del club.

Herramientas a integrar

GitNexus

Motor de inteligencia de código que expone la estructura del repo via MCP.

• Relaciones entre posts, layouts y archivos JS
• Call chains y detección de dependencias
• Integración con Cursor y Claude Code

MCP Servers

• GitHub MCP — leer issues, PRs y estructura del repo
• Filesystem MCP — navegar y editar archivos localmente
• Fetch MCP — consumir endpoints de la API estática
• Memory MCP — persistencia de contexto entre sesiones

Graphify

Visualización del grafo de conocimiento del repo: relaciones entre posts,
tags, autores y secciones.

Memoria persistente

Archivo .memory/context.md versionado en el repo con:

• Decisiones de arquitectura y su justificación
• Convenciones no obvias del proyecto
• Estado actual de áreas en desarrollo
• Roles y contactos del equipo

Archivos a crear o actualizar

• .cursor/rules o .cursorrules — reglas para Cursor
• .claude/ — configuración para Claude Code
• .cursor/mcp.json — MCP servers configurados
• AGENTS.md — expandir con stack completo y flujo agentico
• .memory/context.md — memoria inicial del proyecto
• docs/ai-workflow.md — guía de uso para colaboradores

Contenido mínimo de las rules

• Convenciones de posts (front matter, nombres de archivo, idioma)
• Rutas importantes y su propósito
• Qué NO tocar sin revisión humana (_config.yml, CI/CD, layouts base)
• Cómo y cuándo hacer fetch() a la API
• Cómo correr htmlproofer antes de proponer cambios

Listo cuando...

• .cursorrules creado y probado — agente puede crear un post sin errores de convención
• AGENTS.md actualizado con stack completo
• MCP servers configurados y documentados en .cursor/mcp.json
• GitNexus configurado y detectando relaciones del repo
• Graphify configurado con el contenido del blog
• .memory/context.md poblado con contexto inicial
• docs/ai-workflow.md publicado con ejemplos de prompts útiles
• Un colaborador nuevo puede seguir la guía sin ayuda externa
• Enlazado desde README y CONTRIBUTING.md