project-starter-template-es-ai
AGENTS.md15 starsChanged 2 months agoMITView on GitHub
Instrucciones para los agentes de codificación con IA que trabajan en este repositorio. [Una o dos líneas sobre qué es y qué hace este proyecto.] La documentación completa vive en docs/ — este archivo es su único índice; léelo antes de un trabajo no trivial. architecture/ vs conventions/: architecture/ responde qué construye este proyecto (su modelo de datos, su API, sus pantallas); conventions/ responde cómo se trabaja (cómo se testea, cómo se despliega, cómo se manejan secretos). Ambas se rellenan…
- Reads credentials
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 32,671 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository20 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accessibility-auditSkill
- actualizar-plantillaSkill
- changelogSkill
- commitSkill
- configurar-repoSkill
- copywritingSkill
- design-system-auditSkill
- i18n-paritySkill
- identidadSkill
- instanciarSkill
- migration-guardSkill
- new-adrSkill
- new-specSkill
- open-issueSkill
- open-prSkill
- portar-cambioSkill
- prototipoSkill
- releaseSkill
- seo-auditSkill
The file
We split this AGENTS.md into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 108
No reformatees código no relacionado ni hagas cambios masivos fuera de la tarea.
≈ “Common” is an estimate: at least 1 in 5 of the 41,581 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!--
Instrucciones canónicas para agentes de [NOMBRE_DEL_PROYECTO].
Esta es la única fuente de verdad para los agentes de codificación con IA (Claude Code, Copilot,
Cursor, etc.). CLAUDE.md importa este archivo. Manténlo conciso (<150 líneas) e
incluye solo guía no evidente y específica del proyecto — las personas leen el README.
-->AGENTS.md — [NOMBRE_DEL_PROYECTO]
Instrucciones para los agentes de codificación con IA que trabajan en este repositorio.
Resumen del proyecto
[Una o dos líneas sobre qué es y qué hace este proyecto.] La documentación completa vive
en docs/ — este archivo es su único índice; léelo antes de un trabajo no trivial.
Mapa del repositorio (lee esto primero)
| Necesitas saber… | Lee |
| Cómo trabajar aquí sin revisar código | docs/conventions/ai-agents.md |
| El ciclo de trabajo, de la spec al release | docs/conventions/workflow.md |
| Por qué existe el producto y cómo se paga | docs/product/business-model.md |
| Qué está hecho y qué viene después | docs/product/roadmap.md |
| Qué stack se eligió aquí | docs/architecture/stack.md |
| Cómo está construido el sistema | docs/architecture/architecture.md |
| Modelo de datos | docs/architecture/database.md |
| Autenticación y permisos | docs/architecture/auth.md |
| Contrato de la API | docs/architecture/api.md |
| Qué pantallas hay y por dónde va cada una | docs/architecture/screens.md |
| Cómo escribimos código | docs/conventions/ |
| Por qué se tomaron las decisiones | docs/decisions/ |
| Identidad visual y tokens | design/ |
| El sistema de diseño, para agentes de IA | DESIGN.md |
architecture/vsconventions/:architecture/responde qué construye este proyecto (su modelo de datos, su API, sus pantallas);conventions/responde cómo se trabaja (cómo se testea, cómo se despliega, cómo se manejan secretos). Ambas se rellenan al instanciar — la diferencia no es "reusable vs propio" sino la pregunta que contestan. Cuando un tema no da para las dos preguntas, vive en un solo documento (la auth entera está enarchitecture/auth.md, reglas incluidas); solo la base de datos conserva el par, y cada regla vive en un único lado.
Por qué
design/no está dentro dedocs/:docs/es lo que se lee para construir;design/se consume —design/tokens.csslo importa el CSS de la aplicación. Cuando el proyecto tenga aplicación, su contenido migrará dentro de ella (app/assets/) y en la raíz quedará solo su guía.
Remítete siempre a
docs/conventions/para el estilo y las reglas — son la fuente de verdad, no tus suposiciones previas.
Configuración y comandos
[COMANDO_INSTALAR_DEPENDENCIAS] # instalar dependencias
[COMANDO_INICIAR_DESARROLLO] # ejecutar localmente
[COMANDO_TEST] # ejecutar la suite de pruebas
[COMANDO_LINT] # lint / formatoAcuerdo de trabajo
- Acompaña activamente. Pregunta ante ambigüedad de alcance o prioridad en vez de
asumir; sugiere lo que la persona no pidió pero necesitará. La prioridad la marca
docs/product/roadmap.md. El ciclo completo está endocs/conventions/workflow.md. - Sin spec no hay cambio (obligatorio). Toda funcionalidad o corrección
(
feat/*,fix/*) nace de una spec enspecs/con el mismo slug que la rama (créala con/new-speco delega en el subagentearchitect), y suproposal.mddeclara qué ítem del roadmap completa. El hookspec-guardrails.shlo garantiza: sin spec —o con unproposal.mda medio rellenar— no se puede editar código. - Sigue Git Flow. Las ramas de trabajo (
feat/…,fix/…,docs/…,chore/…) nacen SIEMPRE dedevelop, nunca demain(solohotfix/*parte demain). Sidevelopno existe, créala desdemainy publícala antes de cualquier trabajo. ConsultaCONTRIBUTING.md. Nunca hagas commit directamente amainni adevelop. El hookgit-guardrails.shbloquea las violaciones. - El código se escribe en inglés. Variables, funciones, clases, archivos,
tablas, columnas y rutas van en inglés, sin importar el idioma del proyecto o de
la conversación. El español queda para los commits, los comentarios, la
documentación de
docs/y los textos visibles para la persona usuaria (vía i18n). - Conventional Commits.
type(scope): summary. Añade la línea de coautoría de IA para los commits asistidos por IA (consultadocs/conventions/ai-agents.md). - Issues y PRs con plantilla. Al crear un issue o un pull request, usa SIEMPRE las
plantillas de
.github/(ISSUE_TEMPLATE/yPULL_REQUEST_TEMPLATE.md) y respeta el branching deCONTRIBUTING.md. Las skills/open-issuey/open-prlo hacen por ti. - Pruebas con cada cambio. Sigue
docs/conventions/testing.md. - "Terminado" tiene definición. Antes de dar un cambio por hecho, repasa
docs/conventions/definition-of-done.md. - Mantén la documentación sincronizada. Actualiza los
docs/correspondientes yCHANGELOG.md; registra las decisiones notables como un ADR endocs/decisions/.
Reglas estrictas — nunca hagas esto
- Nunca dejes un cambio sin documentar: todo cambio actualiza
CHANGELOG.mdy losdocs/afectados en el mismo PR, y toda spec implementada marca su ítem endocs/product/roadmap.md; toda decisión notable deja un ADR. Un cambio sin documentación no está terminado — el jobchangelogdequality.ymllo verifica en cada PR. - Nunca hagas commit de secretos ni de valores reales de
.env. ConsultaSECURITY.mdydocs/conventions/secrets.md. - Nunca inventes dependencias, archivos ni APIs — verifica primero que existen.
- Nunca edites código en una rama
feat/*/fix/*sin su spec enspecs/, ni crees ramas de trabajo desdemain— esas dos reglas las bloquean los hooks. - Nunca eludas las comprobaciones de autorización ni debilites la seguridad para que algo funcione.
- Nunca hagas push a
mainni force-push a ramas compartidas. - No reformatees código no relacionado ni hagas cambios masivos fuera de la tarea.
Asistentes de IA y herramientas
- Este archivo es el contexto canónico y el índice único de la documentación. Los
archivos específicos de cada herramienta (
CLAUDE.md, etc.) apuntan aquí. - Los subagentes viven en
.claude/agents/y las skills en.claude/skills/. Las entrevistas y todo lo que requiera preguntarle algo a la persona van en una skill: un subagente corre en su propio contexto y no tiene forma de preguntar nada. - Método de trabajo, dónde verificar y dónde fallas en silencio:
docs/conventions/ai-agents.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

