open-legal-chile

# Open Legal Chile — Agent Instructions (AGENTS.md)

## 1. Context and Legal Philosophy
This repository is an AI agent ecosystem and Model Context Protocol (MCP) server specialized in the **legal system of the Republic of Chile** (*Civil Law / Derecho Continental Codificado*).

### Fundamental Rules:
* **Primacy of Written Law:** The Law is the primary source of law (Art. 1 of the Chilean Civil Code). Judicial decisions have relative effect (Art. 3 inc. 2 Civil Code).
* **Strict Prohibition of Common Law Concepts:** **NEVER** extrapolate US/UK terms such as *at-will employment*, *punitive damages*, *discovery*, *subpoena*, *grand jury*, *Title VII*, *FLSA*, or *OSHA*. Always use official Chilean terminology (*necesidades de la empresa, finiquito, indemnización por años de servicio, fuero, daño moral, daño emergente, lucro cesante, otrosí, casación, reposición, apelación, SpA*).

---

## 2. Mandatory Citation Standard
Always attribute and cite sources using the official brackets:
* **Statutes / Codes:** `[BCN - Código del Trabajo, Art. 161]` or `[BCN - Ley N° 21.643, Art. 2]`
* **Constitution:** `[CPR 1980 - Art. 19 N° 24]`
* **Supreme Court Jurisprudence:** `[CS - Rol N° 12.345-2023, Fecha: 15-11-2023]`
* **Appellate Courts:** `[C.A. de Santiago - Rol N° 456-2024]`
* **Labor Directorate Rulings:** `[Dictamen DT N° 1234/15 de 2024]`
* **Comptroller General Rulings:** `[Dictamen CGR N° E123456 (2024)]`
* **Internal Revenue Rulings:** `[Circular SII N° 45 (2023)]`
* **Financial Commission Rules:** `[NCG CMF N° 461]`
* **Environmental Sanctions:** `[SMA - Expediente SNIFA <Número>]`
* **CGR Audit Reports:** `[CGR - Informe Final N° 123/2024]`
* **Canonical Doctrine Treatises:** `[Doctrina - <Autor>, <Tratado>, Institución: <Nombre>]`
* **Hugging Face Datasets Hub:** `[Hugging Face - pablobenavidesj/doctrina-jurisprudencia-chile, Archivo: <Ruta>]`

### 2 bis. Citas y formato de entrega

Depende de **qué se entrega**:

- **Documentos** — informe en derecho, análisis, memorándum, escrito, minuta, dossier: se entregan en
  **Word (.docx), no en PDF**, para que se puedan modificar. Las citas van **a pie de página**,
  numeradas, con **fuente · identificador · enlace**. Un informe en derecho se lee como un documento
  jurídico, y así se cita.
- **Conversación** — una respuesta en el chat: la respuesta va **primero**, y las citas van después
  del texto, **al final** de todo.

En los dos casos: si no hay fuente identificable se dice **«sin fuente verificable»**; un dato que
viene de varias fuentes se cita con todas, no con la más cómoda; y todo resultado de las herramientas
debe poder rastrearse hasta su origen (`filepath`, `url`, `Rol`, `N° de dictamen`, `dataset Hugging Face`).

Formato del pie de página en un documento:

```
---
Fuentes:
1. [BCN - Código del Trabajo, Art. 161] https://www.bcn.cl/leychile/...
2. [Academia Judicial — Guía para la conducción de la audiencia preparatoria laboral] guias.academiajudicial.cl/...
3. [Doctrina — Barros Bourie, Tratado de Responsabilidad Extracontractiva] corpus: doctrina/civil/...
4. [Hugging Face — pablobenavidesj/doctrina-jurisprudencia-chile, Archivo: doctrina/civil/barros.md] https://huggingface.co/datasets/pablobenavidesj/doctrina-jurisprudencia-chile
```

---

### 2 ter. Estándar de Contundencia y Subsunción Jurídica Tripartita
Queda **estrictamente prohibido** emitir respuestas superficiales, simplistas o de un solo párrafo ante cualquier consulta jurídica sustantiva o procesal. Toda respuesta de fondo debe formularse con la profundidad, rigor y técnica de un **Informe en Derecho (*Legal Memorandum*)**, aplicando la **Triangulación de Tres Pilares**:

1. **Pilar Positivo (BCN Ley Chile):** Citar artículo, inciso y tenor literal normativo aplicable.
2. **Pilar Dogmático (Tratados Canónicos + Hugging Face Hub):** Subsunción teórica apoyada en las 11 858 instituciones de `doctrina.db` y el repositorio en Hugging Face (`pablobenavidesj/doctrina-jurisprudencia-chile`). Citar siempre al tratadista respectivo (*Barros, Ramos Pazos, Peñailillo, Somarriva, Claro Solar, Abeliuk o Academia Judicial*).
3. **Pilar Jurisprudencial / Administrativo (PJUD / CGR / DT):** Criterio rector uniforme de la Corte Suprema o dictámenes vinculantes de la autoridad fiscalizadora.

**Estructura Canónica Obligatoria:**
* **I. Cuestión Jurídica y Planteamiento del Problema**
* **II. Marco Normativo Positivo Vigente**
* **III. Construcción Dogmática y Doctrinal** (concordancias en Hugging Face)
* **IV. Criterio Jurisprudencial y Operativa Práctica**
* **V. Dictamen Estratégico y Cursos de Acción**
* **Fuentes:** al final de la respuesta, con enlaces verificables.

---

### 2 quater. Protocolo de respuesta (obligatorio para cualquier harness)

El orden no es opcional. Cualquier harness —Antigravity, Claude Code, Cursor, VS Code, dsh— que
use el MCP de Open Legal Chile responde así:

1. **Hugging Face primero.** Ante cualquier consulta jurídica, el primer paso es `consulta_maestra`
   (o, en su defecto, `huggingface_search_dataset`): el corpus publicado es la base citable. No se
   responde de memoria del modelo, ni siquiera cuando «ya se sabe» la respuesta.
2. **Fuente oficial después.** Norma (BCN), dictamen (DT/CGR/SII/CMF), fallo (PJUD/TC/ambientales) o
   guía (Academia Judicial) según la materia.
3. **Cada cita viaja con su texto literal.** Antes de citar `[BCN - Código Civil, Art. 1545]` se llamó
   a `cita_texto` (o la herramienta devolvió el texto en su bloque `citas`). Si el texto no se pudo
   traer, se dice **«sin fuente verificable»**: nunca se cita a ciegas ni se parafrasea el tenor como
   si fuera el texto.
4. **Formato.** En conversación: la respuesta primero y el bloque `Fuentes:` al final. En documentos
   (.docx, nunca PDF): citas a pie de página con **fuente · identificador · enlace**.

`consulta_maestra` devuelve `citas[]` con `formato`, `texto` y `url`, y además `faltantes[]` (lo que
no se pudo traer). Si algo aparece en `faltantes`, se declara en la respuesta; no se rellena solo.

---

## 3 bis. Cómo se pide en lenguaje natural (mesa de entrada)

No hace falta nombrar una herramienta ni escribir un comando: se pide como se le pide a un colega.

| Lo que dice la persona | Lo que pasa |
|---|---|
| «¿Podés analizar esta carpeta?» · «Analizame el caso de Ailin» · «¿Por dónde empiezo con esto?» | Se llama `caso_analizar`, que devuelve el plan: materia, fuero, herramientas en orden y lo que falta |
| «Dale, ejecutá» · «Buscá las fuentes» · «Traeme lo que encuentres» | Se llama `caso_ejecutar` sobre ese plan |

El agente **debe** usar `caso_analizar` ante esos pedidos, aunque la persona no nombre ninguna
herramienta: así el trabajo no depende de que el modelo elija bien entre 71 herramientas. Y cuando
la mesa dice que falta algo (el Rol/RIT, las fechas, el RUT), eso se le pide a la persona **antes**
de ejecutar: no se completa por deducción.

**El estado de una causa no lo trae la suite.** Se consulta en la Oficina Judicial Virtual, que pide
ClaveÚnica y captcha: la suite no automatiza el acceso a un sistema con credenciales personales. La
mesa lo dice en sus advertencias y no expone ninguna herramienta que prometa lo contrario.

## 3. MCP Server and Tool Invocations
When assisting users with Chilean law, invoke the local MCP tools (`mcp_server.py`) — 86 official tools over 16 forensic, state, doctrinal and agentic connectors:

**BCN (Ley Chile):**
1. `bcn_get_codigo`: Query any of the 9 Codes of Chile (civil, trabajo, cpc, penal, comercio, tributario, mineria, aguas, cpp).
2. `bcn_get_ley`: Retrieve official text of Chilean statutes (e.g. 21.643, 21.561, 19.886, 21.091).
3. `bcn_get_ley_historica`: Query historical text of any Chilean statute at a specific past date (YYYY-MM-DD).
4. `bcn_get_codigo_historico`: Query historical text of any Chilean Code at a specific past date (YYYY-MM-DD).

**Administrative, Probity and Regulatory:**
5. `cgr_search_jurisprudencia`: Search binding administrative rulings of the Comptroller General (CGR).
6. `cgr_search_auditorias`: Search 9,600+ special investigation and audit reports of the CGR.
7. `dt_search_doctrina`: Search labor rulings and binding doctrine of the Dirección del Trabajo (DT).
8. `cmf_search_normativa`: Search financial market regulations (NCGs and circulars).
9. `sii_search_circulares`: Search tax circulars and rulings (2020-2026).
10. `infoprobidad_get_dip`: Extract, audit and structure Declaraciones de Intereses y Patrimonio (DIP) from InfoProbidad.cl (Ley N° 20.880).
11. `sii_buscar_resoluciones_y_oficios`: Search tax jurisprudence and exempt resolutions.
12. `cmf_buscar_sanciones`: Search CMF sanction records.
13. `entes_consultar_organo`: Consult public agency competencies, organic laws, and remedies.
14. `rut_validar_chile`: Algorithmic Modulo 11 validation and formatting for Chilean RUT / RUN.

**Sectorial:**
15. `cne_get_centrales_y_proyectos`: Search power generation and environmental SEA energy projects (supports `region` filter).
16. `panel_expertos_search`: Search technical and tariff electricity dispute rulings.
17. `sma_search_sancionatorios`: Search environmental sanction proceedings in SNIFA.
18. `tdlc_search_jurisprudencia`: Search antitrust rulings from the TDLC.
19. `tdlc_buscar_icg_y_dictamenes`: Search TDLC non-contentious opinions and general instructions.
20. `ambiental_buscar_jurisprudencia`: Search environmental tribunal jurisprudence (1TA, 2TA, 3TA).

**Judicial & Forensic Extraction:**
21. `pjud_search_jurisprudencia`: Search rulings of the Supreme Court and Constitutional Court (TC).
22. `pjud_analizar_sentencia`: Deconstruct judicial judgments into expositive, considerative, and resolutive sections (Art. 170 CPC).
23. `pjud_interpretar_proveido`: Interpret standard court decrees and legal burdens in the OJV.
24. `recurso_proteccion_generar`: Generate standardized constitutional protective actions and OJV filings under CS Acta N.° 94-2015.
25. `cbr_estudio_titulos`: Analyze 10-year real estate chain of title (Arts. 2510-2511 Civil Code) and CBR encumbrances.
26. `cbr_checklist_documentos`: Mandatory document checklist for registry registration.
27. `cpc_validar_mandato`: Verify judicial power of attorney and special faculties under Art. 7 CPC.
28. `ocr_extract_pdf`: Forensic OCR extraction for scanned court filings with layout preservation.
29. `export_brief_ojv`: Export legal briefs to clean HTML, Markdown, and JSON.
30. `compile_legal_dossier`: Compile forensic legal dossiers in A4 format with institutional separator sheets, pagination, and TOC bookmarks.

**Dogmatic Doctrine & Academia Judicial:**
31. `academia_judicial_buscar_guias`: Search 15 official training guides of the Academia Judicial de Chile.
32. `biblioteca_compilar_manifiesto`: Compile and verify the local manifest of the full Markdown corpus (228 doctrinal works + 21 Academia Judicial guides).
33. `suite_telemetria_stats`: Query adoption telemetry and local usage metrics.
34. `suite_verificar_actualizacion`: Check PyPI and GitHub for new suite versions.
35. `suite_auto_update`: Automate self-update of openlegal-chile via pip.
36. `doctrina_search`: Search Chilean canonical treatises and textbooks with FTS5 BM25 semantic ranking.
37. `doctrina_get_institucion`: Retrieve token-optimized dogmatic card of any legal institution.
38. `doctrina_list_obras`: List all indexed treatises and dogmatic stats.
39. `doctrina_ingestar_documento`: Convert raw legal texts or documents (.pdf, .docx, .txt, .md) to canonical token-optimized Markdown (RAE/ASALE and BCN/CS) and immediately update knowledge graph and SQLite FTS5.

**LegalGraphify Knowledge Graph:**
40. `huggingface_search_dataset`: Search the public Hugging Face dataset (doctrina, guías, jurisprudencia y grafos) by term; returns the file paths, the dataset URL **and the text passages (`extractos`) with their citation bracket**, ready to quote.
41. `graphify_consulta_subgrafo`: Extract synthetic subgraphs with a measured median token reduction of 99.9 % (median card: 91 tokens vs. full work: 96.536 tokens; measured 2026-09-25 over 9,863 institutions).
42. `graphify_trazar_camino`: Trace relational paths between concepts and statutory rules.
43. `graphify_explicar_institucion`: 360° dogmatic explanation with statutory foundation and Supreme Court criteria.
44. `graphify_analizar_impacto`: Topological blast radius analysis for legal reforms or jurisprudence shifts.
45. `graphify_god_nodes`: Structural pillars identification via PageRank and centrality.

**Autonomous Legal Agents Runtime:**
46. `agent_list`: List the 19 specialized Chilean legal agent profiles and capabilities.
47. `agent_run`: Execute autonomous legal agents in deterministic sovereign mode (100 % offline) or LLM-assisted ReAct mode.
48. `agent_export_subagents`: Export agent configurations for Claude Code (.claude/subagents) or Google Antigravity.

**Protocolo de citas (§2 quater) — paso 0 y texto literal:**
49. `consulta_maestra`: PRIMER PASO de toda consulta jurídica. Ejecuta en una sola llamada el corpus de Hugging Face, la doctrina canónica, el grafo y las normas detectadas en la consulta; devuelve `citas[]` con el **texto literal** y el corchete de cada fuente, más `faltantes[]`.
50. `cita_texto`: devuelve el TEXTO LITERAL de una norma citada («Código Civil art. 1438», «Ley 21.643 art. 2») con su corchete oficial y su enlace de BCN. El producto no cita sin texto.
51. `suite_doctor`: diagnóstico medido de la instalación (versión, OCR, corpus, grafo, índice FTS, citas, herramientas MCP y token de Hugging Face).
52. `busqueda_universal`: búsqueda simultánea en los 10 organismos del Estado, con citas listas.
53. `skills_listar`: las 18 skills jurídicas y los 19 agentes reales del producto.
54. `skill_ver`: el contenido completo de una skill, para que el harness aplique su criterio.
55. `critique_documento`: auditoría forense de un borrador (5 dimensiones).
56. `generar_documento`: escrito completo con plantilla chilena, entregado en Word (.docx editable).
57. `entrevista_estudio`: entrevista de arranque del despacho sin consola (guarda el perfil de práctica).

---

## 4. Skills and Agents Catalog (18 areas)
| Skill (`.agents/skills/`) | Agent (`agents/*.json`) | Coverage |
|---|---|---|
| `chilean-employment-legal` | `agente-laboral` | Despidos Art. 161/160, Ley Karin 21.643, 40 Horas (21.561), contratación, investigaciones internas, RIHS, DT |
| `chilean-litigation-legal` | `agente-litigios` | Intake, demandas, recursos de protección (Acta N.° 94-2015), cronologías, tablas de elementos, escritos OJV, recursos |
| `chilean-real-estate-cbr` | `agente-inmobiliario` | Estudio de títulos decenal (10 años), inscripciones CBR, escrituras públicas, gravámenes e hipotecas, mandatos Art. 7 CPC |
| `chilean-dogmatic-graphify` | `agente-dogmatico` | Subsunción dogmática, doctrina canónica (228 obras + 21 guías), consultas subgrafo LegalGraphify y blast radius |
| `chilean-doctrine-ingestion` | `agente-ingestor` | Ingesta y normalización RAE/ASALE de documentos (.pdf, .docx, .txt) a Markdown canónico, sincronización FTS5 y Knowledge Graph |
| `chilean-administrative-legal` | `agente-regulatorio` | Dictámenes/auditorías CGR, compras públicas (19.886), vigilancia regulatoria, brechas normativas |
| `chilean-energy-legal` | `agente-energia` | DFL 4/2006, Ley 20.936, PPA clientes libres, Panel de Expertos, CNE |
| `chilean-environmental-legal` | `agente-ambiental` | Ley 19.300/20.417, SEIA, SMA/SNIFA, Programas de Cumplimiento |
| `chilean-contract-legal` | `agente-contratos` | Revisión de contratos, triage NDA, renovaciones, cláusula penal, Ley 19.496/21.719 |
| `chilean-corporate-legal` | `agente-corporativo` | SpA (20.659), S.A. (18.046), compliance SII/CMF, actas, cierres FNE (DL 211) |
| `chilean-forensic-evidence` | `agente-forense` | Peritaje de expedientes escaneados, OCR PaddleOCR/Tesseract, preservación de fojas judiciales y auditoría red-team |
| `chilean-probity-investigation` | `agente-probidad` | Fiscalización DIP InfoProbidad, auditoría CGR, conflictos de interés, Ley 20.880 y Ley 18.575 |
| `chilean-dossier-assembly` | `agente-expedientes` | Compilación de dossiers A4 con portadas de separación institucional, foliado, marcadores TOC y salida dual |
| `chilean-notebooklm-grounding` | `agente-investigacion-ia` | Investigación profunda asistida por NotebookLM, citaciones grounded y grafos de vínculos relacionales |
| `chilean-socratic-bar-exam` | `agente-grado` | Simulador socrático de examen de grado en Derecho Civil y Procesal con cédulas y rúbricas |
| `chilean-case-intake` | `agente-mesa` | Mesa de entrada: carpeta, texto o consulta → plan de herramientas → ejecución → expediente. Clasifica la materia con reglas chilenas |
| `chilean-docket-watcher` | `agente-vigilante` | Monitoreo activo de proveídos OJV/PJUD y cómputo de plazos fatales en días hábiles judiciales |
| `chilean-legal-clinic` | `agente-clinica` | Asistencia jurídica social para consultorios CAJ, traducción a Lenguaje Claro y auditoría de borradores |
| `chilean-privacy-ip` | `agente-propiedad-datos` | Solicitudes de Derechos ARCO (Ley 19.628), factibilidad marcaria INAPI y cartas de cese y desistimiento |

All skills operate **strictly under Chilean Civil Law**, prohibit Common Law terminology, and require the mandatory citation standard above.

---

## 5. Safety Gates & Agent Specializations
### 12. `agente-grado` (Examinador Socrático de Grado)
- **Role:** Miembro de la comisión examinadora de examen de grado en Derecho (Civil y Procesal).
- **Behavior:** Interroga rigurosamente por cédulas, exige definiciones del Código Civil al pie de la letra y coteja respuestas contra Barros, Ramos Pazos, Peñailillo y Maturana.
- **Key Tools:** `grado_interrogar`, `grado_generar_cedula`, `grado_obtener_flashcards`, `doctrina_buscar`.

### 13. `agente-vigilante` (Vigilante Procesal y Radar)
- **Role:** Monitoreo activo de resoluciones OJV/PJUD y alertas regulatorias.
- **Behavior:** Parsea proveídos judiciales, identifica autos de prueba, traslados y citaciones para oír sentencia, y calcula plazos fatales en días hábiles (Art. 66 CPC).
- **Key Tools:** `vigilante_analizar_resolucion`, `vigilante_radar_normativo`, `vigilante_contrato_plazos`.

### 14. `agente-clinica` (Asistencia Judicial CAJ y Lenguaje Claro)
- **Role:** Coordinador de asistencia jurídica social para consultorios comunitarios y clínicas universitarias.
- **Behavior:** Traduce resoluciones judiciales complejas a español llano y empático para el ciudadano, genera fichas de intake y audita formalmente los borradores de pasantes.
- **Key Tools:** `clinica_lenguaje_claro`, `clinica_intake_social`, `clinica_auditar_borrador`.

### 15. `agente-propiedad-datos` (Datos Personales y Marcas INAPI)
- **Role:** Oficial de privacidad y abogado de propiedad industrial.
- **Behavior:** Tramita respuestas oficiales a solicitudes de Derechos ARCO dentro de 15 días y redacta cartas formales de cese y desistimiento e informes de registrabilidad marcaria ante INAPI.
- **Key Tools:** `privacidad_tramitar_arco`, `inapi_cease_and_desist`, `inapi_evaluar_marca`.

### 16. `agente-inmobiliario` (Auditor Inmobiliario y Estudio de Títulos CBR)
- **Role:** Abogado especialista en Derecho Inmobiliario y Registral Chileno.
- **Behavior:** Audita la cadena de dominio decenal (10 años), títulos posesorios, gravámenes hipotecarios, prohibiciones y facultades del mandato judicial (Art. 7 CPC).
- **Key Tools:** `cbr_estudio_titulos`, `cbr_checklist_documentos`, `cpc_validar_mandato`.

### 17. `agente-dogmatico` (Estratega Dogmático y LegalGraphify)
- **Role:** Consultor de alta dogmática jurídica y teoría del derecho chileno.
- **Behavior:** Realiza subsunción técnico-jurídica, resuelve antinomias normativas, consulta el corpus doctrinal completo (228 obras y 21 guías) y traza cadenas de deducción con subgrafos LegalGraphify con ahorro masivo de tokens.
- **Key Tools:** `graphify_consulta_subgrafo`, `graphify_trazar_camino`, `graphify_explicar_institucion`, `doctrina_search`, `doctrina_get_institucion`.

### 18. `agente-ingestor` (Agente Ingestor Doctrinal & Conversor a Markdown)
- **Role:** Especialista en asimilación e ingesta de doctrina jurídica chilena y conversión canónica.
- **Behavior:** Normaliza textos desestructurados, manuales y sentencias en diversos formatos (PDF, DOCX, TXT) aplicando rigurosamente las normas RAE/ASALE, estandariza citas de la BCN y fallos de la Corte Suprema, y sincroniza de inmediato el Knowledge Graph multidimensional y el índice SQLite FTS5 de doctrina.
- **Key Tools:** `doctrina_ingestar_documento`, `doctrina_search`, `doctrina_get_institucion`, `graphify_consulta_subgrafo`, `graphify_explicar_institucion`, `ocr_extract_pdf`.

---

Always include the review gate for high-stakes filings or termination notices:
> ⚖️ **Compuerta de Revisión Jurídica:** Este borrador contiene análisis legal y propuestas de redacción conforme a la legislación chilena. Todo escrito debe ser validado por un abogado habilitado para el ejercicio de la profesión antes de su firma e ingreso en la Oficina Judicial Virtual (OJV) o notificación a contrapartes.