Files

T

egutierrez 32fc008cae docs: añadir ADR, diario, CHANGELOG y comando /entrada_diario

Infraestructura de documentación operativa y de decisiones:

- docs/adr/ — Architecture Decision Records. Incluye plantilla y
  ADR 0001 documentando el experimento y retirada de GitButler.
- docs/diary/ — diario de avances con un archivo por día.
  Primera entrada 2026-04-24.md retrocubriendo esta sesión
  (conectar aurgi-pc, dashboard fn_monitoring, funciones systemd
  locales, ADR GitButler, regla KISS).
- CHANGELOG.md — formato Keep a Changelog para cambios cara a
  usuario/agentes. Sección 2026-04-24 con Added/Changed/Fixed/Removed.
- .claude/commands/entrada_diario.md — slash command para añadir
  entradas al diario con formato consistente.

Separación:
  diary   = contexto operativo diario
  CHANGELOG = qué cambió en el código
  ADR     = por qué se decidió algo
  rules   = reglas operativas del agente

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-24 14:27:38 +02:00

1.7 KiB

Raw Blame History

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

1.7 KiB Raw Blame History