Ajustar las instrucciones para agentes

Qué vale la pena ponerle

No necesitas un documento largo. Apunta a las cosas que un agente, de otro modo, adivinaría — y anota qué ganas con ello.

Declara tu stack en una línea

Nombra la versión de tu framework, cómo funciona la autenticación y tu base de datos. El agente deja de asumir defaults: no recurre a la librería de auth equivocada ni a la base de datos equivocada.

Di cómo correr pruebas, lint y CI

Detalla los comandos y que el trabajo no está hecho hasta que pasen en verde. El agente verifica sus propios cambios en vez de devolver código que nunca corrió.

Lista las trampas que muerden en tu stack

Captura las fallas no obvias que ya enfrentaste. El agente las esquiva en lugar de redescubrir cada una a las malas.

Fija las convenciones que te importan

Anota tu estilo de pruebas, la voz de los mensajes de error y los patrones a evitar. El resultado coincide con tu estilo a la primera, con menos idas y vueltas en revisión.

Apunta a tu conocimiento y tus docs

Enlaza a dónde viven las decisiones y a los docs de referencia que importan. El agente lee el contexto existente antes de inventar un patrón nuevo.

Di qué plugin manda en cada área

Indícale al agente que se apoye en los plugins especializados de abajo para sus dominios. El revisor adecuado mira el código que le toca.

Plugins recomendados para Rails

Maquina publica un conjunto de plugins de Claude Code que le enseñan a los agentes las convenciones de Rails. No todos le quedan a toda app: instala según tu stack.

Una app nueva sobre todo el stack de Maquina aprovecha los cuatro. Una app existente debe elegir según lo que de verdad usa.

Las descripciones completas, los servidores MCP que los acompañan y la guía de instalación están en la documentación de AI Tools.

Cómo instalarlos

Agrega el marketplace una vez y luego instala los plugins que quieras. Esto se corre en Claude Code:

/plugin marketplace add maquina-app/rails-claude-code
/plugin install rails-simplifier@maquina
/plugin install maquina-ui-standards@maquina
/plugin install better-stimulus@maquina
/plugin install recuerd0@maquina

Para compartir los mismos plugins en un equipo, déjalos en el .claude/settings.json de tu repositorio:

{
  "extraKnownMarketplaces": {
    "maquina": {
      "source": { "source": "github", "repo": "maquina-app/rails-claude-code" }
    }
  },
  "enabledPlugins": [
    "rails-simplifier@maquina",
    "maquina-ui-standards@maquina",
    "better-stimulus@maquina",
    "recuerd0@maquina"
  ]
}

Ponlos a trabajar en tus instrucciones

## Convenciones de código
Antes de dar el trabajo por terminado, deja que el subagente
correspondiente revise el código que cambiaste:
- rails-simplifier:simplify — Ruby y Rails
- maquina-ui-standards:ui — vistas, formularios, design tokens
- better-stimulus:better-stimulus — controladores Stimulus
Aplica sus hallazgos; no repitas sus reglas aquí.

## Definición de terminado
1. Corre tus pruebas y el linter hasta que pasen; corrige en la raíz.
2. Deja que los subagentes de arriba revisen el código que cambió, y vuelve a correr.
3. Guarda decisiones y gotchas clave con recuerd0:remember.

## Conocimiento del proyecto
Usa recuerd0:remember para guardar decisiones, gotchas y
preferencias conforme surjan, y busca en tus memorias guardadas
antes de asumir o inventar un patrón nuevo.

Claude Code lee este archivo como guía, no como reglas estrictas, así que mantenlo conciso y específico. Recórtalos a tu stack: quita la línea de maquina-ui-standards o de better-stimulus si tu app no las usa, y renombra las secciones según cómo ya escribas el archivo.

Mantén una base de conocimiento