# Matlock — Herramientas para Agentes y Desarrolladores. (Manual del Propietario y Referencia Operativa)


> **PARA AGENTES DE CODIFICACIÓN CON IA Y ORQUESTADORES:**
> Salte directamente a **[Parte II: Especificación Operativa para Máquinas y Agentes Autónomos](#parte-ii-especificación-operativa-para-máquinas-y-agentes-autónomos)** para consultar el catálogo MCP `stdio` de 27 herramientas, el desbloqueo `HTTP 402` de doble vía, las reglas del entorno aislado de frontera `seq_matlock` / `cold_box` y los contratos de cierre.

**Producto**: Matlock — Herramientas para Agentes y Desarrolladores. (`Eficiente. Exacto. Según las reglas.`)  
**Posicionamiento**: *Verificación técnica local poliglota en `< 50ms` para AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF y AICPA SOC 2 Trust Services Criteria con sellos de pruebas Salvaguarda antimanipulación, entornos aislados Pre-CI de frontera, automatización CLI en 1 clic y MCP stdio local de 27 herramientas (`0` subidas de código a la nube, `0` puertos abiertos, `0` bloqueo de `git commit`).*  
**Editor**: Matlock by Dutch P2P © 2026. Todos los derechos reservados.  
**Superficies**: Centro de Comando de Escritorio (**Windows**, **Linux** y **GoogleBook**; **macOS `arm64`** (`matlock-mcp` headless ready) — pulse **`?`** o **`F1`** en cualquier momento) · [Centro de Comando Web](https://matlock.dutchp2p.com/es/app) · [Escaneo Local Gratuito](https://matlock.dutchp2p.com/es/#wasm-instant-audit) · [Documentación](https://matlock.dutchp2p.com/es/docs) · [Manual en Línea](https://matlock.dutchp2p.com/es/manual) · URI MCP `matlock://help/appliance-manual`

**Alcance y Aviso Legal**: *Matlock evalúa controles técnicos de código y canalización frente a especificaciones y referencias publicadas de la industria (MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, compuertas automatizadas de integridad Pre-CI y controles técnicos de AICPA SOC 2 Trust Services Criteria). Matlock no garantiza software libre de defectos, no emite informes formales de atestación de terceros ni proporciona certificaciones de una firma independiente autorizada de contadores públicos certificados (CPA).*

---

## Tabla de contenidos

### Parte I: Guía del Operador Humano y Banco de Trabajo
1. [Glosario Rápido y Flujo Principal](#1-glosario-rápido-y-flujo-principal)
2. [Diseño de Pantalla, Temas y Navegación](#2-diseño-de-pantalla-temas-y-navegación)
3. [Scripts Descubiertos, Comprobaciones Propias, Acciones y Favoritos](#3-scripts-descubiertos-comprobaciones-propias-acciones-y-favoritos)
4. [Rutinas Autónomas, Comandos de Equipo y Alertas Locales](#4-rutinas-autónomas-comandos-de-equipo-y-alertas-locales)
5. [Cascada de Resultados, Reejecución Aislada, Ignorar y Copiar](#5-cascada-de-resultados-reejecución-aislada-ignorar-y-copiar)
6. [Salvaguarda Fija Antimanipulación, Integridad de Pruebas y Restauración](#6-salvaguarda-fija-antimanipulación-integridad-de-pruebas-y-restauración)
7. [Barras Horizontales de Puntuación, Cobertura y Estándar de Modularidad](#7-barras-horizontales-de-puntuación-cobertura-y-estándar-de-modularidad)
8. [Ajustes en Dos Columnas y Recuperación de Estado Sellado](#8-ajustes-en-dos-columnas-y-recuperación-de-estado-sellado)
9. [Conexión de Agentes de IA (MCP de Escritorio y Guía para Móvil/Chat)](#9-conexión-de-agentes-de-ia-mcp-de-escritorio-y-guía-para-móvilchat)
10. [Referencia de Estándares Integrados (10 Ecosistemas + Pre-CI)](#10-referencia-de-estándares-integrados-10-ecosistemas--pre-ci)
11. [Licencia Workstation Pro, Vista Web y Escaneo Gratuito en Navegador](#11-licencia-workstation-pro-vista-web-y-escaneo-gratuito-en-navegador)
12. [Linux, GoogleBook, Actualizaciones, Privacidad y Soporte](#12-linux-googlebook-actualizaciones-privacidad-y-soporte)

### Parte II: Especificación Operativa para Máquinas y Agentes Autónomos
* [A. Puntos de Entrada y Transporte del Agente](#a-puntos-de-entrada-y-transporte-del-agente)
* [B. Medición, Acceso M2M de Enjambre y Desbloqueo Pro](#b-medición-acceso-m2m-de-enjambre-y-desbloqueo-pro)
* [C. Catálogo Completo de 27 Herramientas MCP Locales](#c-catálogo-completo-de-27-herramientas-mcp-locales)
* [D. Entorno Aislado Cold Box de Frontera, Regulador de 3 Bucles y Cierre](#d-entorno-aislado-cold-box-de-frontera-regulador-de-3-bucles-y-cierre)
* [E. Especificación Legible por Máquina para Agentes de IA (YAML)](#e-especificación-legible-por-máquina-para-agentes-de-ia-yaml)
* [F. Principios Operativos del Agente y Límites de Ejecución](#f-principios-operativos-del-agente-y-límites-de-ejecución)

---

## Parte I: Guía del Operador Humano y Banco de Trabajo

## 1. Glosario Rápido y Flujo Principal

* **Cómo funciona el flujo principal**: Elija una carpeta de proyecto -> Matlock ejecuta al instante un escaneo estático fuera del hilo de interfaz (`max(1, núcleos - 1)` aislamientos, dejando `1` núcleo libre) y descubre los scripts del espacio de trabajo -> Marque con **Estrella** los comandos que más usa en **Favoritos** -> Pulse **`Matlock`** para lanzar la única canalización autoritativa de verificación (`Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage` en `depth 0..2`, más Pre-CI multiplataforma y comprobaciones integradas y propias). **`Matlock`** prueba todo sin confirmar ni subir cambios (`0` `git push` integrado dentro de `Matlock` o rutinas precargadas — probar y subir quedan separados, mientras que usuarios y agentes MCP pueden añadir libremente tarjetas y cadenas propias de `git push` o despliegue en la nube), nunca instala `.git/hooks/*` ni bloquea commits locales.
* **Prueba frente a Error (Hallazgo)**: Una **Prueba** es una comprobación integrada inmutable o una **Comprobación propia** que aporta a su **Puntuación de Salud numérica de 0.0–100.0**. Un **Error** incluye `file:line:col` (`col >= 1`), etiquetas `[MITRE CWE-*]` / `[POSIX-*]` / `[MITRE Txxxx]`, motivo claro y prescripción diff depurada de 5 líneas.
* **Acción y Rutina (Secuencia)**: Una **Acción** es una tarjeta de comando local en 1 clic (`flutter test`, `npm run build`, copia `.bat`); una **Rutina** encadena **20+ tarjetas** en la **Línea de ejecución** con **Detener y avisar** (por defecto), **Detener** o **Continuar y avisar**.
* **Salvaguarda (`Safeguarded` / `AI agent can modify`)**: Sello fijo que protege pruebas, scripts, Acciones, Rutinas y Alertas (`Solo lectura y ejecución`). Cualquier edición externa o de IA no autorizada sobre un archivo o script Salvaguardado revierte automáticamente al original sellado y hace pulsar el **Sobre** de alerta.

## 2. Diseño de Pantalla, Temas y Navegación

* **Superficies Día y Noche descansadas**: Cambie en cualquier momento desde el botón **Tema** de la barra superior o **Settings -> Appearance** entre **Día blanco plata suave** (`#F8F9FA` / `#FFFFFF`) y **Noche pizarra carbón tonal** (`#131517` / `#181B20` / `#1E2228`). Cero ventanas emergentes interrumpen una ejecución; solo existen la confianza inicial de carpeta y un único aviso previo **Ask me before this runs** antes del Paso 1.
* **Barra Superior**: **`Browse...`** + ruta, gestor **`Ignored (N)`** de 5 alcances, **`Stop`** (`Ctrl+.` / `Esc`), **`Upgrade`** (Gratis), **`Value`**, **`Share`**, **`Bandeja del Sobre`** pulsante (`[x] Send Email Notifications`, `Send message`, `Mark all Done`, tarjetas de alerta/agente), **Selector de Tema**, **`?`** (`F1` Manual) y **`Settings`**.
* **Riel Izquierdo**: Tarjeta única autoritativa **`Matlock`**, puente bidireccional **`"Sincronizar con Headless"`** (`"Sync with Headless"`), **`Stop if Error & Notify`**, **`Notify`**, **`File size bar`** (Selector de Modularidad), **`+ Add card`**, **`FAVORITES`** marcados con Estrella, **`AVAILABLE COMMANDS`** / **`PROJECT STEPS`** autodescubiertos, comandos **`MACHINE`** y **`Notes`**.
* **Escenario Central y Terminal CLI Acoplada Siempre Abierta**: Pila de lista gestionada (`Start Process`, `Stop Process`, `Rerun failed`, selector **`Run`** / **`CI Code Health Report`** imprimible con `Ctrl+P`, filas por etapa y cola FIFO de **Run line**) sobre una **Terminal acoplada siempre abierta** (**Output**, **Problems**, **`Tests (N)`**, **`Coverage (N)`**, retención al seleccionar texto para copiar sin saltos, autoseguimiento + **Jump to latest**, **Find**, `Ctrl+K` **Quick Run** en Pro y **Barra CLI de Terminal** integrada para escribir y pulsar **`Ejecutar`** sobre cualquier comando como `git status`, `git push` o `wrangler deploy` sin abrir PowerShell ni `cmd.exe`, y convertirlo en 1 clic con **`Guardar tarjeta`** o **`Encadenar / Alerta`**).
* **Riel Derecho de Telemetría**: **Puntuación Matlock** numérica (`XX.X / 100.0`) con **Barras Horizontales de Puntuación de Salud y Cobertura Lógica Real**, contadores **`Tests Passed`** / **`Errors`**, **`Top 3 fixes`**, **`Largest untested files`**, gráfico **`Value`** y registros de pruebas eliminadas de **`Test integrity`**.

## 3. Scripts Descubiertos, Comprobaciones Propias, Acciones y Favoritos

* **Scripts Autodescubiertos y 6 Plantillas Iniciales Sin Configurar**: Al abrir una carpeta se descubren comandos de `package.json`, `Makefile`, `Cargo.toml`, `pyproject.toml`, `pubspec.yaml` y scripts `.bat`/`.ps1`/`.sh` en **Available Commands** (nunca marcados solos — pulse **Estrella** para fijar **Favorites**), junto a **6 plantillas iniciales presembradas sin configurar** (**GitHub**, **Save to Thumb Drive / Drive**, **AWS / Google Cloud**, más tarjetas Machine **Save**, **Defrag / Optimize**, **Shut Down**). Al pulsar una plantilla sin configurar se abre su editor para escribir su script batch/shell — o su agente MCP conectado la programa y fija en Favoritos por usted — y una vez programada corre en 1 pulsación.
* **Giro de Terminal CLI + Editar -> Script Fuente + Salvaguarda Fija**: Escriba cualquier comando en la barra CLI de la Terminal siempre abierta y pulse **`Guardar tarjeta`** (tarjeta en 1 pulsación) o **`Encadenar / Alerta`** (paso en serie con parada ante fallo o alerta por correo), o pulse **Edit** en cualquier tarjeta descubierta o creada para ver/editar su comando/script, directorio, tiempo límite, **`Ask me before this runs`**, **`Count a failure against my health score`** y **`Safeguard`** fijo (`[LOCKED]` de solo ejecución para agentes frente a `[MODIFIABLE]` refinable por el agente con revisión diff antes/después en el **Sobre** pulsante para **Aceptar** / **Revertir**).
* **Añadir Comprobación Propia (`+ Add card -> Custom check`)**: Cree una regla de **Find Text in Files** (texto/regex) o **Run a Script** (`exit 0` = Aprobado; líneas `file:line:col: message` leídas como hallazgos) con severidad (`Critical`, `Major`, `Warning`, `Info`), guardada en el almacenamiento local privado del perfil de usuario fuera de su repositorio.
* **Manejo de `.bat` y `robocopy` en Windows**: `stdin` cerrado (`<nul`) y contención de procesos evitan bloqueos; `%i` en una línea se normaliza a `%%i`; códigos `0–7` de `robocopy` cuentan como **Aprobado** (`>= 8` = Fallido).

## 4. Rutinas Autónomas, Comandos de Equipo y Alertas Locales

* **Rutinas Autónomas y Cadenas Propias de Push/Despliegue (`+ Add card -> Sequence` o `Encadenar / Alerta`)**: Encadene **20+ tarjetas** en serie con **`Matlock`** primero por defecto, opción por paso **Always run this step, even if an earlier step failed** y una única aprobación previa **Ask me before this runs** antes del Paso 1. Incluye plantillas **Nightly check**, **Deploy to Cloudflare** y **Backup and power off** (más plantillas **Destination** con su CLI local y `0` credenciales en Matlock; las pruebas de `Matlock` tienen `0` `git push` integrado, mientras que usuarios y agentes MCP pueden añadir libremente tarjetas y cadenas propias de `git push` o despliegue en la nube).
* **Tarjeta de Notificación / Alerta por Correo (`Notify` o `Settings -> Email Alerts` — Paso a Paso)**: **(1)** Genere una **Contraseña de Aplicación / Código de Autorización de 16 caracteres** en los ajustes de seguridad 2FA de su proveedor de correo (nunca use su contraseña normal de inicio de sesión cuando 2FA esté activo), abra **`Notify`** o **`Settings -> Email Alerts`** e indique correo remitente/destinatario + Contraseña de Aplicación o Código de Autorización (SMTP solo de salida sobre Native Dart TLS 1.2/1.3 con verificación X.509, `0` acceso entrante al buzón IMAP/POP3, `0` servidores relay de Dutch P2P; preajustes globales para Gmail / Workspace, Microsoft 365 / Outlook, Yahoo, iCloud, código de autorización QQ / 163 de 16 caracteres, Zoho Global/EU/IN, Fastmail, Yandex, Mail.ru, Aliyun, GMX / Web.de activando POP3/SMTP externo y Proton Mail Bridge local `127.0.0.1:1025`; credenciales cifradas en el llavero del SO o bóveda local de contenedor sellada con frase de paso) o pruébelo en headless con `matlock-mcp send-alert --subject "..." --body "..."`) y pulse **`Test Email`** — o elija **`custom_script`** local (`MATLOCK_ALERT_*` y píldoras `{{status}}`, `{{where_failed}}`, `{{completion_summary}}`). **(2)** Ejecútela sola en **1 clic** cuando quiera. **(3)** Adjúntela a cualquier secuencia con **`Detener y alertar`** (disparo solo en error) o **`Continuar y alertar`** / `always` (`send_alert`: aviso incondicional al finalizar).
* **`MACHINE` (8 Comandos Editables de Equipo — Nunca se Ejecutan Solos)**:

| Tarjeta | Windows | Linux | Notas |
| :--- | :--- | :--- | :--- |
| Shutdown in 30 minutes | `shutdown.exe /s /t 1800` | `shutdown -h +30` | Espera de 30 min, nunca `/f`; junto a Cancel shutdown |
| Cancel shutdown | `shutdown.exe /a` | `shutdown -c` | Cancelación inmediata en 1 clic |
| Clean temporary files | Solo carpeta temp del usuario, omite en uso | Archivos > 1 día en `~/.cache` y `/tmp` | Nunca toca archivos del proyecto |
| Check disk space | `Get-PSDrive -PSProvider FileSystem` | `df -h` | Solo lectura |
| Optimize disk (defrag or trim) | `Optimize-Volume -DriveLetter C -Verbose` | `fstrim -av` | Requiere admin/root; avisa limpio sin pedir UAC/`sudo` |
| Backup copy | `robocopy . "<backup-folder>" /MIR` | `rsync -a --delete ./ "<backup-folder>/"` | Conserva `.git`, omite cachés; `robocopy` `0–7` = Aprobado |
| Find a Word & Expose It | `findstr /s /i /m /c:"Aluminium" *.dart` | `grep -rnI "Aluminium" --include="*.dart" .` | Búsqueda recursiva editable sin distinción de mayúsculas |
| Lines Over 250 Catch | `for /r %i in (*.dart) do ... find /c /v ""` | `find . -name "*.dart" -exec awk '... c>250 ...' {} +` | Escaneo de lectura para archivos de más de 250 líneas |

## 5. Cascada de Resultados, Reejecución Aislada, Ignorar y Copiar

* **Cascada de Categorías con Más Errores Primero**: Las categorías del escaneo se ordenan automáticamente mostrando arriba las que concentran más errores activos para atender primero lo crítico sin desplazarse por comprobaciones limpias.
* **Resaltar para Copiar y Reejecución Aislada por Categoría**: Seleccione cualquier texto de hallazgos para copiarlo al instante, pulse **Share for Agent / Copy** (`Ctrl+Shift+C`) para obtener `folder/file:line` + `[MITRE CWE-*]` / `[POSIX-*]` + prescripciones diff de 5 líneas, o pulse **Rerun** en una categoría para reverificar solo esa categoría en milisegundos (insignia `?` Estimate hasta correr `Matlock` completo).
* **Ignorar de 5 Alcances Fuera del Repo (`Ignored (N)`)**: Aparte `file:line:code`, `file:code`, `*:code`, `file` o `folder/` (`0` penalización, **Restore** / **Restore all** en 1 clic, opción **Send & Ignore** para falsos positivos). Los comentarios en código (`// ignore:`, `/* nolint */`, `# noqa`, `@ts-ignore`) nunca silencian Matlock, y los agentes tienen cero herramientas MCP para escribir ignorados.

## 6. Salvaguarda Fija Antimanipulación, Integridad de Pruebas y Restauración

* **Por qué importa Salvaguarda**: Las comprobaciones integradas están compiladas en el binario nativo y **Safeguard** sella pruebas de usuario, scripts descubiertos/propios, Acciones, Rutinas y Alertas (`[LOCKED]` / `Solo lectura y ejecución` mediante `matlock_run_action` / `matlock_run_sequence`, mientras las tarjetas `[MODIFIABLE]` permiten al agente refinar scripts enviando un diff al **Sobre** para su aprobación).
* **Reversión Determinista al Original y Alerta del Sobre**: Si un agente de IA o herramienta externa modifica sin permiso una prueba o script Salvaguardado, Matlock restaura de forma determinista el archivo original sellado (guardando copia de deshacer fuera del repo), hace pulsar el **Sobre** superior con `[Matlock Alert] Critical test altered: <test_name>` y detiene ejecuciones headless (`exit 65`).
* **Integridad de Pruebas y Restauración Aprobada por Persona**: Pruebas borradas, omitidas o debilitadas generan **registros persistentes de pruebas eliminadas** que retienen **Ready to push** hasta que una persona marque **OK, I did this**, **Suspicious** o use **Settings -> Safeguard & Restore -> Allow Matlock to restore tests** (vista diff + copia undo). **Sync across my computers** (Pro) escribe archivos `<computer-id>.matlock-sync` sellados con frase de paso (`0` código fuente, `0` llamadas de red).

## 7. Barras Horizontales de Puntuación, Cobertura y Estándar de Modularidad

* **Puntuación Numérica y Barras Horizontales**: Muestra **`XX.X / 100.0`** (`--` antes de la primera ejecución) junto a barras horizontales de **Puntuación de Salud** y **Cobertura Lógica Real**, contando lógica de producción no probada y excluyendo código generado. Fallos de compilación, dependencias o pruebas limitan la puntuación por debajo del rango listo para publicar; **`Format`** es solo informativo (`0` puntos restados).
* **Selector de Modularidad Exclusivo para Personas (`CWE-1080` / `CWE-1120`)**: Ajústelo en **`File size bar`** del riel izquierdo o **`Settings -> Project & Runner`** (`*Based on Grade C standard. Adjust in settings`, sellado en el SO, `0` archivos en repo, `0` escritura MCP): **`Grade A (<= 60 / <= 25 fn)`**, **`Grade B (<= 100 / <= 40 fn)`**, **`Grade C (<= 250 / <= 80 fn)` [Por defecto]**, **`Grade D (<= 500 / <= 120 fn)`** o **`Minimum (<= 1000 / <= 250 fn)`**.
* **Veredicto `Ready to push`**: Exige puntuación lista para entrega con `0` hallazgos Críticos, compilación y pruebas aprobadas, `0` registros de pruebas eliminadas abiertos y cobertura no provisional.

## 8. Ajustes en Dos Columnas y Recuperación de Estado Sellado

Pulse **`Settings`** arriba a la derecha para abrir el diálogo en 2 columnas (riel izquierdo de 6 categorías + controles concisos a la derecha; cada encabezado incluye un botón **`?`** que abre su sección exacta del Manual):
1. **`Appearance`**: **Idioma** (9 idiomas + idioma del texto copiado), **Tema** (`System Default`, `Light`, `Dark Slate`), acceso directo de escritorio y **Minimize to System Tray when closed** en Windows.
2. **`Project & Runner`**: **Selector de Modularidad** (`Grade A..Minimum`), **`Open folder`** del perfil local (carpeta privada del perfil de usuario), **Restaurar aviso de configuración inicial** (`Restore starter setup banner`, reabre `Set up for me`), **`Keep Quick Run history`** y **`Reset Ignore Registry`**.
3. **`Safeguard & Restore`**: **`Allow Matlock to restore tests`**, reversión automática de Salvaguarda solo para personas y **`Sync across my computers`** (sincronización sellada por carpeta).
4. **`Email Alerts`** (`matlock://settings/alerts`): Estación local de alertas **`email_smtp`** y **`custom_script`** + **`Test Email`**.
5. **`AI Agent (MCP)`**: Interruptor **`MCP Server (stdio)`** (apagado por defecto), puente bidireccional **`"Sincronizar con Headless"`** (`"Sync with Headless"` en 1 clic para cargar tarjetas/secuencias del agente y publicar órdenes permanentes con `0` sondeos en segundo plano), **`Test MCP Connection`**, **`Copy MCP Config & Agent Instructions`**, **`Copy a question for my phone AI`** y **`Agent Email Bridge`**.
6. **`License & Updates`**: **`Activate`** de clave de 24 caracteres / **`Move license to this device`**, **`Automatically check for updates`** (`MATLOCK_OFFLINE=1` bloquea toda red saliente), **`Send anonymous crash diagnostics`** (apagado por defecto; `MATLOCK_NO_TELEMETRY=1`), **`Copy diagnostic info`**, **`Free up memory`**, **`Share Matlock`**, **`Contact us`** (`dutch@dutchp2p.com`) y **`Dutch P2P Tools`**.
* **Recuperación de Estado Sellado (`Reset Ignore Registry`)**: Si ediciones externas disparan `integrity_seal:MUTE_SEAL_TAMPERED` o `storage_recovery:BAK_AUTO_RESTORE`, abra **`Settings -> Project & Runner -> Storage & backup -> Reset Ignore Registry`**.

## 9. Conexión de Agentes de IA (MCP de Escritorio y Guía para Móvil/Chat)

* **Cómo conectar por `stdio` local y `"Sincronizar con Headless"` (`0` Puertos Abiertos)**: Abra **`Settings -> AI Agent (MCP)`**, active **`MCP Server (stdio)`**, pulse **`Copy MCP Config & Agent Instructions`** (o **`Copy MCP Guide for Agent`** dentro de `?`) y pulse **`"Sincronizar con Headless"`** (`"Sync with Headless"` en Configuración o en el Riel Izquierdo) para sincronizar tarjetas del agente y órdenes permanentes en ambos sentidos:

```json
{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}
```

* **Compatibilidad Universal con Clientes, Lanzadores y Chats**: Ejecute sin configuración mediante `npx -y @dutchp2p/matlock-mcp` o `uvx matlock-mcp`; funciona con `VS Code, Cursor, Claude Code/Desktop, Antigravity, Gemini CLI, Copilot, Codex, Windsurf, JetBrains/Junie, Trae, Lingma, MarsCode, CodeGeeX, Baidu Comate, Tencent CodeBuddy, Zed, Cline, Roo Code, Continue, Aider, Goose, OpenHands, Devin, Replit Agent, Sourcegraph Amp`, Kimi, Qwen, DeepSeek, Doubao, MiniMax y agentes locales `Ollama/vLLM/SGLang/LM Studio`. Los agentes conectados llaman a `matlock_read_appliance_manual(section_id, locale)` por `0` créditos (9 idiomas), o puede pegar [https://matlock.dutchp2p.com/es/manual.md](https://matlock.dutchp2p.com/es/manual.md) / [https://matlock.dutchp2p.com/llms.txt](https://matlock.dutchp2p.com/llms.txt) en cualquier chat de móvil o navegador. Para consultar las instrucciones de compatibilidad actualizadas con nuevos IDEs, arneses de agentes y plataformas de contenedores, visite [https://matlock.dutchp2p.com/es/docs.html](https://matlock.dutchp2p.com/es/docs.html).

## 10. Referencia de Estándares Integrados (10 Ecosistemas + Pre-CI)

Cada comprobación integrada está compilada en Matlock y anclada a controles técnicos de **MITRE CWE**, **CISA SSDF (`NIST SP 800-218`)**, **IEEE Std 1003.1 POSIX**, **compuertas Pre-CI** y **AICPA SOC 2 Trust Services Criteria**:

| Ecosistema y Dominio | Qué Inspecciona Matlock y Fallos de Producción Evitados |
| :--- | :--- |
| **Núcleo Poliglota y Dart / Flutter** | Bloques catch silenciosos (`CWE-391`), riesgos null/límites (`CWE-476`/`CWE-125`), carreras async sin await, fugas de streams/timers/controladores (`CWE-401`), bucles infinitos (`CWE-835`), secretos fijos (`CWE-798`), secretos en logs (`CWE-532`), desactivación de verificación de certificados TLS en HTTP/SMTP/CLI/CI (`CWE-295` / `[MITRE T1557]`), SQLi (`CWE-89`), SSRF (`CWE-918`), XXE (`CWE-611`), JWT sin firma (`CWE-347`), redirecciones abiertas (`CWE-601`), falta de timeouts, escrituras no atómicas, salto de rutas (`CWE-22`) y pruebas huecas (`CWE-362`). |
| **Java** (`.java`) | Claves incrustadas (`CWE-798`), inyección de comandos/SQL (`CWE-78`/`CWE-89`), deserialización insegura (`CWE-502`), cifrados débiles (`CWE-327`), excepciones silenciadas (`CWE-391`), fugas JDBC/streams (`CWE-404`), errores `==` en cadenas, `System.exit` abrupto y esperas en bucle. |
| **Python** (`.py`) | Secretos fijos (`CWE-798`), inyección shell/SQL (`CWE-78`/`CWE-89`), cargas inseguras `pickle`/`yaml` (`CWE-502`), hashes débiles (`CWE-328`), `except` vacío (`CWE-391`), argumentos mutables por defecto, descriptores abiertos (`CWE-775`), llamadas síncronas en `async def` y pruebas huecas. |
| **Rust** (`.rs`) | Secretos incrustados (`CWE-798`), cadenas shell/SQL formateadas (`CWE-78`/`CWE-89`), conversiones `unsafe` sin guardia, TLS desactivado (`CWE-295`), pánicos `.unwrap()`/`todo!()` en producción, esperas bloqueantes en async, fugas intencionales (`CWE-401`), `Result` descartados y pruebas huecas. |
| **Go** (`.go`) | Tokens fijos (`CWE-798`), exec/SQL concatenados (`CWE-78`/`CWE-89`), `InsecureSkipVerify` (`CWE-295`), RNG débil (`CWE-330`), errores ignorados (`CWE-252`), fugas `defer` en bucle y contextos sin cancelar (`CWE-404`), clientes HTTP sin timeout, `panic` en producción y pruebas huecas. |
| **TypeScript y JavaScript** (`.ts`, `.tsx`, `.js`, `.jsx`) | Secretos expuestos (`CWE-798`), sumideros DOM XSS / `eval` (`CWE-79`/`CWE-95`), interpolación shell (`CWE-78`), contaminación de prototipos (`CWE-1321`), `.catch()` vacío (`CWE-391`), supresiones de tipos, errores `NaN`, bloqueos de E/S síncrona, restos `debugger` y fugas de listeners/timers (`CWE-401`). |
| **C y C++** (`.c`, `.cpp`, `.cc`, `.h`, `.hpp`) | Secretos fijos (`CWE-798`), copias FFI/búfer sin límite (`CWE-787`/`CWE-120`), cadenas de formato (`CWE-134`), inyección `system()` (`CWE-78`), `new[]`/`delete` incompatibles (`CWE-762`), use-after-free (`CWE-416`), destructores que lanzan, `memset` sobre objetos no triviales e hilos sin `join`. |
| **Kotlin y Android** (`.kt`, `.kts`) | Secretos fijos (`CWE-798`), concatenación SQL (`CWE-89`), puentes WebView inseguros, TLS omitido (`CWE-295`), preferencias legibles globalmente (`CWE-276`), corrutinas `GlobalScope` fugadas (`CWE-401`), bloqueos del hilo principal, cierres `!!`, `CancellationException` tragada y cabeceras ZIP/APK dañadas (`CWE-190`). |
| **C# y .NET** (`.cs`) | Manejadores `IDisposable` sin cerrar (`CWE-404`), fallos `async void`, cadenas SQL/comandos sin parametrizar (`CWE-89`/`CWE-78`), validación de certificados TLS desactivada (`CWE-295`), excepciones silenciadas (`CWE-391`), interbloqueos síncronos `.Result`/`.Wait()` y pruebas huecas. |
| **SQL y Motores de Almacenamiento** (`.sql`) | Permisos comodín (`CWE-250`), SQL dinámico concatenado (`CWE-89`), contraseñas en texto plano en DDL (`CWE-256`), escape a comandos del SO (`CWE-78`), RLS desactivado, `DELETE`/`UPDATE` sin predicado, migraciones no idempotentes, paginación `OFFSET` profunda y bloqueos de tabla sin guardia. |
| **Pre-CI Multiplataforma, Bash/Shell (`.sh`), PowerShell (`.ps1`), `Dockerfile` y GitHub Actions YAML** | Colisiones de mayúsculas/minúsculas (`POSIX.1`), shebangs `CRLF`, trampas de portabilidad Bash/POSIX y errores `$ErrorActionPreference` / `LASTEXITCODE` en PowerShell, etiquetas `Dockerfile` sin fijar y contenedores como root, excesos de presupuesto HTML/activos, trampas `.cmd`/`.bat` en Windows, descriptores fugados (`CWE-775`), separadores de ruta fijos, imports no rastreados, deriva de lockfiles, permisos abiertos en GitHub Actions YAML, inyección en workflows y pérdida de bits `+x`. |
| **Modularidad y Comprobaciones Propias** | **Selector de Modularidad** exclusivo para personas (`Grade A <= 60` hasta `Minimum <= 1000`, por defecto `Grade C <= 250` archivo / `<= 80` fn; `CWE-1080` / `CWE-1120`) más comprobaciones de patrón y script guardadas en su perfil del SO. |

## 11. Licencia Workstation Pro, Vista Web y Escaneo Gratuito en Navegador

* **Workstation Pro Ilimitado (aprox. 23 €\* ($24.99 USD/año), Cero Cuentas)**: Desbloquea el Centro de Comando de Escritorio completo (`1` ordenador activo, máx. `1` traslado de hardware al año mediante **`Move license to this device`**) más ejecuciones MCP locales y headless ilimitadas a `$0.00/pass` durante todo un año. Pulse **`Upgrade`** en Escritorio (o visite [https://matlock.dutchp2p.com/es/pricing](https://matlock.dutchp2p.com/es/pricing)) para pagar con **Tarjeta** (o **Stablecoin USD / PayPal** instantáneo en `Solana USDC`, `PayPal PYUSD`, `Base USDC` y `Polygon USDC`, o con tarjeta mediante MoonPay y Transak), copie su **clave de 24 caracteres** + `/receipt/<id>` y actívela en **`Settings -> License & Updates`**. El Escritorio Gratuito incluye **`Matlock`**, `CI Code Health Report` (con cortesía en secretos), `File size bar`, `Notes` y restauración de `Ignored`; Pro desbloquea Acciones, Favoritos con Estrella, Rutinas, comandos Machine, Quick Run (`Ctrl+K`), `Ignore` de ojo tachado y coordenadas `file:line:col` exactas.
* **Centro de Comando Web y Escaneo Gratuito**: [https://matlock.dutchp2p.com/es/#wasm-instant-audit](https://matlock.dutchp2p.com/es/#wasm-instant-audit) audita carpetas locales (`0` llamadas de red) o URL públicas opcionales de repositorios GitHub (obtenidas directamente entre su navegador y `api.github.com` / `raw.githubusercontent.com`, `0` bytes por servidores de Dutch P2P; precios Markdown en `/es/pricing.md`) en la RAM del navegador con **Diagnostic Service Order** imprimible. [https://matlock.dutchp2p.com/es/app](https://matlock.dutchp2p.com/es/app) muestra el diseño Día/Noche, barras horizontales de puntuación/cobertura, botón único **`Matlock`**, barra **CLI de Terminal** acoplada (`Ejecutar` / `Guardar tarjeta` / `Encadenar / Alerta`), **`Copy this card as a script`** y **`Paste output from your run` -> `Color it`** (`Only in the desktop app` marca controles nativos).

## 12. Linux, GoogleBook, Actualizaciones, Privacidad y Soporte

* **Instalación en GoogleBook y Linux**: En **GoogleBook**, active **Configuración -> Desarrolladores -> Entorno de desarrollo de Linux**, instale `matlock-linux-x64.deb` y mantenga los repositorios activos en `Archivos de Linux` (`$HOME` `ext4`) para máxima velocidad. En **Linux**, instale `.deb` (`sudo apt install ./matlock-linux-x64.deb`) o ejecute `chmod +x matlock-linux-x64.AppImage` (`--appimage-extract-and-run` funciona sin `libfuse2`).
* **Parada de Procesos, Actualizaciones y Desinstalación**: **`Stop`** (`Ctrl+.` / `Esc`) termina todo el árbol de procesos del SO (`0` zombis) y libera bloqueos de suspensión (mantenga la tapa abierta en secuencias largas). Windows actualiza por Microsoft Store y `AppImage` verifica `SHA-256` de forma atómica conservando el 100% de sus datos locales. Desinstale desde **Aplicaciones instaladas** / `apt remove matlock` / borrando el `AppImage`. Soporte: **`dutch@dutchp2p.com`**.

---

## Parte II: Especificación Operativa para Máquinas y Agentes Autónomos

### A. Puntos de Entrada y Transporte del Agente
* **Transporte**: JSON-RPC 2.0 por `stdio` local (`0` puertos TCP/UDP abiertos, `0` sockets HTTP en localhost).
* **CLI Complementaria de Escritorio**: `matlock.exe mcp --stdio` (Windows) · `matlock mcp --stdio` o `/path/to/matlock-linux-x64.AppImage mcp --stdio` (Linux y GoogleBook).
* **Motor Headless sin Pantalla, `setup` de Contenedores en 2 Líneas y Aviso Proactivo de Alertas**: `npx -y @dutchp2p/matlock-mcp`, `uvx matlock-mcp`, hook `setup` de contenedor en 2 líneas (`agent-install.sh` + `matlock-mcp toolbag --json`) (para **Cloudflare `ContainerHarness` / `Codex` `cloudflare/debian-trixie`**, Docker, E2B y Firecracker) o `matlock-mcp --stdio --headless --no-coverage` en Linux `x64`, Windows `x64` y macOS `arm64` ([https://matlock.dutchp2p.com/es/agents](https://matlock.dutchp2p.com/es/agents) · compatibilidad viva con IDEs y contenedores: [https://matlock.dutchp2p.com/es/docs.html](https://matlock.dutchp2p.com/es/docs.html); expone anotaciones `readOnlyHint: true` y `prompts/list`: `matlock-verify-before-push`, `matlock-fix-top-findings`, `matlock-setup-action-chain`). En la primera sesión `--headless` habilitada sin alerta de correo configurada, Matlock emite una sugerencia única no bloqueante para que el agente pregunte una sola vez al desarrollador si desea configurar alertas por correo desatendidas mediante `matlock_set_alert` (llavero del SO o bóveda de contenedor local sellada con frase de paso vía `MATLOCK_VAULT_PASSPHRASE`), sin repetirla tras responder o descartar:

```json
{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}
```

### B. Medición, Acceso M2M de Enjambre y Desbloqueo Pro
* **Cero Pases Gratuitos Desbloqueados y Prueba de Valor `HTTP 402` en `< 50ms`**: Llamar `Index 0` `matlock_run_scan(target_path)` sin saldo corre localmente en `< 50ms` (`$0.00`, `0` subidas a la nube, `0` bloqueo de commits) y devuelve Puntuación de Salud `0.0–100.0`, recuentos por severidad, CWE/categorías infringidas, etiquetas `MITRE ATT&CK` `T*` y ahorro `ast_token_savings` en vivo (`0` nombres de archivo, `0` línea/columna, `0` parches diff). Tras cada cargo pagado de `1` crédito en el mismo espacio de trabajo, se incluyen hasta **`3` revisiones delta `changed_only: true` durante `10` minutos** sin coste extra.
* **Desbloqueo Ágil por Dos Vías**: **Vía A (Monedero Propio del Agente)** — desbloquee acceso medido M2M para enjambres de agentes autónomos en **Solana USDC**, **Solana PYUSD**, **Base USDC** o **Polygon USDC** mediante `matlock_run_scan(target_path, transaction_signature)` o `matlock_purchase_license(transaction_signature)` (consulte el **Catálogo de Agentes MCP** en `https://matlock.dutchp2p.com/es/agents` y `/agents.md` para herramientas headless y precios para enjambres). **Vía B (Puente de Pago Humano)** — comparta la URL de transferencia de pago devuelta por `402` (`/es/pricing.md`) para que el desarrollador desbloquee **Workstation Pro Ilimitado por aprox. 23 €\* ($24.99 USD/año)** (`matlock_purchase_license(license_key)` o `matlock-mcp activate <KEY>` para pases ilimitados a `$0.00/pass`). La CLI headless sale con `77` (`EX_NOPERM`) en `402` y `65` (`EX_DATAERR`) ante alteración de Salvaguarda/sello.

### C. Catálogo Completo de 27 Herramientas MCP Locales
1. **`matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?)`**: `Index 0` (`readOnlyHint: true`) escaneo AST, CWE, POSIX y Pre-CI en `< 50ms` con `file:line:col` (`col >= 1`), `cwe`, `mitre_attack` y prescripciones diff de 5 líneas (también admite CLI `matlock-mcp scan . --format=sarif` en `SARIF 2.1.0`).
2. **`matlock_describe_project(target_path?, mode?)`**: Perfil opcional del espacio de trabajo (`0` créditos, `readOnlyHint: true`); pase **`mode: "tool_bag"`** (o CLI **`matlock-mcp toolbag [--json]`**) para un inventario progresivo de `~350–550` tokens con tarjetas `[LOCKED]` (solo ejecución) frente a `[MODIFIABLE]` (refinables), secuencias, insignias `[NEW]` / `[UPDATED]`, marcas `[UNAVAILABLE IN CONTAINER]`, órdenes permanentes y estado de alertas.
3. **`matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?)`**: Hallazgos paginados (`25`/página; Escritorio oculta líneas Salvaguardadas hasta desbloquearlas; `--headless` con Depósito de Gas desbloquea coordenadas).
4. **`matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?)`**: Verifica 1–5 archivos de prueba (`test_file` / `test_files`) en 3 compuertas (ejecución aprobada con `>= 1` aserción, `0` avisos del analizador + límite LOC, `0` hallazgos Matlock) antes de sellarlos en Salvaguarda, o sella línea base (`baseline_only: true`).
5. **`matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?)`**: Inspecciona registros de integridad de pruebas eliminadas y añade notas explicativas del agente (`0` permisos de cierre).
6. **`matlock_get_history(target_path?, limit?)`**: Historial de solo lectura de puntuación y correcciones.
7. **`matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?)`**: Manual sin conexión (9 idiomas) y consulta de CWE/POSIX/SSDF/SOC2/resultados (`0` créditos, `0` red).
8. **`matlock_list_custom_tests`**: Lista comprobaciones propias definidas por el usuario.
9. **`matlock_register_custom_test`**: Guarda una comprobación propia de patrón o script.
10. **`matlock_delete_custom_test`**: Borra una comprobación propia desbloqueada (las integradas son inmutables).
11. **`matlock_list_actions`**: Lista tarjetas de acción (con `favorite`/bloqueo/aprobación) más `recommendedTemplates` sin configurar (`unconfiguredTemplate: true`).
12. **`matlock_register_action(id, command, name?, favorite?)`**: Programa o actualiza cualquier Acción desbloqueada o plantilla inicial (`tpl_github`, `tpl_save_drive`, `tpl_cloud_sync`, `tpl_save_backup`, `tpl_defrag_optimize`, `tpl_shut_down`), limpia `unconfiguredTemplate`, fija/quita Favoritos (`favorite: true | false`) y fuerza **Require Approval** en Escritorio.
13. **`matlock_register_sealed_script`**: Sella comandos de compilación/pruebas (**Locked by User**) frente a subagentes.
14. **`matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?)`**: Ejecuta un comando bajo contención de árbol de procesos del SO (`async: true` no bloqueante, `send_alert`, tarjetas propias de USB `robocopy`/`rsync`, nube R2/S3/GCS/Azure y `git push`; `0` `git push` integrado en ejecuciones de prueba `Matlock`).
15. **`matlock_get_action_status(id?)`**: Consulta estado en vivo, código de salida y cápsulas compactas para tareas `async: true`.
16. **`matlock_stop_action(id?, stop_sequence?)`**: Termina un árbol de procesos activo al instante (`stop_sequence: true` detiene toda la secuencia activa).
17. **`matlock_delete_action`**: Borra una tarjeta de acción desbloqueada.
18. **`matlock_list_sequences`**: Lista rutinas de varios pasos.
19. **`matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?)`**: Compone o edita en línea una Secuencia desbloqueada, insertando cualquier Acción o `alert::<id>` en el índice exacto `insert_at_index` (base `0`) con `failure_policy` (`"stop" | "stop_and_alert" | "continue_and_alert"`), `always_run` y `favorite: true | false`.
20. **`matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?)`**: Ejecuta `seq_matlock` o `seq_fast_verify` (`file` para probar un único archivo, `async: true` para ejecución en segundo plano con despertar automático al terminar, `send_alert` para alertas; `cold_box: false` predeterminado para velocidad; `cold_box: true` antes de guardado externo, sincronización en nube, copia de seguridad, push o compilación con recibo en `< 15ms` si ya está verificado; `deep: true` fuerza limpieza y cobertura completas).
21. **`matlock_delete_sequence`**: Borra una rutina desbloqueada.
22. **`matlock_list_alerts`**: Lista canales de alerta locales (secretos enmascarados).
23. **`matlock_set_alert`**: Configura alertas locales `email_smtp` de solo salida con Native Dart TLS 1.2/1.3 (preajustes globales, llavero del SO o bóveda de contenedor local sellada con frase de paso) o `custom_script`.
24. **`matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move)`**: Envía notificación local con las 3 preguntas obligatorias de cierre.
25. **`matlock_delete_alert`**: Borra una tarjeta de alerta desbloqueada.
26. **`matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?)`**: Liquida asignaciones medidas de enjambre de agentes autónomos (ver `/es/agents`) o activa una `license_key` Pro de 24 caracteres de aprox. 23 €\* ($24.99 USD/año).
27. **`matlock_report_issue(category, subject, description, tool_context?, output_dump?)`**: Envío asíncrono depurado de comentarios/sugerencias (`0` créditos, `CONTINUE_IMMEDIATELY`).

### D. Entorno Aislado Cold Box de Frontera, Regulador de 3 Bucles y Cierre
* **`cold_box: true` Solo en Frontera (`OFF` por Defecto)**: `matlock_run_sequence` usa `cold_box: false` por defecto para iterar rápido en sitio (`0` afinidad fija de CPU). Pase `cold_box: true` (`id: "seq_matlock"`) justo antes de un git push externo, guardado en nube, copia en unidad extraíble o compilación de lanzamiento para verificar en una copia estéril `$TEMP` (`CI=true`, `stdin` cerrado, auditoría `CWE-775` de descriptores/huérfanos).
* **Cortacircuitos de Bucles de 2 Niveles y 3 Preguntas Obligatorias**: El Nivel 1 limita a **3** los reintentos atascados por regla/archivo devolviendo **`STOP_IMMEDIATELY`** (objetivo único) o **`SKIP_AND_MOVE_ON`** (sprint multiarchivo); el Nivel 2 detiene la sesión cuando **2** áreas omitidas distintas se estancan, devolviendo **`HALT_FOR_REPLACEMENT`** (`loopGovernorDirective: "STOP_AND_ALERT_USER"`) y escribiendo un `session_handoff.json` depurado de secretos en `< 200` tokens que orienta a un agente de relevo hacia `agents.md` y la meta activa (`agent_id` / `MATLOCK_AGENT_ID` aísla ayudantes en paralelo). Al llamar `matlock_trigger_alert`, el agente debe completar **`task_completed`**, **`uncovered_issues`** (nunca `"None"`) y **`next_move`**.

### E. Especificación Legible por Máquina para Agentes de IA (YAML)

```yaml
product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/es/app"
free_local_scan: "https://matlock.dutchp2p.com/es/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/es/docs"
online_manual: "https://matlock.dutchp2p.com/es/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"
```

### F. Principios Operativos del Agente y Límites de Ejecución
* **Principio 1 (Sin Debilitamiento ni Supresión de Pruebas)**: Nunca borre pruebas, relaje aserciones ni inyecte supresiones en línea (`// ignore:`, `/* nolint */`, `# noqa`, `@ts-ignore`); hacerlo genera registros de integridad de pruebas eliminadas, revierte archivos Salvaguardados y detiene ejecuciones headless (`exit 65`).
* **Principio 2 (Inmutabilidad de Salvaguarda y Separación entre Pruebas y Push)**: Los elementos **Safeguarded** son de solo lectura y ejecución, Matlock nunca instala `.git/hooks/*` y `Matlock` (`seq_matlock`) nunca confirma ni sube cambios durante las pruebas (usuarios y agentes MCP pueden registrar libremente tarjetas y cadenas propias de `git push` o despliegue en la nube).
* **Principio 3 (Cold Box en Frontera y Procedencia en PR)**: Mantenga `cold_box: false` durante sprints rápidos de codificación, ejecute `matlock_run_sequence(id: "seq_matlock", cold_box: true)` antes de push/nube/copia/compilación, deténgase ante `STOP_IMMEDIATELY` / `HALT_FOR_REPLACEMENT` (`STOP_AND_ALERT_USER`) e incluya el `pr_verification_badge` de solo logotipo (`https://matlock.dutchp2p.com/badge/verified.svg`) en las descripciones de Pull Request cuando `verdict == "PASSED"`.