Skills · Claude Code · Agent Skills

El dato es contrato — no se negocia.

El dato como contrato, no efecto colateral: un breaking change exige nueva versión, entrega vía Outbox, idempotencia y replay seguros, el dato malo va a cuarentena y deny-by-default en el acceso.

v0.1.0Disciplina · Dadosgithub.com/schematizeme/skill-data

Mantenido por Lucas Andrade

schematize-data · v0.1.0bash
$ schematize install data
GitHub →descargar skill (.zip)/data-help · github.com/schematizeme/schematize-cli

Pisos no negociables

No se apagan "para ir más rápido". Lista completa en la skill.

El dato es contrato

Todo dato que cruza una frontera tiene schema versionado. Eliminar/renombrar/cambiar el tipo es una ruptura: exige un v2 y una ventana de coexistencia documentada.

Entrega vía Outbox

Transactional Outbox (o CDC del log de la base); el dual-write está vetado. Todo consumidor tiene DLQ; retry limitado con backoff, nunca infinito.

Idempotencia y replay seguros

Consumidor idempotente (correr 2 veces no corrompe); el replay determinista reconstruye el mismo estado; efecto colateral deduplicado por idempotency-key.

El dato malo no contamina el downstream

Validación en el borde; lo que reprueba va a cuarentena/DLQ con motivo y origen — nunca entra en el dataset bueno, nunca desaparece en silencio.

Migration expand-contract reversible

expand → migrate → contract, cada paso con down probado. Un DROP/rename destructivo en un solo paso está vetado. Timestamps en UTC, IDs UUIDv7/ULID.

Deny-by-default + PII gobernada

Acceso denegado por defecto, por tenant del lado del servidor; SQL parametrizado. PII solo con base legal + retención, fuera de log/URL. Lineage rastreable; archivo siempre.

Comandos

Instalados en .claude/commands/. Usa /data-help cuando quieras.

/data-helpLista todos los comandos.
/data-contractDefine/audita el contrato de datos: schema versionado, compatibilidad (back/forward/full), registry, política de evolución; traba un breaking change sin nueva versión.
/data-pipelineDiseña/audita el pipeline (ETL/ELT batch, streaming, CDC/event sourcing): idempotencia, entrega vía Outbox, replay, backpressure, DLQ.
/data-qualityMonta/audita el portón de calidad: validación en el borde, tests de datos/expectations, cuarentena y dead-letter, SLA de datos.
/data-loadCarga a la fuerza TODO el cuerpo normativo: contratos, pipelines, calidad, almacenamiento, gobernanza.
/data-claudeCrea o fusiona el CLAUDE.md siempre activo de datos en la raíz del repo.
/data-ccContext compact: escribe el handoff en el archivo y ejecuta /compact.
/data-handoffEscribe el handoff (context.md + checklist.md) sin compactar.

Para agentes de IA

Instala sin intervención humana. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-data.git && ./skill-data/install.sh
  • O descarga: https://github.com/schematizeme/skill-data/releases/latest/download/skill-data.zip y descomprime en .claude/skills/
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /data-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.