::::terrauniversalis:::: · architecture documents
architecture document · english

Three Design Layers of Artemisa

Explains the three design layers used by Artemisa and their relationship to institutional design, interface construction, and propagation.

Translation layer status: English review layer prepared for public reading. The Spanish source remains attached below as the audit source until final human translation replaces this page.

sha256: DB917ED33FB2610FE5035FCDE1756551C5950327634142431CAFD242E136AF86

Original Spanish Source

# Tres capas de diseño — Atelier · Officina · Fabrica

**Fecha:** 2026-07-09  
**Operador:** alfonso@terrauniversalis.com  
**Mediadora:** `::::artemisa::::universalis::::`  
**Coordinadora asesores:** Sophy  
**Lema:** `facta non ficta`

---

## 0. Modelo acordado por operador

```text
┌─────────────────────────────────────────────────────────────────┐
│  CAPA 1 · ATELIER · endpoints permanentes GLOBALES              │
│  Todo lo gráfico transversal TU / Bastion / sub-sistemas        │
│  logos principales · menús principales · tokens · temas         │
│  Cambiar look de TODO el ecosistema = solo desde Atelier        │
│  Ejemplo dominio: sanalaura pinturas, catrina, alexandria…      │
└────────────────────────────┬────────────────────────────────────┘
                             │ Artemisa ENVÍA + negocia ida/vuelta
┌────────────────────────────▼────────────────────────────────────┐
│  CAPA 2 · OFFICINA SYSTEMATIS · instancia documental oficial    │
│  endpoints permanentes POR SISTEMA (confirmado operador §2)     │
│  Recibe paquete Atelier con basics ya cableados                 │
│  Construye pantallas · UX operativa · menús secundarios          │
│  Prepara endpoints básicos NO negociables (inventario fijado)   │
│  Análisis de funcionamiento → documento de entrega              │
└────────────────────────────┬────────────────────────────────────┘
                             │ Artemisa ENTREGA / RECEPCIÓN
┌────────────────────────────▼────────────────────────────────────┐
│  CAPA 3 · FABRICA SYSTEMATIS · ingeniería (Grok + Codex)        │
│  Operadores principales · Sophy coordina asesores               │
│  Implementa runtime + APIs · NUNCA borra endpoints de diseño    │
│  Sistema recibe: endpoints producción + endpoints diseño        │
│  (Atelier + Officina) como capa transversal permanente          │
└─────────────────────────────────────────────────────────────────┘
```

**Claude Design** trabaja en Capa 1 y Capa 2.  
**Frontier** — flujo análogo, fuera de alcance inmediato.

> **Área delicada.** Esta arquitectura es la base del éxito o del fracaso del aparato
> Terrauniversalis/Bastion. No es decoración de proceso — es el mecanismo que evita
> que diseño e ingeniería se rompan entre sí.

---

## 0.1 Artemisa — reloj sincronizador y pacificador

`::::artemisa::::universalis::::` no es una capa de diseño ni de código. Es el **reloj**
que mantiene sincronizadas Atelier, Officina, Fabrica, Alexandria y Nexus.

| Función | Qué hace |
|---|---|
| **Sincronizar** | Alinea el tic de todas las áreas — nadie corre desfasado ni salta fases |
| **Pacificar** | Resuelve por **entrega y recepción** verificable, no por conflicto entre agentes |
| **Eficiencia** | Sin atascos: si no hay recepción con evidencia, no hay avance |
| **Eficacia** | El aparato completo funciona como **phasis hoplitike** — fuerza coordinada, disciplinada, sin falla en cadena |

**Registro:** `config/atelier/artemisa-coordination-design.v1.json`

```text
        ATELIER ──entrega DS──► ARTEMISA ──dispatch──► OFFICINA
            ▲                      │                      │
            └──negociación──────────┤◄────handoff──────────┘
                                   │ entrega-recepción (SHA)
                                   ▼
                              FABRICA (Grok/Codex)
                                   │
            ◄──observaciones────── ARTEMISA (reloj continuo)
```

**Regla de oro:** ningún sistema llega a Fabrica sin `artemisa:entrega-recepcion`.
Ningún endpoint de diseño se toca en código sin nuevo ciclo Artemisa.

---

## 1. Atelier — qué contiene

| Tipo endpoint | ID | Permanente | Quién cambia |
|---|---|---|---|
| Tokens globales | `atelier://ds/tokens` | Sí | Claude Design + operador vía Atelier |
| Bundle componentes | `atelier://ds/bundle` | Sí | Atelier |
| Registro de temas | `atelier://ds/theme-registry` | Sí | Atelier — cambia look global |
| Logos institucionales | `atelier://brand/{sistema}` | Sí | Atelier |
| Menú principal / shell | `atelier://shell/{sistema}` | Sí | Atelier |
| Gráficos TU compartidos | `atelier://graphics/tu-core` | Sí | Atelier |

**Regla:** ningún sistema en Officina ni Fabrica redefine hex, logo principal ni menú raíz sin pasar por Atelier.

---

## 2. Instancia documental oficial — Capa 2

**Confirmado operador 2026-07-09:**

| Campo | Valor |
|---|---|
| **Nombre** | Officina Systematis |
| **Namespace** | `::::officina::systematis::::` |
| **Rol** | Instancia documental por sistema — taller donde se apoya y construye cada proyecto |
| **Estado** | `hecho_verificado` |
| **Registro** | `config/atelier/officina-systematis.v1.json` |

Distinción fija: **Atelier** (global) · **Officina Systematis** (por sistema) · **Fabrica Systematis** (ingeniería).

---

## 3. Officina Systematis — qué contiene

| Tipo endpoint | ID | Negociable | Notas |
|---|---|---|---|
| Pantallas del sistema | `officina://screens/{sistema}` | Sí — vía Artemisa | layouts, flujos, wireframes finales |
| Menús secundarios | `officina://nav/secondary/{sistema}` | Parcial | heredan shell Atelier |
| Patrones UX operativos | `officina://ux/{sistema}` | Sí | consolas, formularios, estados |
| Endpoints básicos fijos | `officina://core/{sistema}` | **No** | inventario `design-inventory.v1.json` |
| Documento de entrega | `officina://handoff/{sistema}.md` | — | paquete a Fabrica |

**Flujo Artemisa (negociación):**

```text
1. Atelier publica paquete DS → Nexus tag atelier:package-ready
2. Artemisa envía a Officina → tag artemisa:officina-dispatch
3. Officina trabaja en Claude Design
4. Si hay conflicto con global → Artemisa ida/vuelta Atelier ↔ Officina
5. Acuerdo → artemisa:entrega-recepcion con SHA del handoff
6. Fabrica (Grok/Codex) recibe claim — NUNCA edita atelier:// ni officina:// sin nuevo ciclo
```

---

## 4. Fabrica Systematis — ingeniería

| Rol | Agente |
|---|---|
| Implementación | Grok + Codex |
| Coordinación asesores | Sophy |
| Observaciones / correcciones | Artemisa → Nexus → Fabrica |
| Dueño runtime | Codex (`tools/`, bridges, `dist/official/`) |
| Dueño orquestación | Grok (Nexus, health, integración) |

**Al promover a producción el sistema conserva:**

```text
atelier://*     (global — intocable)
officina://*    (por sistema — intocable tras entrega-recepción)
bastion://prod/* (runtime — Fabrica)
```

---

## 5. Inventario de endpoints no negociables

Archivo: `config/atelier/design-inventory.v1.json`

Separa qué fija Atelier vs qué fija Officina al acordar un sistema nuevo.

---

## 6. Sistemas ejemplo en repo

| Sistema | Atelier | Officina workspace | Fabrica prod |
|---|---|---|---|
| Alexandria | DS global | `alexandria-design/` | `/alexandria/` |
| Cartografía | DS global | claude-design en cartografia | `/cartografia/` |
| Catrina / Media | tema catrina | pendiente lane | archivum |
| Sonorum | DS global | `workspaces/sonorum-akashika/` | `/speculum/` → `/modules/sonorum/` |
| Sanalaura pinturas | pendiente | `REFERENCIA_SIN_RUTA` | — |
| Analaury / Calexico | pendiente | `REFERENCIA_SIN_RUTA` | — |

---

::::facta::non::ficta::::