Em abril de 2024, Argumentum era um jogo de cartas pronto para imprimir. Hoje é também um repositório público em que cada carta se reconstrói a partir de arquivos de texto, em oito idiomas, com os seus mapas mentais e a sua ontologia.
Ilustração: docs/publication/articles/illustrations/1a-du-texte-a-la-carte.png, repositório Argumentum, commit 981e5233 — montagem de um trecho real da taxonomia (dezenove linhas, incluindo o cabeçalho) e da renderização real da carta «Argumento malfeito», com a linha 2,1.1 visível no trecho — o percurso que a seção «Como nasce uma carta» conta.
O jogo
Argumentum é um jogo de cartas sobre falácias, esses raciocínios que parecem válidos sem o ser. Uma carta descreve uma falácia, traz sua definição e um exemplo. Aprende-se a reconhecê-la e, depois, a opor a ela o argumento que se sustenta.
O jogo é jogado com três baralhos. O primeiro reúne as cartas grandes: as falácias, as regras e uma carta de lembrete. O segundo reúne as cartas pequenas: os cenários, nos quais é preciso reconhecer qual falácia se esconde em uma determinada situação. O terceiro, à parte, descreve as virtudes da argumentação: os argumentos que se sustentam.
Um ponto de referência e, depois, uma reconstrução
O repositório existe desde 20 de março de 2020.
Uma versão permaneceu por muito tempo como a referência: o commit 0087f0ec, de 25 de abril de 2024. Era ela que produzia o jogo completo. Entre 2025 e 2026, a cadeia de produção foi recolocada em ordem peça por peça e, sobretudo, equipada com ferramentas: cada etapa agora tem sua verificação, e uma modificação que quebrasse uma carta já não passa despercebida.
Como nasce uma carta
Quatro etapas, todas a partir de arquivos de texto.
Os dados. Um arquivo CSV por família: a taxonomia das falácias, a das virtudes, os cenários, as regras. Uma linha por elemento e uma coluna por idioma. É o único lugar onde o texto de uma carta existe.
O modelo. Um arquivo JSON que contém o HTML e o CSS de uma carta, com lacunas a preencher. O mecanismo de renderização, CardPen, preenche essas lacunas com os dados do CSV. As lacunas são escritas entre chaves duplas: é a sintaxe dos modelos Handlebars, um sistema que substitui rótulos por valores.
A imagem. Um navegador controlado por programa abre o modelo preenchido e captura a carta como imagem PNG, na resolução de impressão.
O documento. Uma biblioteca, QuestPDF, monta as páginas: frente e verso, marcas de corte e, para a versão a ser impressa em casa, várias cartas por folha A4.
O que foi acrescentado
Oito idiomas. Francês, inglês, russo, português, espanhol, árabe, persa e chinês. Dois deles, o árabe e o persa, são escritos da direita para a esquerda, com uma fonte dedicada ao seu alfabeto.
Os mapas mentais. A taxonomia inteira desenhada em árvore, um por idioma, exportado em SVG — um formato de imagem vetorial, que permanece nítido em qualquer tamanho. Páginas HTML do repositório os exibem.
A ontologia. Dois arquivos OWL, um para as falácias, outro para as virtudes. Uma ontologia é uma descrição formal dos conceitos e de suas relações, escrita para ser lida por uma máquina: ela permite que um software saiba que uma falácia pertence a uma família, que tem variantes e como se relaciona com as outras. A taxonomia também está descrita ali em SKOS, um vocabulário padrão para publicar um tesauro.
O Print & Play. Além dos arquivos destinados a uma gráfica, o repositório produz páginas A4 para imprimir em casa, recortar e jogar.
O que a caixa contém
| Item |
Cartas |
| Falácias |
175 |
| Regras |
15 |
| Lembrete |
1, impressa em 7 exemplares |
| Cenários |
167 |
| Virtudes argumentativas (baralho à parte) |
131 |
Duas observações para ler esta tabela. São 175 falácias a ter uma carta, mas a taxonomia descreve 1.408 nós: ela desce das grandes famílias até os casos particulares, e nem todos merecem uma carta. As virtudes seguem a mesma regra.
O baralho de tarô reúne, portanto, 197 cartas a fabricar. Com os 167 cenários, a caixa tem 364. Tem 495 se somarmos as virtudes.
Esses números são contados nos arquivos CSV do repositório, pela mesma regra da verificação automática que reconfere essa contagem a cada modificação.
Como garantimos que nada quebre
As verificações não copiam os números: elas os recalculam e depois os confrontam com o que foi produzido.
O número de cartas de um baralho é deduzido da configuração e dos CSV. Uma linha perdida em um arquivo de dados faz, portanto, a verificação falhar, em vez de produzir silenciosamente um jogo incompleto.
O tamanho das páginas é medido nos próprios PDF, com tolerância de um milímetro: um documento composto no formato errado é sinalizado mesmo quando o número de páginas está certo.
Os mapas mentais têm seus links verificados um a um, e suas páginas de exibição não devem ser mais antigas que o desenho que contêm — senão a página mostra uma versão desatualizada da árvore.
Uma última verificação abre o baralho e lê suas primeiras páginas para conferir se as regras estão ali, na ordem. Ela não consegue ler texto: essas páginas são imagens. Por isso compara os pixels das primeiras páginas com os das cartas de regras.
As dessas verificações que só leem o repositório são executadas a cada modificação proposta: a contagem das cartas, os links dos mapas mentais e as amostras de teste das verificações de PDF, que põem sua lógica à prova em casos construídos para o teste. As verificações que abrem os PDF produzidos, por sua vez, rodam em uma máquina que acabou de regenerar o jogo: uma fabricação completa leva horas, e não se repete a cada modificação.
Tudo é aberto
O código é publicado sob a licença LGPL-3.0: pode-se lê-lo, modificá-lo e reutilizá-lo, desde que as modificações do próprio código permaneçam sob a mesma licença.
O corpus editorial — os textos das cartas — está sob a licença Creative Commons BY-SA 4.0, que autoriza a reutilização e a adaptação, desde que se atribua o crédito e se compartilhe pela mesma licença. Essa licença não cobre todo o repositório: ela se aplica aos sete arquivos listados no arquivo LICENSE-CONTENT.md, e somente a eles — os cinco arquivos de texto das cartas e as duas ontologias derivadas deles. Para qualquer outro arquivo, aplica-se a licença do código.
Reconstruir o jogo se faz com um único comando, a partir da raiz do repositório:
dotnet run --project Generation/Converters/Argumentum.AssetConverter/Argumentum.AssetConverter.csproj
Os PDF são gravados na pasta de saída do projeto, uma subpasta por idioma. Para isso é preciso um ambiente .NET e o mecanismo de renderização das cartas servido por um site local; os mapas mentais exigem, além disso, o FreeMind, o software que os desenha.
E agora
O repositório continua avançando: a taxonomia se completa, as traduções são revisadas e as verificações se ampliam à medida que novos defeitos são encontrados. Cada carta do jogo permanece assim reproduzível a partir de seu texto e verificável.
Fontes: repositório Argumentum, commit 33f25e82 (6 de novembro de 2026). Contagens estabelecidas em Cards/Fallacies/Argumentum Fallacies - Taxonomy.csv, na taxonomia das virtudes, em Cards/Scenarii/Argumentum Scenarii - Cards.csv e em Cards/Rules/Argumentum Rules - Cards.csv. Licenças: LICENSE e LICENSE-CONTENT.md. Mapas mentais: pasta Cards/Fallacies/Mindmaps. Ontologia: docs/ontology/argumentum.owl.