APFerrer
Back to work
GitHub repositoryRecursos 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
Context and why it exists

What is 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).

Sector data

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

Problem and solution

The real problem CTS solves.

Before and after the product: how the operation worked before and what changes when this system is in place.

Before · Without this system

The problem

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.

After · With this system

How it solves it

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.

Main features

Four key pieces of CTS.

Modules that define the product and explain why it fits its concrete sector.

  1. 01
    Module 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
    Module 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
    Module 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
    Module 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 and architecture

Tools, architecture and applied patterns.

The stack is picked before the first line of code. These are the criteria.

  • Maintainability

    Chosen so another team can take over without rewriting the whole system.

  • Low operating cost

    Stack designed to scale without the monthly bill growing at the same rate.

  • Code and data control

    Repository and databases in client accounts, with the ability to export any time.

Tech stack

  • Markdown
  • JSON
  • HTML
  • GitHub Pages

Applied patterns

  • Recurso abierto
  • Doble formato (humano + máquina)
  • Regla transversal
Frequently asked questions

What people ask before hiring 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.

Interested in a similar case

Does your company face a problem similar to CTS?

Book 30 minutes and we can go over sector, architecture, ballpark budget and next steps. No cost, no pressure.

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