# sof-format

> La especificación canónica del formato `.sof`: la sintaxis con la que se materializa el pensamiento por capas en archivos que cualquier agente lee.

**División:** SoF Systems · **Tipo:** spec / formato · **Estado:** 🟡 estable (canónico)

## Qué es

sof-format es la **spec del `.sof`**: el contrato del formato de archivo que materializa la doctrina SoF. Define la sintaxis, la línea mágica de dialecto y los dialectos disponibles. Es la referencia normativa — la regla escrita que toda herramienta del ecosistema obedece al leer o escribir un `.sof`.

Recuerda: el `.sof` es el **formato de archivo**, distinto de SoF (la doctrina) y de ShoF (el lenguaje de UI).

## Qué hace

- Especifica la **línea mágica** que abre todo archivo `.sof` y declara su dialecto y versión.
- Cataloga los dialectos disponibles y qué comportamiento implica cada uno.
- Sirve de contrato entre quien escribe `.sof` y quien lo lee o lo resuelve.

## Por qué cambia el juego

Sin un formato común, cada herramienta y cada agente inventa su propia manera de guardar y pasar contexto — y nada se entiende entre sí. sof-format pone **un solo estándar** debajo de todo el ecosistema: un archivo que es a la vez legible por humanos y reconstruible por máquinas, con su dialecto declarado en la primera línea. Es la pieza que hace que SoF deje de ser una idea y se vuelva interoperable.

## Dónde vive
- Es la spec que implementan el resolver de SoF v5, los visores y _creator.
- Define el contrato que todo `.sof` del ecosistema FractAIll debe cumplir.

## Mapa SoF · capas y componentes

- **1 · Objetivo** — fijar un solo estándar para el formato `.sof`, de modo que toda herramienta y agente lea y escriba el mismo archivo sin inventar su propia manera (componentes: spec canónica, contrato escritor↔lector).
- **2 · Visión** — un archivo que es a la vez legible por humanos y reconstruible por máquinas, con su dialecto declarado en la primera línea (componentes: legibilidad humana, reconstrucción por máquina, declaración explícita de dialecto).
- **3 · Estructura** — la especificación normativa del `.sof`: sintaxis, línea mágica de dialecto y catálogo de dialects disponibles (componentes: sintaxis, línea mágica, catálogo de dialectos).
- **4 · Funcionamiento** — todo `.sof` abre con su línea mágica que declara dialecto y versión; cada dialecto cataloga un comportamiento distinto que la herramienta obedece al leer (componentes: parsing de línea mágica, resolución de dialecto, comportamiento por dialecto).
- **5 · Fondo** — la regla escrita que sostiene la interoperabilidad; en términos generales, la referencia normativa que implementan otras piezas, sin lógica ejecutable propia (componentes: norma de referencia, base de implementación).
- **6 · Distribución** — la implementan el resolver de **SoF v5**, los visores y **_creator**; se distribuye como spec/contrato que viaja con el ecosistema **SoF** y el lenguaje **ShoF** (componentes: adopción por resolver, visores, _creator).

**Lectura fractal:** tomá la **línea mágica**. Su objetivo es que un agente sepa leer el resto del archivo con solo mirar la primera línea; su visión, imitar `#!/bin/bash` —una marca de apertura universal—; su estructura, una sola línea al tope con dialecto y versión; su funcionamiento, ser leída antes que nada para elegir el modo de parseo; su fondo, el acuerdo de que esa línea es obligatoria; y su distribución, viajar en cada `.sof` del ecosistema sin excepción.