fn_registry/docs/adr/README.md

Architecture Decision Records (ADR)

Esta carpeta guarda las decisiones de diseño importantes que afectan a fn_registry y sus apps — qué se decidió, por qué, y qué aprendimos.

No son reglas operativas (esas viven en .claude/rules/). Son historia de decisiones: útil para saber cómo llegamos al estado actual, qué experimentos descartamos y por qué no volver a tomar el mismo camino.

Formato

Un archivo por decisión. Convención de nombre:

NNNN-slug-corto.md

Donde:

• NNNN es un número incremental (0001, 0002, ...)
• slug-corto en kebab-case, descriptivo pero breve

Plantilla

# ADR NNNN — Título corto

- **Fecha:** YYYY-MM-DD
- **Estado:** proposed | accepted | rejected | superseded | deprecated
- **Supersede a:** (opcional, link a otro ADR)

## Contexto

Qué problema/pregunta/situación motiva esta decisión. Qué restricciones hay.

## Decisión

Qué se decidió hacer. Concreto y accionable.

## Alternativas consideradas

Lista breve de otras opciones y por qué se descartaron.

## Consecuencias

Cambios concretos derivados: archivos, reglas, herramientas, flujos.

## Aprendizaje (si aplica, cuando se revisita)

Qué se aprendió después. Útil cuando un ADR se supersede.

Estados

• proposed — en discusión, aún sin decidir
• accepted — decisión vigente
• rejected — se propuso y se descartó (se deja el ADR para entender por qué)
• superseded — sustituido por un ADR posterior (indicar cuál)
• deprecated — la decisión ya no aplica (contexto cambió)

Índice

#	Título	Estado
0001	Experimento con GitButler para trabajo paralelo	rejected
0002	Apps y analyses como sub-repos dataforge/<name> con branch master	accepted
0003	TU adicional de un parent function como entrada propia	accepted
0004	Telemetria de ejecuciones de Claude como motor de crecimiento del registry	accepted
0005	Mantener el .git del padre ligero: no trackear artefactos hijos, purgar historial, submódulos shallow	accepted