Agentes de codificación de IA y AGENTS.md

Los asistentes de programación con IA — Claude, GitHub Copilot, Cursor y otros — pueden construir y personalizar un portal PowerPortalsPro con mucha más precisión cuando entienden las convenciones del framework. Para que eso sea automático, cada proyecto generado a partir de una plantilla de PowerPortalsPro incluye un AGENTS.md archivo en su raíz.

¿Qué es AGENTS.md?

AGENTS.md es un archivo de instrucciones Markdown simple que las herramientas de codificación de IA leen automáticamente para aprender las convenciones de un proyecto antes de escribir código. Es un estándar emergente entre herramientas — el mismo archivo es recogido por Claude, GitHub Copilot, Cursor y otros — así que mantienes un solo conjunto de guías, no una por herramienta. Las plantillas de PowerPortalsPro generan un AGENTS.md sistema adaptado al framework para que un agente sepa ensamblar características a partir de componentes y servicios del framework en lugar de gestionar manualmente el acceso, autenticación o lógica de guardado.

Nota

La guía es específica de la pila: un proyecto generado a partir de la plantilla de React shippa un enfoque AGENTS.mdenfocado en React, y un proyecto Blazor lanza uno centrado en Blazor. Cada uno describe los componentes, servicios y patrones para esa pila.

Donde vive

El archivo está en la raíz de la solución generada, junto a tus proyectos, así que cualquier herramienta de IA abierta en el repositorio lo encuentra sin configuración:

¿Qué hay dentro?

El generador AGENTS.md destila las convenciones que cubre este sitio de documentación en una referencia siempre en contexto que un agente lee en cada tarea:

• Reglas de oro — no gires manualmente el acceso a datos, la autenticación o la lógica de guardado; vincular editores a un contexto de registro; Nunca codear colores o cadenas orientadas al usuario.
• Arquitectura y diseño de proyectos : cómo encajan los proyectos anfitriones y clientes y dónde se encuentran tus páginas y componentes.
• Patrones de datos y edición — carga de registros, el modelo de contexto de registro + editor de campos, y los componentes de la cuadrícula.
• Una referencia compacta de componentes — los props/parámetros para los componentes que más alcanzas, con punteros a tipos e IntelliSense para el resto.
• Seguridad — filtrar los datos en la fuente para una paginación y rendimiento precisos; Los gestores de permisos son la capa de aplicación.
• Localización y tematización — las convenciones de las claves de cadena y las reglas de design-token.
• Flujo de trabajo de desarrollo y cosas que se entienden: cómo ejecutar el proyecto y los errores que hay que evitar.

Usándolo eficazmente

Algunos hábitos que sacan el máximo provecho de la guía:

• Deja que el agente lo lea primero. La mayoría de las herramientas se cargan AGENTS.md automáticamente; si no, señala a tu asistente antes de pedir una función.
• Apuéstate en tipos e IntelliSense. La guía es deliberadamente concisa — para toda la superficie de cualquier componente o servicio, el agente puede leer las definiciones de TypeScript (React) o IntelliSense (Blazor) en XML-doc.
• Consulta este sitio. Apunta al agente a los ejemplos en vivo y a la referencia de la API aquí en la demo para patrones que pueda copiar.
• Revisa la salida. La guía hace que un agente sea más preciso, pero no reemplaza tu revisión — revisa especialmente las reglas de seguridad generadas y el filtrado de datos.

Por ejemplo, una petición como esta proporciona a un agente todo lo necesario para producir código idiomático:

Hazlo tuyo

AGENTS.md es un archivo ordinario en tu repositorio — edítalo. Añade tus propias tablas y relaciones, reglas de dominio, convenciones de nombres y patrones específicos de cada proyecto para que el agente aprenda tu portal, no solo el framework. Cuanto mejor refleje el archivo tu base de código, mejor será el código generado.

Propina

Trátalo AGENTS.md como documentación viva: cuando establezcas una nueva convención o cometas un error recurrente, añade una línea al archivo para que cada futura sesión de IA se beneficie.