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>
This commit is contained in:
@@ -0,0 +1,61 @@
|
||||
# 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
|
||||
|
||||
```markdown
|
||||
# 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](0001-gitbutler-experiment.md) | Experimento con GitButler para trabajo paralelo | rejected |
|
||||
Reference in New Issue
Block a user