Dar forma a tu Framework

Elegiste una semilla al empezar porque era la más cercana. En algún momento deja de encajar, y eso es lo esperable: un Framework (el marco) puede remodelar o anular cualquier parte de ella sin bifurcar el estándar.

La herramienta es configure. Edita _eidos/Framework.md, crea carpetas y archivos de shape, y reconcilia los Blueprints que ya están en disco.

Qué cambia, y qué no

`configure` sí	Usa otra cosa para
Añadir o cambiar una colección	Escribir Blueprints → `eidos`
Añadir o cambiar un flavor	El `index.md` de una colección → `index`
Añadir, renombrar o retirar una propiedad personalizada, y rellenarla retroactivamente	Subidas de versión → `migrate`
Refrescar el índice Top-Level	Las propiedades centrales de Eidos → `migrate`

Añadir una colección

El caso común: una carpeta decisions para ADRs, o Roles como contenido en lugar de como configuración del agente.

Añadir una significa responder cinco cosas, que son toda la entrevista de configure:

Su nombre, según la convención de nombres.
Una descripción de una línea de lo que contiene.
Sus flavors: al menos un shape, con uno marcado por defecto.
Cómo la dibuja el canvas: file, card o card from ## Section.
Si agrupa sus Blueprints un nivel, y en tal caso si una propiedad nombra la agrupación.

Añadir un flavor

Más barato que una colección, y normalmente la respuesta correcta cuando los Blueprints de una misma colección varían.

La convención que lo restringe: una familia de shapes por colección, declarada como flavors. Lo que flexiona es qué secciones aparecen y qué flavor usa un Blueprint, nunca su orden ni sus nombres dentro de un flavor. El shape nunca se bifurca por categoría.

Así que: una variante más ligera de la que crecer, o una alternativa deliberada, es un flavor. «Las specs de integración tienen estas cinco secciones distintas» no es un flavor: eso es otra colección, o una señal de que las secciones deberían ser opcionales dentro de un solo shape.

Dos patrones que funcionan:

Ligero → completo. micro crece hasta full. El ligero conserva lo innegociable (intención, criterios, no-objetivos) y descarta lo que puede esperar.
Variante deliberada. Dos flavors del mismo peso para tipos de unidad genuinamente distintos dentro de la misma colección, sin que ninguno sea un escalón hacia el otro.

Añadir una propiedad

configure presiona por los cuatro campos, porque una propiedad a la que le falte alguno es inservible:

Campo	Por qué es obligatorio
Name	La clave del frontmatter.
Type	Uno de `Text`, `List`, `Number`, `Checkbox`, `Date`, `Date & time`.
Applies To	`all`, o una lista. Es lo que evita que aterrice donde no tiene sentido.
Meaning	Para qué sirve. Sin eso, la gente la rellena de forma inconsistente en un mes.

Luego rellena retroactivamente los Blueprints a los que aplica la propiedad, para que la raíz siga siendo uniforme en lugar de partirse en eras de antes y después.

Antes de añadir una, comprueba tres cosas

¿Sería mejor una sección del cuerpo? Si quiere más estructura que uno de los seis tipos, pertenece al cuerpo. El estándar limita los tipos de propiedad a esos seis precisamente para forzar esta pregunta.

¿Es una etiqueta blanda o es estructural? Una categoría que dirige vistas y filtrado es una etiqueta blanda: un valor fuera de lista sigue siendo válido. Una categoría que cambia qué secciones tiene un Blueprint es un flavor, y flavor es la propiedad que lo lleva.

¿Es seguimiento de trabajo disfrazado? El estándar es absoluto aquí: nada de sprint, estimate ni assignee. Trata también con sospecha cualquier cosa que signifique «por dónde vamos»: un progress, una phase, un target_date. Conecta con tu gestor de tareas mediante un enlace.

Retirar una propiedad

También configure. Retirar es la mitad desatendida: una raíz acumula propiedades que nadie rellena, y cada una añade ruido a cada Blueprint.

Si una propiedad ha estado en blanco en los últimos veinte Blueprints, ya no forma parte de tu contrato. Quítala.

Ajustar un rol

Los archivos de rol están versionados y son ajustables por el equipo: edítalos directamente. Si tus desarrolladores quieren menos orientación, o tu rol de stakeholder está resultando demasiado técnico, cambia el archivo y lo tienen todos.

Añade un rol añadiendo un archivo. El reparto es propio de tu Framework; los repartos de las semillas son ilustraciones, no un conjunto cerrado. Más →

Dos convenciones que tener a la vista al remodelar

Cuándo vale la pena publicar un Framework

Una vez que tu Framework se ha asentado, es forma sin contenido, que lo convierte exactamente en el artefacto que entregas a otro equipo. Eso es una semilla.

Si dos productos de tu organización deberían describirse igual, publica el Framework en lugar de copiar una raíz y borrarle el contenido. Un Framework, tantas raíces como quieras.