APFerrer
Volver a trabajos
Repositorio GitHubRecursos abiertos · Ingeniería de promptsPublicado

CTS

Biblioteca de contratos semánticos: lo que se suele decir a la IA frente a lo que se debería decir

Repositorio abierto que documenta cómo formular instrucciones a un LLM para que el encargo sea verificable, organizado por dominio con buscador integrado.

  • Recurso abierto
  • Doble formato (humano + máquina)
  • Regla transversal
Contexto y por qué existe

¿Qué es CTS?

Biblioteca de contratos semánticos para IA

CTS (Contratos Semánticos) es un recurso educativo que contrasta la instrucción típica que se le da a un modelo de IA frente a la instrucción reformulada para que el encargo sea verificable y auditable. Cada entrada de la biblioteca cubre un patrón concreto: qué se pide habitualmente, qué falla, cómo reformularlo para que el resultado sea contrastable. La colección se distribuye como Markdown legible (biblioteca/biblioteca.md) y como JSON estructurado (biblioteca/biblioteca.json). Buscador interactivo con atajos de teclado (/ para enfocar, Esc para limpiar).

Dato de sector

CTS distribuye la biblioteca en dos formatos: Markdown para lectura humana y JSON estructurado para consumo programático desde herramientas propias.

Problema y solución

El problema real que resuelve CTS.

Antes y después del producto: cómo se hacía la operativa hasta ahora y qué cambia cuando entra este sistema.

Antes · Sin este sistema

El problema

La calidad de la respuesta de un LLM depende de cómo se formule el encargo. La mayoría de equipos aprenden esto por prueba y error, sin marco común, y el resultado es inconsistencia entre miembros del equipo y entre ejecuciones.

Después · Con este sistema

Cómo lo resuelve

Un catálogo organizado por dominio con el mismo patrón en cada entrada: lo que se suele decir (débil) frente a lo que se debería decir (verificable). Se puede consultar con el navegador y se puede consumir desde código.

Características principales

Cuatro piezas clave de CTS.

Módulos que definen el producto y explican por qué encaja en su sector concreto.

  1. 01
    Módulo 01

    Organizado por dominio

    Cada entrada está clasificada por dominio (análisis, redacción, código, decisiones, resumen) para localizar rápido el patrón relevante para el encargo actual.

  2. 02
    Módulo 02

    Markdown + JSON

    Doble distribución: Markdown legible para consulta humana en el repositorio y JSON estructurado para consumo programático desde tooling interno.

  3. 03
    Módulo 03

    Buscador interactivo

    Buscador en la web pública con atajos de teclado (/ para enfocar el input, Esc para limpiar) para acceder al patrón adecuado sin salir del flujo.

  4. 04
    Módulo 04

    Regla transversal

    Cada patrón sigue una regla transversal común que impone la reformulación verificable, aplicable independientemente del dominio concreto de la tarea.

Stack y arquitectura

Herramientas, arquitectura y patrones aplicados.

El stack se elige antes de escribir la primera línea de código. Estos son los criterios.

  • Mantenibilidad

    Elegido para que otro equipo pueda tomar el testigo sin reescribir el sistema entero.

  • Coste operativo bajo

    Stack diseñado para escalar sin que la factura mensual crezca en la misma proporción.

  • Control del código y los datos

    Repositorio y bases de datos en cuentas del cliente, con capacidad de exportar cuando se quiera.

Stack técnico

  • Markdown
  • JSON
  • HTML
  • GitHub Pages

Patrones aplicados

  • Recurso abierto
  • Doble formato (humano + máquina)
  • Regla transversal
Preguntas frecuentes

Lo que se pregunta antes de contratar CTS.

¿Se puede consumir CTS desde código propio?

Sí, la biblioteca se distribuye también como JSON estructurado en biblioteca/biblioteca.json, listo para consumirse desde tooling interno o para integrarse en flujos de CI/CD.

¿Cubre todos los casos posibles?

No pretende ser exhaustiva. Es una colección viva que cubre los patrones más habituales y contra-ejemplos más significativos. El repositorio acepta contribuciones.

¿Puedo replicar este SaaS para mi empresa?

Sí. Cada uno de estos productos empezó como una consultoría a medida y evolucionó a SaaS. Si tu empresa tiene un problema parecido en tu sector, se puede diseñar una solución específica reutilizando arquitectura y patrones. Reserva 30 minutos para hablarlo.

¿El código y los datos quedan en propiedad del cliente?

En proyectos a medida, sí: el repositorio, la base de datos y las cuentas quedan siempre a nombre del cliente. En las versiones SaaS multitenant se firma DPA conforme al RGPD, cada tenant tiene sus datos aislados y se puede exportar en cualquier momento.

Interesado en un caso similar

¿Tu empresa tiene un problema parecido al de CTS?

Reserva 30 minutos y hablamos del sector, arquitectura, presupuesto orientativo y siguientes pasos. Sin coste, sin presión.

CTS · Recursos abiertos · Ingeniería de prompts · Publicado.