platform-skills
El repositorio platform-skills le enseña a cada agente de código cómo trabajar en Airframe. Una skill es un conjunto de instrucciones que un agente de código carga cuando su tarea coincide: dónde va un cambio, cómo funciona el catálogo, qué forma tienen las raíces de un producto, cómo se nombran las cosas, qué rechaza cada regla de política y qué hacer en su lugar. Cada skill viene con pruebas que ejecutan las verificaciones reales de la plataforma, así que una skill que deja de coincidir con las reglas falla aquí antes de confundir a alguien.
Para qué sirve
Sección titulada «Para qué sirve»Un agente de código que no conoce las reglas de la plataforma las aprende por el camino lento: escribe un cambio, el pipeline lo rechaza, lee el mensaje y lo intenta otra vez. Las skills le dan las reglas desde el principio, así que su primer intento suele ser el correcto. Son las mismas reglas que una persona lee en estas páginas, escritas para que un agente de código actúe sobre ellas.
Qué contiene
Sección titulada «Qué contiene»Cinco skills, cada una una carpeta con sus instrucciones, SKILL.md, y sus pruebas:
airframe-platform: cómo un cambio se convierte en infraestructura, desdeairframe validatehasta producción, y qué no hace nunca un agente de código. Es la que hay que cargar primero.airframe-catalog: los archivos del catálogo, lo que se deriva de ellos, quién aprueba qué, y los mensajes de las verificaciones del catálogo con sus correcciones.airframe-infra: las raíces de un producto, los módulos del golden path, y lo que los módulos no cubren.airframe-naming: cómo se nombra cada recurso, nombre de host, etiqueta y prefijo de estado.airframe-policies: cada regla de política, su nivel, su mensaje tal como se imprime, y la alternativa correcta.
Una persona instala una skill con un comando por skill, y las instrucciones para un agente de código del repositorio de un producto apuntan a ellas. Hay más skills previstas, como una para servicios y otra para pipelines, a medida que sus módulos y reglas se asientan.
Cómo se conecta
Sección titulada «Cómo se conecta»- Se prueba contra el paquete de políticas. Los ejemplos de una skill son raíces de Terraform, archivos de pipeline, Dockerfiles, entradas del catálogo y resúmenes de costo que el paquete de políticas,
terraform validateo las verificaciones del catálogo deben aceptar o rechazar, con el mensaje que cita la skill. - Fija una versión. Las pruebas se ejecutan contra el paquete de políticas en el commit de control-plane de la versión que fijan las skills, y una versión nueva las vuelve a ejecutar antes de quedar permitida.
- Nombra rutas reales. Una prueba verifica que las rutas de repositorio enumeradas en el
tests/referencesde una skill existan en la rama main de ese repositorio, así que un archivo movido rompe la skill aquí y no en el trabajo de un agente de código.
Quién lo cambia, y cómo
Sección titulada «Quién lo cambia, y cómo»Los cambios son merge requests aprobados por el equipo de plataforma, con la aprobación de la compuerta obligatoria; este fue el primer repositorio que la compuerta exigió, el 2026-09-28. El pipeline ejecuta cuatro trabajos: skills:policy, skills:validate, skills:catalog y skills:references, y GitLab integra un cambio solo cuando pasan.
Hay dos límites que conviene conocer. Cuatro de las cinco skills traen ejemplos que estos trabajos verifican; airframe-platform todavía no trae ninguno: solo se verifican las rutas que nombra, no lo que dice sobre el comportamiento de la plataforma. Y si un agente de código carga o no una skill depende del agente y de quien lo usa: las verificaciones de la plataforma se aplican igual.
El repositorio no tiene raíces y no cuesta nada mientras no se usa.
Dónde está
En el repositorio platform-skills: