TypeDialog/docs/adr/README.md

# Architecture Decision Records

ADRs documenting key architectural decisions and their rationale for TypeDialog.

## ADR Index

- **[ADR-001: Nickel as First-Class Form Definition Format](./adr-001-nickel-form-definition.md)** —
  Nickel (`.ncl`) forms loaded via `nickel export` subprocess, replacing `ContractValidator`,
  fragment lazy-loading, and `${constraint.*}` interpolation. TOML remains supported.

## Decision Format

Each ADR follows this structure:

- **Status**: Accepted, Proposed, Deprecated, Superseded
- **Context**: Problem statement and constraints
- **Decision**: The chosen approach
- **Rationale**: Numbered list of reasons
- **Consequences**: Benefits and trade-offs
- **Implementation**: Code showing how it works
- **Alternatives Considered**: Rejected options with reasoning
feat(forms): migrate all form definitions and configs to Nickel (.ncl) Replace all TOML form definitions in examples/ and config/ with type-checked Nickel equivalents. Update cli_loader to prefer .ncl (via nickel export) over .toml in config search order. TOML support retained as fallback — no breaking change. - El loader usa nickel export --format json + serde_json como puente — evita reimplementar un parser Nickel en Rust y aprovecha el binario ya existente. - El orden de búsqueda .ncl > .toml permite migración incremental: cualquier config vieja sigue funcionando sin tocarla. - Los contratos Nickel (\| default, \| String) en los configs sustituyen la validación que antes era implícita en el parsing TOML — el error llega antes (en nickel export) con mensajes más descriptivos. 2026-03-08 23:20:50 +00:00			`# Architecture Decision Records`

			`ADRs documenting key architectural decisions and their rationale for TypeDialog.`

			`## ADR Index`

			`- [ADR-001: Nickel as First-Class Form Definition Format](./adr-001-nickel-form-definition.md) —`
			Nickel (`.ncl`) forms loaded via `nickel export` subprocess, replacing `ContractValidator`,
			fragment lazy-loading, and `${constraint.*}` interpolation. TOML remains supported.

			`## Decision Format`

			`Each ADR follows this structure:`

			`- Status: Accepted, Proposed, Deprecated, Superseded`
			`- Context: Problem statement and constraints`
			`- Decision: The chosen approach`
			`- Rationale: Numbered list of reasons`
			`- Consequences: Benefits and trade-offs`
			`- Implementation: Code showing how it works`
			`- Alternatives Considered: Rejected options with reasoning`