Imported from Gunz-cop/CuidaTuPerroViejo (
AGENTS.md). Install upstream withnpx skills add Gunz-cop/CuidaTuPerroViejo. Copyright stays with the author.
AGENTS.md
Instrucciones compartidas para agentes de código (Claude Code, Codex, Antigravity u otros) que trabajen en este repositorio.
Migración de stack en curso
El sitio está migrando de Astro 4 a Astro 7 sobre Cloudflare Workers. Antes de tocar package.json, astro.config.mjs, wrangler.jsonc, tsconfig.json o los estilos globales, leé docs/migracion-stack/README.md: es la spec de producto y dice qué fase toca, contra qué rama va y qué está decidido.
Dos reglas de esa migración que valen para cualquier trabajo en el repo mientras dure:
maindespliega a producción. Cloudflare Workers Builds está conectado al repositorio. Las fases de versión van contra la rama de integraciónmigracion/astro-7, nunca contramain.- El hook npm
postbuildfue eliminado. Los builds ya no envían URLs a la Google Indexing API ni a IndexNow. Para compilar de forma explícita, usánpx astro build; el CI hace eso.
El método —qué rompe en cada salto, cómo se verifica que un upgrade no rompió el sitio— no vive en este repo: vive en la skill compartida upgrade-astro-cloudflare (Proyectos/Generalidades, instalada en ~/.claude/skills/), porque es la misma para los ocho repos Astro pendientes. Aquí solo vive la evidencia de esta migración.
Enlazado interno del sitio
Cuando el usuario pida revisar, mejorar, reorganizar o documentar el enlazado interno de cuidatuperroviejo.com, usa la skill .agents/skills/enlazado-interno-sitio/SKILL.md. Esta skill mantiene la arquitectura de silos, los puentes entre artículos y los enlaces a herramientas.
La implementación vive principalmente en src/data/internal-links.ts y src/components/SiloNavigation.astro. Las reglas y el mapa operativo están documentados en docs/seo/enlazado-interno.md. Antes de modificar enlaces, revisa esos tres recursos y valida con npm run build.
Herramientas interactivas
Cuando el usuario pida crear, rediseñar o mejorar una herramienta o app del pilar /herramientas (calculadora de edad, calidad de vida HHHHHMM, selector de movilidad o una nueva), usa .agents/skills/crear-herramienta-interactiva/SKILL.md: evidencia revisada por pares verificada una a una, tono cálido, lógica compartida en src/lib/, diseño responsive con animaciones CSS, tarjeta para compartir, página con método y fuentes, e inventario de agentes. La referencia viva es la calculadora de edad (src/lib/dog-age.ts, src/components/tools/DogAgeTool.astro).
Para revisar una herramienta ya hecha, usa .agents/skills/auditar-herramienta-interactiva/SKILL.md. Igual que con los artículos: quien crea no audita y quien audita no corrige.
Redacción de contenido de blog
Antes de generar un briefing o redactar/auditar un artículo de blog para cuidatuperroviejo.com, lee el control compartido de calidad editorial y consulta las skills en .agents/skills/. La extensión se justifica por utilidad, los casos requieren procedencia y cada recurso prometido debe funcionar. Máximo tres auditorías por documento; si la tercera falla, detener y revisar con el usuario.
Skills del flujo:
.agents/skills/generar-briefing-contenido/SKILL.md— genera el briefing de planificación de un artículo (fuentes científicas, estructura H2/H3, enlazado interno, contrato de entrega). Úsalo cuando el usuario pida un brief, un briefing, o planificar un artículo nuevo..agents/skills/redactar-articulo-blog/SKILL.md— toma ese briefing y redacta el artículo.mdxfinal ensrc/content/blog/, respetando la arquitectura real del sitio Astro (componentes, layout automático, schema del frontmatter). Úsalo cuando el usuario pida redactar, escribir o convertir un brief en artículo..agents/skills/crear-animaciones-articulo-blog/SKILL.md— produce imágenes continuas de perros senior, recortes realistas, infografías y animaciones didácticas integradas en Astro/MDX. Úsalo cuando el usuario pida esos recursos o mejorar su calidad. Conserva anatomía y edad visible, y valida móvil, modo oscuro, accesibilidad y proyección Markdown. La referencia aprobada es el dogo senior del artículo de baño; su raza y su tema no son valores universales para otros artículos..agents/skills/auditar-briefing-contenido/SKILL.md— audita un briefing ya generado contra las reglas de la skill generadora, como revisor externo: fuentes verificadas una a una (PMID/DOI/URL profunda contra el tema atribuido), trazabilidad fuente→H2 sin fuentes decorativas, metadatos contados, enlazado interno contra el inventario, componentes, arco narrativo, prompts de imagen y límite brief vs. redacción. Úsalo cuando el usuario pida revisar, auditar o validar un brief; antes de redactar desde un brief que otra sesión generó; o cuando una auditoría de artículo descubra un fallo que nació en el brief. Es una skill de evaluación: no corrige el brief..agents/skills/auditar-articulo-blog/SKILL.md— audita un.mdxya redactado contra el brief que lo encargó, como revisor externo: volumen y distribución por H2, densidad de párrafo, fuentes que respalden de verdad su afirmación, autoría real, enlazado, imágenes y frontmatter. Úsalo cuando el usuario pida revisar, auditar o validar un artículo, o comprobar el reporte de otra sesión. Es una skill de evaluación: no corrige el artículo.
Separa los roles. Quien genera no audita, quien redacta no audita, y quien audita no corrige: el que corrige adquiere un interés en que su corrección sea la buena y deja de poder evaluarla. Si hace falta corregir, hazlo en una sesión aparte a partir de las instrucciones del informe.
Orden recomendado del flujo: generar brief → auditar brief → redactar artículo → auditar artículo. Auditar el brief antes de redactar es más barato que descubrir el fallo en el artículo: un PMID mal asignado o un enlace inexistente en el contrato se propaga a todo lo que se escriba después. Si una auditoría de artículo encuentra un error de fuente, comprueba si nace en el brief con la skill de auditoría de briefing.
Sigue el flujo descrito en esos archivos en vez de improvisar la estructura del brief o del artículo desde cero.
