Saltearse al contenido

Pods Architecture Skill

Arquitectura de Pods

La arquitectura de pods es un enfoque escalable para organizar proyectos frontend agrupando código relacionado (componentes, estilos, lógica y tests) en unidades autocontenidas llamadas pods. Cada pod representa una funcionalidad o área de dominio, lo que hace que las bases de código sean más fáciles de navegar, mantener y escalar a medida que los proyectos crecen.

Para aprender más sobre el patrón de arquitectura de pods y cómo se aplica a proyectos frontend, consulta el post completo:

🔗 Arquitectura de Pods: Islas de código para proyectos frontend escalables


Skill de Content Island para Pods (AI Tools)

Definición del skill (fuente de la verdad)

🔗 https://github.com/content-island/content-island-ai-skill/blob/main/astro-pods/skill.md

Este archivo es la fuente autoritativa del skill de IA de Content Island para Pods. Define exactamente cómo las herramientas de IA deben estructurar, organizar y trabajar con proyectos basados en pods.


Content Island proporciona una definición de skill para IA que permite a las herramientas de desarrollo asistidas por IA trabajar con el patrón de Arquitectura de Pods en proyectos Astro.

Este skill está diseñado para evitar alucinaciones y garantizar que todo el código y las estructuras de proyecto generadas estén estrictamente basadas en la documentación oficial de la arquitectura de pods.


Qué hace este skill

El skill de Arquitectura de Pods indica a las herramientas de IA que deben:

  • Crear estructuras de proyecto siguiendo el patrón de pods
  • Agrupar componentes, estilos, lógica y tests relacionados en pods autocontenidos
  • Seguir las convenciones de nombres y estructura de carpetas definidas en la documentación oficial
  • Evitar inventar o adivinar patrones de organización que no estén documentados

La precisión siempre tiene prioridad sobre la completitud.


Herramientas de IA compatibles

El skill puede ser utilizado por herramientas de IA que soportan archivos de instrucciones externas o a nivel de repositorio, incluyendo:

  • GitHub Copilot (Chat, Inline, Copilot Workspace)
  • Claude Code
  • Otras herramientas de IA para desarrollo que soporten instrucciones personalizadas

Al estar definido de forma declarativa en Markdown, el comportamiento es consistente entre herramientas y compartido por todo el equipo.


Por qué existe

Las herramientas de IA son muy potentes, pero cuando se estructuran proyectos, una suposición incorrecta sobre la organización puede llevar a código inmantenible.

Este skill existe para garantizar que:

  • Las estructuras de proyecto generadas sigan el patrón de arquitectura de pods
  • La organización del código coincida siempre con la documentación oficial
  • Los desarrolladores puedan confiar en las respuestas de la IA al configurar o extender proyectos basados en pods

En resumen:

Sin documentación → sin respuesta.