tawasuyu

sergio/takana

> Una distribución Linux construida con un laboratorio funcional y hermético en el > sótano, y una terminal mutable, clásica y anárquica en el piso de arriba — diseñada > desde el suelo para que una IA programadora entienda, modifique y co…

TOML 1534Shell 199Rust 109Markdown 993713 Sutichaykuna

⎇ 42288230f9560814e356586d8b9eeb36747b95fc docs/README.md Markdown · 33 siq'ikuna · 2.0 KB Ñawpa willay ch'uya

Scaffold inicial: workspace Rust + SDDs completos 8bf162304 · sergio · 

1# Documentación de diseño de hammer
2
3Estos documentos son la fuente de verdad del diseño. El código los implementa; cuando haya
4discrepancia, o se corrige el código o se actualiza el SDD con un commit que explique por qué.
5
6## Software Design Documents (SDD)
7
8| # | Documento | Qué cubre |
9|---|---|---|
10| 00 | [Visión y filosofía](00-vision.md) | Por qué existe, qué problema resuelve, la actitud de ingeniería |
11| 01 | [Arquitectura general](01-architecture.md) | El modelo de dos mundos, componentes, flujo de datos |
12| 02 | [El laboratorio de build](02-build-lab.md) | Sandbox, `zig cc`, recetas, CAS, grafo de dependencias |
13| 03 | [Hidratación y store](03-hydration.md) | Store content-addressed, hardlinks a FHS, patchelf, rollback |
14| 04 | [Overlay de experimentación](04-overlay.md) | overlayfs en caliente, try/commit/discard |
15| 05 | [Diario de mutaciones](05-journal.md) | fanotify, log append-only, config-sin-ser-declarativa |
16| 06 | [Formato `.swm`](06-swm-format.md) | Manifiesto de mutación compartible, esquema, firma |
17| 07 | [Bus de init y de agente](07-agent-bus.md) | `/run/init.control`, `/run/agent.sock`, protocolo |
18| 08 | [Integración de la IA](08-ai-integration.md) | El bucle agéntico, seguridad, intención → `.swm` |
19| 09 | [Modelo de confianza](09-trust-model.md) | Reproducibilidad, verificar-no-confiar, log de transparencia |
20| 10 | [Roadmap](10-roadmap.md) | Fases, MVP, primer entregable |
21
22## Architecture Decision Records (ADR)
23
24Decisiones tomadas, con su contexto y consecuencias. Ver [`adr/`](adr/).
25
26| # | Decisión |
27|---|---|
28| 0001 | [Rust para el tooling y daemons](adr/0001-rust-for-tooling.md) |
29| 0002 | [Validar sobre Alpine antes de la distro propia](adr/0002-alpine-first.md) |
30| 0003 | [`zig cc` como compilador por defecto del lab](adr/0003-zig-cc-builder.md) |
31| 0004 | [No escribir nuestro propio Nix](adr/0004-no-custom-nix.md) |
32| 0005 | [Hidratación por hardlinks](adr/0005-hardlink-hydration.md) |
33| 0006 | [Commits fijados, no HEAD vivo](adr/0006-pinned-commits.md) |

README.md

Documentación de diseño de hammer

Estos documentos son la fuente de verdad del diseño. El código los implementa; cuando haya discrepancia, o se corrige el código o se actualiza el SDD con un commit que explique por qué.

Software Design Documents (SDD)

#DocumentoQué cubre
00Visión y filosofíaPor qué existe, qué problema resuelve, la actitud de ingeniería
01Arquitectura generalEl modelo de dos mundos, componentes, flujo de datos
02El laboratorio de buildSandbox, zig cc, recetas, CAS, grafo de dependencias
03Hidratación y storeStore content-addressed, hardlinks a FHS, patchelf, rollback
04Overlay de experimentaciónoverlayfs en caliente, try/commit/discard
05Diario de mutacionesfanotify, log append-only, config-sin-ser-declarativa
06Formato .swmManifiesto de mutación compartible, esquema, firma
07Bus de init y de agente/run/init.control, /run/agent.sock, protocolo
08Integración de la IAEl bucle agéntico, seguridad, intención → .swm
09Modelo de confianzaReproducibilidad, verificar-no-confiar, log de transparencia
10RoadmapFases, MVP, primer entregable

Architecture Decision Records (ADR)

Decisiones tomadas, con su contexto y consecuencias. Ver adr/.

#Decisión
0001Rust para el tooling y daemons
0002Validar sobre Alpine antes de la distro propia
0003zig cc como compilador por defecto del lab
0004No escribir nuestro propio Nix
0005Hidratación por hardlinks
0006Commits fijados, no HEAD vivo