horcon 0.8.2a1__py3-none-any.whl

horcon/__init__.py

@@ -0,0 +1,57 @@
+# Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente
+# @ai-generated by Claude Sonnet 5 (2026-09-20); revisado por: pendiente — H02/A1: fuente única
+# de versión (reports/2026-09-20-plan-mejoras.md).
+"""Horcón: framework que genera y valida sistemas multiagente deterministas.
+
+Perfil MILPA: library. Este paquete no ejecuta agentes propios ni llama a
+ningún modelo; produce proyectos (plantilla `agent-system`) y los valida.
+"""
+
+from __future__ import annotations
+
+import sys
+from importlib import metadata as _metadata
+from pathlib import Path
+
+if sys.version_info >= (3, 11):
+    import tomllib as _tomllib
+else:  # pragma: no cover - este repo fija Python >= 3.11 (pyproject), es sólo un resguardo
+    import tomli as _tomllib  # type: ignore[no-redef]
+
+
+def _version_desde_pyproject() -> str | None:
+    """Lee ``project.version`` de ``pyproject.toml`` cuando el paquete corre desde el árbol
+    fuente (checkout de desarrollo, instalación editable).
+
+    Existe porque el ``.dist-info`` de una instalación editable puede quedar desactualizado
+    respecto de ``pyproject.toml`` (H02: `.venv` con `horcon` 0.2.3 en `pyproject.toml` pero
+    `.dist-info` congelado en 0.1.0). Cuando hay `pyproject.toml` dos niveles arriba de este
+    archivo, esa es la fuente de verdad; si no existe (paquete instalado como wheel/sdist en un
+    entorno sin el árbol fuente), no hay nada que leer y se cae al metadato instalado.
+    """
+    pyproject = Path(__file__).resolve().parents[2] / "pyproject.toml"
+    if not pyproject.is_file():
+        return None
+    try:
+        data = _tomllib.loads(pyproject.read_text(encoding="utf-8"))
+    except (OSError, UnicodeDecodeError, _tomllib.TOMLDecodeError):
+        return None
+    project = data.get("project")
+    if not isinstance(project, dict):
+        return None
+    version = project.get("version")
+    return version if isinstance(version, str) else None
+
+
+def _resolver_version() -> str:
+    desde_arbol = _version_desde_pyproject()
+    if desde_arbol is not None:
+        return desde_arbol
+    try:
+        return _metadata.version("horcon")
+    except _metadata.PackageNotFoundError:
+        # Ni árbol fuente ni distribución instalada: no se inventa un número, se marca.
+        return "0.0.0+sin-instalar"
+
+
+__version__ = _resolver_version()

horcon/__main__.py

@@ -0,0 +1,9 @@
+# Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente
+"""Permite `python -m horcon <comando>` además de `python -m horcon.cli.__main__`."""
+
+from __future__ import annotations
+
+from horcon.cli.__main__ import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

horcon/_templates/agent-system/.claude/agents/README.md

@@ -0,0 +1,10 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# .claude/agents
+
+**Para qué existe:** alojar los perfiles de meta-agentes Claude que construyen este proyecto (capa de ingeniería, ver AGENTS.md).
+
+**Qué pregunta responde:** ¿qué agente de construcción tiene permiso para tocar qué carpeta?
+
+**Qué NO hace:** ningún perfil aquí tiene manifiesto en `packages/agents/`: la capa de ingeniería está fuera de D01-D11 (system-designer.md §3).
+
+**Owner:** mantenedor

horcon/_templates/agent-system/.codex/agents/README.md

@@ -0,0 +1,10 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# .codex/agents
+
+**Para qué existe:** alojar los perfiles de meta-agentes Codex equivalentes a `.claude/agents/`, mismo contrato (AGENTS.md).
+
+**Qué pregunta responde:** ¿qué agente de construcción tiene permiso para tocar qué carpeta?
+
+**Qué NO hace:** ningún perfil aquí tiene manifiesto en `packages/agents/`: la capa de ingeniería está fuera de D01-D11.
+
+**Owner:** mantenedor

horcon/_templates/agent-system/.gitignore

@@ -0,0 +1,13 @@
+# Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente
+.env
+.env.*
+!.env.ejemplo
+tmp/runs/
+tmp/site-src/
+tmp/site/
+tmp/keyring-*/
+tmp/kill-switch/
+tmp/KILL
+__pycache__/
+*.pyc
+.pytest_cache/

horcon/_templates/agent-system/.milpa-manifest.json

@@ -0,0 +1,16 @@
+{
+  "id": "{{project_name}}",
+  "role": "agent-system",
+  "profile": "software-monorepo",
+  "level": 1,
+  "parent": "../",
+  "anchor": "pendiente",
+  "scope": "Sistema multiagente generado por horcon init: {{project_name}}",
+  "inherits": [],
+  "overrides": [],
+  "extensions": {
+    "horcon": {
+      "conformance_profile": "{{profile}}"
+    }
+  }
+}

horcon/_templates/agent-system/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# Contrato para agentes de ingeniería (capa `.claude/`, `.codex/`)
+
+Este archivo rige a los meta-agentes que **construyen** este proyecto (capa de ingeniería),
+no a los agentes de dominio que el proyecto instancia (esos viven en `packages/agents/` y se
+rigen por su manifiesto y por `packages/control/`).
+
+## Dónde sí pueden escribir
+
+- `tmp/runs/` (ignorado por git) y ramas de git, vía PR.
+- `packages/agents/`, `packages/domain/`, `packages/application/`, `docs/` — siempre vía PR
+  revisado por una persona.
+
+## Dónde NO escriben nunca
+
+- `.env` (no existe uno real en este repo; sólo `.env.ejemplo`).
+- `governance/axioms.md` — cambio de axiomas exige ADR del Anchor (ver `SOURCE.md` nivel 1).
+- Datos reales de usuarios o del dominio: este proyecto no es un lugar para datos productivos.
+- `packages/agency/registry.yaml` sin receipt humano (alta/baja es fase 2, DEC-03).
+
+## Antes de proponer un manifiesto nuevo en `packages/agents/`
+
+1. El `id` es kebab-case ASCII con sufijo de rol (`-coordinator`, `-critic`) o verbo-objeto
+   para ejecutores.
+2. `prohibited` incluye las reglas negativas mínimas del rol (ver
+   `src/horcon/agency/validator.py` en el repo `horcon`, no en este proyecto).
+3. `affects_people` es obligatorio y explícito; nunca se omite.
+4. Corre `horcon validate` antes de abrir el PR.

horcon/_templates/agent-system/README.md

@@ -0,0 +1,15 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# {{project_name}}
+
+Proyecto generado por `horcon init` (perfil `{{profile}}`, {{date}}). Sistema multiagente con
+tres capas físicas —ingeniería, host/gobernanza y dominio— separadas en el árbol de carpetas.
+
+Antes de tocar nada, lee `AGENTS.md` y `SOURCE.md`. La navegación completa de documentación
+está en [`docs/INDEX.md`](docs/INDEX.md).
+
+## Qué NO hace este proyecto por sí solo
+
+- No declara "conforme": `horcon validate` sólo comprueba estructura, nunca comportamiento.
+- No instancia agentes por el solo hecho de tener un manifiesto en `packages/agents/`: sólo
+  una entrada en `packages/agency/registry.yaml` (con receipt, fase 2) activa un agente.
+- No tiene kill switch operable ni padrón con alta/baja real (ver `packages/control/README.md`).

horcon/_templates/agent-system/SOURCE.md

@@ -0,0 +1,37 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# SOURCE.md — precedencia de fuentes de verdad
+
+Ante una contradicción entre documentos, gana el nivel más bajo. Ningún nivel puede
+contradecir a uno anterior sin un ADR que lo registre.
+
+## Nivel 0 — metodología de referencia
+
+Revisión/digest de la metodología externa (Rain), referenciada por digest, nunca copiada.
+Pendiente de asignar en este proyecto (ver `governance/decisions/`).
+
+## Nivel 1 — axiomas
+
+`governance/axioms.md`. Sólo cambian por ADR del Anchor con consulta registrada a afectados
+si el proyecto declara `affects_people: true` en algún manifiesto.
+
+## Nivel 2 — ADRs
+
+`governance/decisions/ADR-*.md`. Cada ADR aceptado debe propagarse a los niveles 3-5 o
+`horcon validate` debería señalarlo como pendiente (no automatizado en fase 1).
+
+## Nivel 3 — políticas y umbrales
+
+`governance/policies/*.md` y, cuando exista, `governance/thresholds.yaml`.
+
+## Nivel 4 — manifiestos y agencia
+
+`packages/agency/*.yaml` y `packages/agents/*/manifest.yaml`.
+
+## Nivel 5 — contratos y código
+
+`packages/contracts/`, `packages/domain/`, `packages/application/`, `packages/platform/`.
+
+## Nivel 6 — salida del modelo
+
+La salida de cualquier agente. Nunca es fuente de verdad, sólo un producto a validar en
+`checkpoint` (ver `packages/control/state-machine/session.yaml`).

horcon/_templates/agent-system/TEMPLATE-DIGEST.txt

@@ -0,0 +1,65 @@
+596c50d84ae650af06cece5329cf27ed4b383b737b4da226f694aebee7538bfa  .claude/agents/README.md
+319e709553f68b4e79c67d044ad083a9d61398beb05419f127fb8264285d6f08  .codex/agents/README.md
+1e70ad26ce26d50b2bd62690a04ed8a2bccf43e1caabcae71a269618fb461d45  .env.ejemplo
+9611d54a772032ed66f10fde6119da1f2642b791ac38c983253112345402f29e  .gitignore
+f91300fb98eb6271ba7f6cece8d2e061670047fe6763740939477f074450b14c  .milpa-manifest.json
+7f18f5cf158af9596be2f84c7219ac9af772d3cc5dd5aa6f5f0bb9049aed375a  AGENTS.md
+c1320d3b0aeab812dd49617b4aa7fa68fd9f433109e53dec3aa79581c6db3d74  README.md
+6064d755237c2e2375a67507a64310ab5e8b23f5f1312c72f39b95dcbe41f16f  SOURCE.md
+92c92fb6b85cf5b8fc14711ed2b2a97daffcc51196f4d90cedafc5a31d5d5341  TEMPLATE-DIGEST.txt
+0ced94ebfeb2577f344d18f5c7ecd7d66ab46c5228a31ce1c87520ea8198503d  apps/README.md
+96764a2f02e4ad2170c277e4429491f54120df11f5769d181c8b34013791ea82  apps/control-api/README.md
+7e4ecd8f7282557bd4295882d566ab633afe5b422e2aa82300e536dc89529ac7  apps/governance-console/README.md
+5cc6df59d203a553bbf01d11638b3dcc0c55169585a66d4b2a5f73935fde4832  assurance/README.md
+af3d36ce599e054900fedd0f57324c3f759ac89f47e416ff95e412ba5f0264bf  assurance/evals/README.md
+63af4112345c17c36471e4ebe1c469d8c91afcf348e13a4a9cac64aee8da12ef  assurance/tests/README.md
+fab355553750a9e791777f717373e55969870e9e12ce448384d5c5c2fcb81819  docs/00-inicio-rapido/README.md
+788908400aed530aa296ac893393f894f30db418be9721adc8be2af6d32bc87d  docs/00-inicio-rapido/glosario.md
+743705925b546ff2a1a856334c98cf582018cde93bb456abeced8b7b475c075c  docs/01-manifiesto/README.md
+344b921826a1f6dcb802277b59d0f4387244b92a244b3cfbeb098ce84d3a2ed9  docs/02-diagramas/README.md
+1a838d32f2f88b2882396ada513f22300df1a15229e877ab04369bcba853f6cd  docs/03-operacion/README.md
+7af588cff70b1294d5bf147de7132c434096261818e0e07117be8a9adda5e63f  docs/03-operacion/runbook.md
+af90fd19fce566c4582054f3805cc2e8e0a96e687c0f84efa09eb49af9e0eac6  docs/04-contratos/README.md
+80f6a80365a9c8f4d58155819a23edd35a25561eee64e42dd5594885c2ebfd54  docs/INDEX.md
+0fb2e3da1d2315808a8f4703438a20b9244b922542a1874ea0b05d81edaa2732  docs/architecture/README.md
+7c53b30481ce7313c742e01f42b045af18b2f7cfb686e2b94015d595d64b8cd8  docs/asilo/README.md
+e50bc4eae0b90c075b92ab24850ff1d0b290968d8fbaaf872b54d16254670cb2  governance/README.md
+d04d3f09f36c250c30828966403a1d991e8ea434a52fce040d14c841b1d96a93  governance/axioms.md
+0c584292be26b16cb7ce8b1b886517ca2a686f8d07cab33690f995f766111a63  governance/charter.md
+01ea51b11504b24cc864635a83322869aa73aef9341887882ab83e18303302c6  governance/decision-rights.md
+71c31c057e225b809ccdeaedef807d739927ccdf5e1b2bb56968d47e4281b4ce  governance/decisions/ADR-000-plantilla.md
+c7166f15fb04fd767e3ba193dcd09fa03210e216967573024be3476afd5a7a7c  governance/exceptions/README.md
+fd60e7233aadee57b5361d0599ac1275a2c57e133be552f8fa32df15ce8d7f0c  governance/keyring-directory.yaml
+1f0e8053f56b1384332f2e5d203972fbb5c225ceacad87c90ac8b0d330226228  governance/policies/README.md
+98ad2513de353c2307f582b40b2723a683e7cb880f66f5d50c7d2afb64360a35  governance/thresholds.yaml
+c5db48fbca965eda5b0eae246a1b1f05b80985ef1d92ea9d4a83e1655a2ced02  infrastructure/README.md
+73b9665fa72728974854f5542c6bda4ba4f613b8e68ab94e4ed282993db0f246  mkdocs.yml
+9a67f056a0cfda36df2066c6cec84b35e0e56cd1ed53356ad599bcef536b3e44  packages/agency/README.md
+77a03466cf79cc3dd9d02faebc58a0179d8f921c9fefde950c5dbb07e4fd6f8c  packages/agency/capabilities.yaml
+ef4046eff5a8b134fe4ed6311f10821cdbe30ba5df113a1b9e200e1e75c11316  packages/agency/coordination/README.md
+16310ef4f78ac230d32a8b15a3de9edc825babf41998a13d957605df24ef1641  packages/agency/coordination/deliberation.yaml
+15410212c0beafbdb99d52537ae8a74de92959aa824b1b4602c03d6e4cbdcf51  packages/agency/coordination/tribunal.yaml
+d46a28b17341f996f228405e06997466232edefe3287c20daabed8c27ddb16e0  packages/agency/registry.yaml
+e1607e3961f1f5f045f31321bcbd79bf05d69ada737b79290d77499d2597aba1  packages/agency/roles.yaml
+70fbc00a9c6db1452b654b4058512fb5cc53030e7c218619b9a5e98c9d054aad  packages/agency/topology.yaml
+e5b22a98dd69335b1b22c35e835b1f17a126e5331c5d5117ab5b90ba70487e7a  packages/agents/README.md
+cd65af5445a0ee9d36656f77303917fe24def68092aaa5f9366f8aa28f3a67ba  packages/agents/_ejemplo-coordinator/README.md
+e57ec28b50f94712e9d890be167fcb7291912f32d7348fd4bbc71a6216052070  packages/agents/_ejemplo-coordinator/manifest.yaml
+dc73286bc02708f68b1e31c001ce5c7173b172cf70c4519f9becda820e691f89  packages/agents/_ejemplo-critic/README.md
+7158c26cb9c8af570c69cf99b3c71c0aed7e64a7fb8fcdb5407c4218f66496d4  packages/agents/_ejemplo-critic/manifest.yaml
+a9130525d04ae2d4331838d3107bfeec6a87b0d7d23c57b50b7614d22ed5865f  packages/agents/_ejemplo-executor/README.md
+eb4f4fbd1eb7d02832c9a89659820fa2a61d972e77984da429a8bcab724bb76e  packages/agents/_ejemplo-executor/manifest.yaml
+6e4cbdd2dd823c31417a8f7e99d23b5c06eeb27d62ba10d8cb7d5f01ff1497bc  packages/application/README.md
+b02bca7cc5802553e404c76e97696c489418b9eeaa6505ce883e36ad2ea34603  packages/contracts/README.md
+8d4e9297548380115636c0d5423c3f0a3f6e6beef2c74d081a124e1454eb485a  packages/control/README.md
+2ef776f583209d90ca5b1995be2fe3ca315c5dcf9e2e011c2c286fd77aea435e  packages/control/decisions/README.md
+87594c7600a9607aaeadef79f52e0f5a2467911289db0cfc56c9a7e610d65119  packages/control/enforcement/README.md
+d7a5787643a0624c79b937dc2c23fe063dd54baa7daaec1a92635b112a337063  packages/control/guards/README.md
+4e8d7552431443f38b2db1488941a1ec1e7d8bafd6e8744d96901f143248ad72  packages/control/hitl/README.md
+316c5f00162d005807dedc117fee9dda2799d17cb0c7b854f9971675f2ccffe5  packages/control/policies/README.md
+3674c2d3c7c5830121c7409cf25190ddd09c0faf2f863d2c5fc05024c80238d9  packages/control/state-machine/README.md
+e05810a1e92a1f5dfd7fbd9e2dd6a8c0a2810ef25d99bc83ad26ca0188b62328  packages/control/state-machine/session.yaml
+d7472e7232c6adf5b797f70aaeabaf4a6b6edb6a1c9c474a316352d0cfe06e88  packages/domain/README.md
+452e337c8576a375b4a45a4742c85bf8ed05216d34db32431f04887f176bc180  packages/platform/README.md
+eed08fd03dd562ad0c832e6a163cb5994cfcf8eec586f34c1f79c3bdaaee0808  reports/README.md
+01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b  tmp/.gitkeep

horcon/_templates/agent-system/apps/README.md

@@ -0,0 +1,10 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# apps
+
+**Para qué existe:** marcar dónde irían las aplicaciones host (consola de gobernanza, API de control) si algún día se construyen.
+
+**Qué pregunta responde:** ¿qué interfaz humana y qué API existen hoy?
+
+**Qué NO hace:** ninguna app tiene código en fase 1: ambas están objetadas (ver subcarpetas).
+
+**Owner:** mantenedor

horcon/_templates/agent-system/apps/control-api/README.md

@@ -0,0 +1,12 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# control-api (objetado)
+
+**Para qué existe:** documentar la intención de una API determinista como único PEP (punto de aplicación de política).
+
+**Qué pregunta responde:** ¿quién aplica una decisión de política, y con qué identidad de llamador?
+
+**Por qué no hay código:** sT STC-01 muestra rutas directas que rodean a "el único PEP"
+(runtime -> vector, runtime -> egress, runtime -> observabilidad) y sT STC-02 señala que la API
+no tendría identidad de llamador. Bloqueado hasta DEC-19 y DEC-21 (ver `packages/control/README.md`).
+
+**Owner:** owner de seguridad

horcon/_templates/agent-system/apps/governance-console/README.md

@@ -0,0 +1,12 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# governance-console (objetado)
+
+**Para qué existe:** documentar la intención de una consola `/` (persona usuaria) y `/admin` (gobernanza), nunca un cliente de modelo.
+
+**Qué pregunta responde:** ¿quién vería y aprobaría decisiones humanas si esto existiera?
+
+**Por qué no hay código:** DOSSIER §8 prohíbe un editor de gobernanza en `/admin` que escriba
+MD/ADR/manifiestos "con firma" hasta que exista ADR (DEC-20); sT STC-05 señala que "editor con
+firma" y "sólo borrador" son dos afirmaciones contradictorias en el bundle de diseño.
+
+**Owner:** mantenedor

horcon/_templates/agent-system/assurance/README.md

@@ -0,0 +1,8 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# assurance
+
+**Para qué existe:** reunir los tests deterministas y las evaluaciones de este proyecto.
+
+**Qué pregunta responde:** ¿cómo sé que un cambio no rompió lo que ya funcionaba, sin llamar a un modelo real?
+
+**Owner:** mantenedor

horcon/_templates/agent-system/assurance/evals/README.md

@@ -0,0 +1,10 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# evals
+
+**Para qué existe:** marcar dónde irían las evaluaciones con modelo real (datos sintéticos, doble bandera), si este proyecto las necesita.
+
+**Qué pregunta responde:** ¿qué tan bien responde el sistema en casos representativos, medido con un dataset y un dueño declarados?
+
+**Qué NO hace hoy:** no hay ningún eval ejecutable en fase 1; esto es un README de intención.
+
+**Owner:** mantenedor

horcon/_templates/agent-system/assurance/tests/README.md

@@ -0,0 +1,10 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+# tests
+
+**Para qué existe:** tests deterministas (pytest), sin red, sin modelo: valida manifiestos, padrón y session.yaml de este proyecto.
+
+**Qué pregunta responde:** ¿la estructura de este proyecto sigue siendo válida tras el último cambio?
+
+**Cómo correr:** `horcon validate .` y `horcon audit-docs .` desde la raíz del proyecto.
+
+**Owner:** mantenedor

horcon/_templates/agent-system/docs/00-inicio-rapido/README.md

@@ -0,0 +1,52 @@
+<!-- Generado con asistencia de IA (Claude Fable 5.1, 2026-09-19); revisado por: pendiente -->
+---
+title: Empieza aqui
+certainty: Reference
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# Empieza aquí — {{project_name}}
+
+Este proyecto es un despacho de especialistas con inteligencia artificial que no deciden solos:
+cada encargo pasa por una aduana con reglas fijas y, cuando importa, por la firma de una persona.
+Hay dos maneras de usarlo; las dos escriben en los mismos archivos de esta carpeta.
+
+## Con la consola (sin escribir comandos)
+
+1. Abre la consola de Horcón en `http://127.0.0.1:5173` (quien la administra la levanta con
+   `scripts/arrancar` en la carpeta de Horcón).
+2. **Proyectos** → **Nuevo proyecto**: nombre, carpeta (esta), ¿afecta a personas?, ámbito.
+3. **Equipo** → **Nuevo especialista** (nombre, papel, para qué, herramientas) → **Crear ficha**
+   → **Dar de alta** (pide rol, nombre y razón de quien firma).
+4. **Encargos** → **Nuevo encargo** (título, objetivo, nivel de cuidado) → en la página del
+   encargo: **Carpeta de evidencia** (añade rutas de este proyecto), **Ejecutar en simulación**,
+   **Pasar por la aduana** y, si la aduana lo pide, **Ir a la bandeja de revisión** para firmar.
+
+## Con la terminal (comandos)
+
+Desde la carpeta de Horcón, con `--project` apuntando a esta carpeta:
+
+```bash
+horcon agent add --project . --id <id> --role executor --label "..." --purpose "..."
+horcon agent register --project . --id <id> --role anchor --reviewer-id <tu-id> --rationale "..."
+horcon engagement new --project . --title "..." --objective "..." --risk low
+horcon bundle --project . --trace <numero-de-expediente> <archivos...>
+horcon run --project . --trace <numero-de-expediente> --agent <id> --provider fake
+horcon gate --project . --trace <numero-de-expediente> --from-agent <id>
+horcon state --project . --trace <numero-de-expediente>
+```
+
+Para firmar hace falta una llave propia (`horcon keys init --role anchor --reviewer-id <tu-id>`),
+guardada fuera de este proyecto. Todo corre en **modo simulación** por defecto: sin proveedor real,
+sin internet y sin gasto. Validar y auditar: `horcon validate .` y `horcon audit-docs .`.
+
+## Dónde sigue
+
+- [Glosario](glosario.md) — cada palabra de la consola con su analogía.
+- [Manifiesto](../01-manifiesto/README.md), [diagramas](../02-diagramas/README.md),
+  [operación](../03-operacion/README.md) y [contratos](../04-contratos/README.md) de este proyecto.
+- El libro completo de Horcón vive en el repositorio del framework (`docs/INDEX.md`).
+
+[Índice](../INDEX.md) · [Siguiente](glosario.md)

horcon/_templates/agent-system/docs/00-inicio-rapido/glosario.md

@@ -0,0 +1,35 @@
+<!-- Generado con asistencia de IA (Claude Fable 5.1, 2026-09-19); revisado por: pendiente -->
+---
+title: Glosario
+certainty: Reference
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# Glosario — {{project_name}}
+
+Las palabras de la consola y de la terminal, con su analogía y, al final, el término técnico que
+usan los archivos de este proyecto.
+
+| Cómo se dice | Analogía | Término técnico |
+|---|---|---|
+| proyecto | abrir un expediente en un despacho | esta carpeta, generada por `horcon init` |
+| encargo | pedir un trabajo a un despacho | engagement (`encargos/*.json`) |
+| equipo y especialistas | despacho y sus profesionales | agentes (`packages/agents/`) |
+| ficha del especialista | tarjeta de identidad + contrato: qué puede y qué no | manifiesto (`manifest.yaml`) |
+| papel: coordina / ejecuta / revisa | el puesto | role: coordinator / executor / critic |
+| padrón | lista de empleados dados de alta | registry (`packages/agency/registry.yaml`) |
+| dar de alta | recursos humanos firma la contratación | `agent register` |
+| carpeta de evidencia | los documentos que se pueden citar | bundle (`evidence-manifest.json`) |
+| aduana | revisa con reglas fijas, sin opinión | policy gate / compuerta |
+| nivel de cuidado | el nivel de la póliza | risk: low / medium / high |
+| firma | la persona responsable firma la decisión | receipt |
+| bandeja de revisión | lo que espera una firma humana | HITL / human_handoff |
+| botón de paro | el paro de emergencia de una fábrica | kill switch (`tmp/KILL`) |
+| contador de gasto | el taxímetro | ledger (`ledger.jsonl`) |
+| número de expediente | folio | trace_id (`rec-…`) |
+| etapas del encargo | recibido → en estudio → revisado → entregado | máquina de estados (`packages/control/state-machine/session.yaml`) |
+| modo simulación | ensayo con maniquíes antes de usar personas reales | proveedor `fake` |
+
+[Anterior](README.md) · [Índice](../INDEX.md) · [Siguiente](../01-manifiesto/README.md)

horcon/_templates/agent-system/docs/01-manifiesto/README.md

@@ -0,0 +1,18 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Manifiesto - menu
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# 01-manifiesto
+
+Nivel para cualquier persona, sin jerga técnica. Completa este nivel para tu proyecto: qué
+problema resuelve, qué NO hace y qué límites tiene.
+
+Recuerda: ningún documento de este nivel afirma cumplimiento total ni promete un resultado
+absoluto sin citar el test que lo respalda (ver `horcon audit-docs`).
+
+[Anterior](../00-inicio-rapido/glosario.md) · [Índice](../INDEX.md)

horcon/_templates/agent-system/docs/02-diagramas/README.md

@@ -0,0 +1,16 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Diagramas - menu
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# 02-diagramas
+
+`D07-maquina-de-estados.md` se genera con `horcon diagrams .` a partir de
+`packages/control/state-machine/session.yaml`: no lo edites a mano, cambia el YAML y
+regenera.
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/docs/03-operacion/README.md

@@ -0,0 +1,19 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Operacion - menu
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# 03-operacion
+
+Cómo levantar y operar este proyecto: perfiles de `horcon up`, cómo correr `horcon validate`
+y `horcon audit-docs`, y qué observabilidad tiene sentido mirar.
+
+{{#p3}}
+En perfil `P3`, este nivel incluye además [`runbook.md`](runbook.md).
+{{/p3}}
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/docs/03-operacion/runbook.md

@@ -0,0 +1,49 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Runbook de operacion
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# Runbook de operación (perfil P3)
+
+Este documento sólo existe en proyectos generados con `--profile P3`.
+
+## Arranque
+
+1. `horcon doctor` — confirma qué SDKs y qué docker están disponibles.
+2. `horcon up --profile core` — servicios base.
+3. Si el proyecto usa agentes: `horcon up --profile agents --approve-network --acknowledge-cost`.
+
+## Incidente
+
+1. Si algo debe detenerse ya: `horcon kill` (hoy: "no implementado: DEC-21", código 3 — ver
+   `packages/control/README.md`). Mientras tanto, usa `horcon down` y el control manual de
+   docker.
+2. Registra lo ocurrido en `reports/`.
+
+## Sin quien firme (safe_exit, H-6)
+
+Si un encargo de riesgo alto llega a necesitar una firma humana y hoy no hay ninguna persona con
+autoridad disponible para darla, el sistema **se detiene** (no aprueba por silencio ni adivina
+una respuesta): el estado queda en espera de revisión o en `safe_exit`, nunca se entrega nada.
+
+Texto para la persona usuaria en ese caso (adapta el recurso a tu contexto; nunca inventes un
+número de línea de crisis: eso lo redacta `legal-counsel`, no un agente):
+
+> No hay nadie disponible ahora mismo para revisar tu caso con el cuidado que necesita. Si es
+> urgente, por favor contacta [recurso humano externo al sistema: línea, persona o servicio que
+> tu organización haya designado]. Volveremos a intentarlo en cuanto haya alguien disponible.
+
+Sin una segunda persona con autoridad de firma, este proyecto no debería operar con personas
+reales en encargos de riesgo alto (ver `docs/03-operacion/10-que-no-esta-implementado.md` del
+framework, "sin segunda persona no hay piloto con personas reales").
+
+## Qué no está implementado todavía
+
+Ver `docs/03-operacion/04-que-no-esta-implementado.md` si este proyecto lo agrega, o
+`governance/decisions/` para el estado de cada DEC-NN pendiente.
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/docs/04-contratos/README.md

@@ -0,0 +1,15 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Contratos - menu
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# 04-contratos
+
+Los contratos formales de este proyecto: schema de manifiesto de agente, padrón central,
+máquina de estados de sesión y precedencia de fuentes de verdad (`SOURCE.md`).
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/docs/INDEX.md

@@ -0,0 +1,24 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Indice de documentacion
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# docs/INDEX.md — {{project_name}}
+
+Mapa de la documentación de este proyecto: una parte de inicio para todos y cuatro niveles de
+menor a mayor tecnicismo.
+
+0. [00-inicio-rapido/](00-inicio-rapido/README.md) — cómo usar este proyecto con la consola y con
+   la terminal, y el [glosario](00-inicio-rapido/glosario.md).
+1. [01-manifiesto/](01-manifiesto/README.md) — qué es y qué no es este sistema, sin jerga.
+2. [02-diagramas/](02-diagramas/README.md) — diagramas de arquitectura y de la máquina de estados.
+3. [03-operacion/](03-operacion/README.md) — cómo se levanta y se opera.
+4. [04-contratos/](04-contratos/README.md) — manifiestos, padrón, máquina de estados y fuentes de verdad.
+
+Ruta de lectura sugerida: cualquier persona → 00 · persona no técnica → 01 · arquitecto → 02 · operador → 03 · auditor → 04.
+
+

horcon/_templates/agent-system/docs/architecture/README.md

@@ -0,0 +1,13 @@
+---
+title: Arquitectura
+certainty: Reference
+status: draft
+updated: 2026-09-24
+owner: mantenedor
+---
+
+# Arquitectura
+
+Este directorio contiene los diagramas y decisiones de arquitectura del sistema generado.
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/docs/asilo/README.md

@@ -0,0 +1,13 @@
+---
+title: Contratos de ASILO
+certainty: Reference
+status: draft
+updated: 2026-09-24
+owner: mantenedor
+---
+
+# Contratos de ASILO
+
+Este directorio documenta los límites de seguridad, evidencia y gobernanza que adopta el proyecto.
+
+[Índice](../INDEX.md)

horcon/_templates/agent-system/governance/README.md

@@ -0,0 +1,17 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Gobernanza del proyecto
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# governance
+
+**Para qué existe:** reunir charter, axiomas, derechos de decisión, políticas y ADRs de este
+proyecto, en un solo lugar con precedencia fijada por `SOURCE.md`.
+
+**Qué pregunta responde:** ¿quién decide qué, con qué criterio, y qué pasó cuando cambió?
+
+**Owner:** mantenedor (hasta que el proyecto nombre un Anchor propio).

horcon/_templates/agent-system/governance/axioms.md

@@ -0,0 +1,16 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente -->
+---
+title: Axiomas
+certainty: Hypothesis
+status: draft
+updated: {{date}}
+owner: mantenedor
+---
+
+# Axiomas
+
+Plantilla vacía a propósito: los axiomas los declara el Anchor de este proyecto, no `horcon
+init`. Ningún agente de la capa de ingeniería edita este archivo (ver `AGENTS.md`).
+
+Cambiar un axioma exige un ADR nuevo en `governance/decisions/` (ver `ADR-000-plantilla.md`)
+firmado por una persona, nunca por un meta-agente.