Cómo funciona Repo Standards

Escribe tu configuración una vez. Tu agente la aplica en cada repositorio. Esta página cuenta con palabras la breve historia de la página de inicio, explica qué hacen la CLI y tu agente, nombra las herramientas que encajan mejor en algunos casos y expone los límites actuales.

Cada repositorio, configurado a su manera

Los repositorios son distintos. Cada uno reúne sus propias instrucciones para agentes, guía de contribución, README, plantillas de issues y comprobaciones, escritas en otro momento y por otra mano. Nada los mantiene alineados, así que una convención acordada en un repositorio se copia a mano en el siguiente, o allí se olvida.

Escribe la configuración una vez

Una fuente de estándares es una configuración publicada y versionada: instrucciones para agentes, documentación, plantillas y comprobaciones, escritas una vez en un repositorio público de GitHub y publicadas como versiones. Una fuente puede ofrecer perfiles para distintos tipos de repositorio. Repo Canon es una configuración lista para empezar, con convenciones de documentación, contribución, flujo de trabajo con agentes y GitHub. También puedes escribir y publicar la tuya.

Tu agente la aplica

La adopción aplica una versión fijada. Pide a tu agente que ejecute un comando con la URL de la fuente, o ejecútalo tú en una terminal:

npx @lutzseverino/repo-standards adopt https://github.com/OWNER/STANDARDS

La ejecución elige una versión y un perfil, los registra en .repo-standards/, donde fija esa versión y la CLI que la ejecutó, y aplica la versión al repositorio. Una parte del trabajo es exacta y otra requiere criterio sobre tu repositorio; quién hace qué las separa. Todos los cambios quedan sin commit para que los revises. La guía para adoptar una fuente de estándares recorre los dos caminos.

Todos iguales, y así se mantienen

Las actualizaciones mueven la versión fijada. Cuando la fuente publica una versión más reciente, outdated lo indica, y volver a ejecutar adopt mueve la versión fijada y aplica la nueva; la revisas y haces commit como en la primera adopción. Los repositorios con la misma versión fijada llevan la misma configuración, y cada uno conserva el contenido que le pertenece. Decidir si actualizar y cuándo sigue siendo cosa tuya, salvo que elijas que se te proponga cada actualización.

Quién hace qué

La CLI

La CLI resuelve desde GitHub la versión fijada, instala los archivos y las skills exactos de la fuente, instala las reglas que estos deben seguir cumpliendo y ejecuta las correcciones y comprobaciones de la fuente. Los archivos exactos sustituyen el contenido con seguimiento en sus rutas: una edición de un archivo instalado no sobrevive a una actualización. Una sobrescritura que descarta ediciones necesita confirmación previa, y el contenido sin seguimiento en una de esas rutas, que Git no puede recuperar, detiene la ejecución. La CLI nunca hace commit.

Tu agente

Tu agente hace el trabajo contextual. Lee las pautas de la fuente, averigua cuáles de tus archivos cubren y adapta solo el contenido que pertenece a tu proyecto, como su documentación, según las reglas que la fuente dejó por escrito. Deja los archivos exactos a la CLI, y el proyecto sigue siendo dueño de lo que adapta.

Tú

Tú eliges la fuente y pides la adopción. Antes de hacer commit, revisas el alcance que encontró tu agente y cada cambio del diff sin commit, con el flujo de trabajo habitual de tu proyecto. Con un agente, durante la ejecución solo necesitan tu respuesta una elección de perfil sin resolver o la sobrescritura de un ajuste remoto.

Actualizaciones

Las actualizaciones llegan cuando vuelves a ejecutar adopt, o con la acción de actualización opcional, una acción de GitHub que propone todas las actualizaciones disponibles en una sola pull request que se va renovando, al estilo de un bot de dependencias. Nunca fusiona nada: revisas y fusionas su pull request como cualquier otra.

Cuándo encaja mejor otra cosa

Otras herramientas también comparten una configuración, y para estos casos son mejor opción.

Repo Standards encaja con una configuración compartida que es sobre todo prosa y procesos, aplicada en muchos repositorios de formas distintas, donde una parte son archivos exactos y otra requiere criterio sobre cada repositorio, y que se mantiene al día con actualizaciones que tú revisas.

Límites actuales