En abril de 2024, Argumentum era un juego de cartas listo para imprimir. Hoy es también un repositorio público en el que cada carta se reconstruye a partir de archivos de texto, en ocho idiomas, con sus mapas mentales y su ontología.
Ilustración: docs/publication/articles/illustrations/1a-du-texte-a-la-carte.png, repositorio Argumentum, commit 981e5233 — montaje de un extracto real de la taxonomía (diecinueve líneas, incluida la cabecera) y del renderizado real de la carta «Argumento chapucero», con la fila 2,1.1 visible en el extracto — el recorrido que cuenta la sección «Cómo nace una carta».
El juego
Argumentum es un juego de cartas sobre las falacias, esos razonamientos que parecen válidos sin serlo. Una carta describe una falacia, da su definición y un ejemplo. Se aprende a reconocerla y luego a oponerle el argumento que se sostiene.
El juego se juega con tres mazos. El primero reúne las cartas grandes: las falacias, las reglas y una carta de recordatorio. El segundo reúne las cartas pequeñas: los escenarios, en los que hay que reconocer qué falacia se esconde en una situación dada. El tercero, aparte, describe las virtudes de la argumentación: los argumentos que se sostienen.
Un punto de referencia y después una reconstrucción
El repositorio existe desde el 20 de marzo de 2020.
Una versión se mantuvo durante mucho tiempo como la referencia: el commit 0087f0ec, del 25 de abril de 2024. Era la que producía el juego completo. Entre 2025 y 2026, la cadena de fabricación se ha puesto a punto pieza por pieza y, sobre todo, se ha dotado de herramientas: cada etapa tiene ahora su control, y una modificación que rompiera una carta ya no pasa inadvertida.
Cómo nace una carta
Cuatro etapas, todas a partir de archivos de texto.
Los datos. Un archivo CSV por familia: la taxonomía de las falacias, la de las virtudes, los escenarios, las reglas. Una fila por elemento y una columna por idioma. Es el único lugar donde existe el texto de una carta.
La plantilla. Un archivo JSON que contiene el HTML y el CSS de una carta, con huecos que rellenar. El motor de renderizado, CardPen, rellena esos huecos con los datos del CSV. Los huecos se escriben entre llaves dobles: es la sintaxis de las plantillas Handlebars, un sistema que sustituye etiquetas por valores.
La imagen. Un navegador controlado por programa abre la plantilla rellena y captura la carta como imagen PNG, a la resolución de impresión.
El documento. Una biblioteca, QuestPDF, ensambla las páginas: anverso y reverso, marcas de corte y, para la versión que se imprime en casa, varias cartas por hoja A4.
Lo que se ha añadido
Ocho idiomas. Francés, inglés, ruso, portugués, español, árabe, persa y chino. Dos de ellos, el árabe y el persa, se escriben de derecha a izquierda, con una fuente dedicada a su alfabeto.
Los mapas mentales. La taxonomía entera dibujada en árbol, uno por idioma, exportado en SVG — un formato de imagen vectorial que se mantiene nítido a cualquier tamaño. Páginas HTML del repositorio los muestran.
La ontología. Dos archivos OWL, uno para las falacias y otro para las virtudes. Una ontología es una descripción formal de los conceptos y de sus relaciones, escrita para que la lea una máquina: permite a un programa saber que una falacia pertenece a una familia, que tiene variantes y cómo se relaciona con las demás. La taxonomía también se encuentra allí descrita en SKOS, un vocabulario estándar para publicar un tesauro.
El Print & Play. Además de los archivos destinados a una imprenta, el repositorio produce páginas A4 para imprimir en casa, recortar y jugar.
Lo que contiene la caja
| Elemento |
Cartas |
| Falacias |
175 |
| Reglas |
15 |
| Recordatorio |
1, impresa en 7 ejemplares |
| Escenarios |
167 |
| Virtudes argumentativas (mazo aparte) |
131 |
Dos observaciones para leer esta tabla. Son 175 las falacias que tienen carta, pero la taxonomía describe 1408 nodos: desciende de las grandes familias hasta los casos particulares, y no todos merecen una carta. Las virtudes siguen la misma regla.
El mazo de tarot reúne, por tanto, 197 cartas por fabricar. Con los 167 escenarios, la caja cuenta con 364. Cuenta con 495 si se añaden las virtudes.
Estas cifras se cuentan sobre los archivos CSV del repositorio, con la misma regla que el control automático que vuelve a comprobar ese recuento en cada modificación.
Cómo nos aseguramos de que nada se rompa
Los controles no copian las cifras: las recalculan y luego las confrontan con lo que se ha producido.
El número de cartas de un mazo se deduce de la configuración y de los CSV. Una fila perdida en un archivo de datos hace, por tanto, que la verificación falle, en lugar de producir silenciosamente un juego incompleto.
El tamaño de las páginas se mide sobre los propios PDF, con una tolerancia de un milímetro: un documento compuesto en un formato equivocado se señala incluso cuando su número de páginas es correcto.
Los mapas mentales tienen sus enlaces verificados uno por uno, y sus páginas de visualización no deben ser más antiguas que el dibujo que contienen; de lo contrario, la página muestra una versión obsoleta del árbol.
Un último control abre el mazo y lee sus primeras páginas para comprobar que las reglas figuran en ellas, por orden. No puede leer texto: esas páginas son imágenes. Por eso compara los píxeles de las primeras páginas con los de las cartas de reglas.
Los de estos controles que solo leen el repositorio se ejecutan en cada modificación propuesta: el recuento de las cartas, los enlaces de los mapas mentales y los testigos de los controles sobre PDF, que ponen a prueba su lógica con casos construidos para ello. Los controles que abren los PDF producidos, en cambio, se ejecutan en una máquina que acaba de regenerar el juego: una fabricación completa requiere horas y no se repite en cada modificación.
Todo es abierto
El código se publica bajo licencia LGPL-3.0: se puede leer, modificar y reutilizar, siempre que las modificaciones del propio código permanezcan bajo la misma licencia.
El corpus editorial —los textos de las cartas— está bajo licencia Creative Commons BY-SA 4.0, que autoriza la reutilización y la adaptación siempre que se reconozca la autoría y se comparta bajo la misma licencia. Esta licencia no cubre todo el repositorio: se aplica a los siete archivos enumerados en el archivo LICENSE-CONTENT.md, y solo a ellos —los cinco archivos de texto de las cartas y las dos ontologías que derivan de ellos—. Para cualquier otro archivo, se aplica la licencia del código.
Reconstruir el juego se hace con un solo comando, desde la raíz del repositorio:
dotnet run --project Generation/Converters/Argumentum.AssetConverter/Argumentum.AssetConverter.csproj
Los PDF se escriben en la carpeta de salida del proyecto, una subcarpeta por idioma. Para ello hace falta un entorno .NET y el motor de renderizado de las cartas servido por un sitio web local; los mapas mentales requieren además FreeMind, el programa que los dibuja.
Y ahora
El repositorio sigue avanzando: la taxonomía se completa, las traducciones se revisan y los controles se amplían a medida que se encuentran nuevos defectos. Así, cada carta del juego sigue siendo reproducible a partir de su texto y verificable.
Fuentes: repositorio Argumentum, commit 33f25e82 (6 de noviembre de 2026). Recuentos establecidos sobre Cards/Fallacies/Argumentum Fallacies - Taxonomy.csv, la taxonomía de las virtudes, Cards/Scenarii/Argumentum Scenarii - Cards.csv y Cards/Rules/Argumentum Rules - Cards.csv. Licencias: LICENSE y LICENSE-CONTENT.md. Mapas mentales: carpeta Cards/Fallacies/Mindmaps. Ontología: docs/ontology/argumentum.owl.