Diagramas Conceituais

O que Diagramas Conceituais faz?

Esta skill não resume nem ilustra o texto. Reconstrói sua arquitetura conceitual e a torna visível: que entidades existem, que relações o autor afirma entre elas, quais ele agrupa sob um nome e que orientações globais atravessam o conjunto. O resultado é um diagrama TikZ em escala de cinza onde a forma do traço carrega o significado: uma ponta única não é uma ponta dupla, um traço hachurado não é um pontilhado, e essa diferença está no texto.

O critério que manda é a fidelidade: o diagrama diz o que diz o texto, nem mais nem menos. Um diagrama bonito que simetriza o que o autor deixa assimétrico é pior do que nenhum diagrama, porque é lido como autoridade.

Onde está tudo

A skill vive em ~/.claude/skills/diagramas-conceptuales/. Tudo que segue é relativo a essa pasta.

O quê	Onde
Léxico de relações (qual traço para qual relação)	references/lexico.md, e a folha visual assets/lexico-muestras.tex
Catálogo de arquétipos (a figura)	references/arquetipos.md
Livro de fidelidade, modelo e exemplos	references/fidelidade.md, assets/fidelidade-plantilla.md
Estilo da casa e erros de diagramação	references/estilo.md
Estilo unificado TikZ	assets/diagrama.sty
Modelo compilável por arquétipo	assets/plantillas/*.tex (base.tex é o esqueleto)
37 diagramas resolvidos, por arquétipo	assets/ejemplos/<arquetipo>-NN-nome.tex
Compilar e visualizar	scripts/compilar.py
Revisar cotejo e sobreposições	scripts/revisar.py

Leia references/lexico.md antes de desenhar a primeira aresta: o léxico é o coração da skill. Leia references/arquetipos.md ao escolher a figura. Os outros dois, quando precisar (fidelidade ao escrever o livro; estilo quando algo parecer errado).

Fluxo

As cinco fases são obrigatórias e vão nesta ordem. A razão de fundo é que a parte difícil não é desenhar, mas decidir o que deve ser desenhado: se o livro de fidelidade estiver bom, o desenho é quase mecânico; se estiver ruim, nenhum polimento o conserta.

Fase A — Leitura estrutural

1. Leia o texto completo antes de desenhar nada. Se for longo, localize primeiro a tese ou as teses que o diagrama deve mostrar, e pergunte ao usuário se ele quer o diagrama de todo o texto ou de um trecho (um capítulo inteiro geralmente resulta em três ou quatro diagramas, não um).
2. Identifique os termos técnicos do autor em sua forma original: Habitus, Mnemosyne, spatium, sentiendum, Aion, dy/dx. No diagrama aparece o vocabulário do autor, nunca uma paráfrase. Se houver tradução, o termo original vai em itálico e entre parênteses: «Superego (Thanatos)».
3. Separe o texto em quatro camadas:
   • Entidades ou instâncias: conceitos, faculdades, níveis, momentos (ids n).
   • Relações que o texto afirma entre elas (ids e).
   • Agrupamentos ou totalidades: «as sínteses de reconhecimento», «a forma pura e vazia do tempo» (ids g).
   • Eixos ou orientações globais: contração/dilatação, vida→morte, monotonicidade (ids x).

Fase B — Livro de fidelidade (antes do desenho)

Escreva fidelidade.md com uma linha para cada nó e cada aresta. Use assets/fidelidade-plantilla.md; o formato e três exemplos resolvidos estão em references/fidelidade.md.

id	elemento	tipo de relação	direção	trecho que o apoia	status

• tipo de relação: uma entrada do léxico (references/lexico.md).
• trecho: citação breve e página ou seção.
• status: textual (o autor diz), inferido (decorre diretamente; explique como) ou interpretativo (leitura sua; será marcado no desenho).

Se não houver trecho que apoie uma aresta, essa aresta não é desenhada. Se o usuário não fornecer o texto, mas pedir «o diagrama de X em Y», trabalhe com os trechos que ele fornecer ou que você puder citar com segurança, e declare o status de todo o resto (quase tudo será interpretativo). Não complete com memória de «o que o autor costuma dizer»: é exatamente isso que o livro existe para evitar.

Fase C — Escolher o arquétipo

Escolha a figura (references/arquetipos.md) pela lógica do texto, não por costume: uma gênese pede cascata; uma divisão por gênero e espécie, árvore; uma correlação entre duas ordens, colunas paralelas; um passado que se contrai num presente, um cone; uma totalidade dividida por um corte, semidiscos com cesura. Justifique a escolha em uma linha e anote-a no livro. Podem-se combinar arquétipos (o 08 é cascata + colunas + loops), mas cada parte precisa ser legível por si só.

Fase D — Desenhar

1. Parta do modelo (assets/plantillas/<arquetipo>.tex) e de um exemplo parecido de assets/ejemplos/. Copie-os para a pasta de trabalho e renomeie-os como NN-nome.tex.
2. Escreva em TikZ com \usepackage{diagrama}. Estilos com nome semântico: cada aresta é desenhada com o estilo de sua relação (genesis, sucesion, unilateral, reciproca debil…), não com um aspecto genérico.
3. Nomeie os nós com seu id do livro (\node (n3) …) e marque cada aresta com seu id ao final da sentença (% e4), para que código e tabela possam ser cotejados.
4. Coordenadas na grade fixa (1 unidade = 1,6 cm), tamanhos com \px{n}.
5. O interpretativo vai em cinza claro (interp) com † e nota de rodapé (\nota); o inferido discutível leva * (\discutible).

Fase E — Verificar

Compile e olhe a imagem: um diagrama que compila pode ter etiquetas sobre as linhas.

python ~/.claude/skills/diagramas-conceptuales/scripts/compilar.py 38-nome.tex
python ~/.claude/skills/diagramas-conceptuales/scripts/revisar.py 38-nome.tex

compilar.py gera PDF + PNG junto ao .tex e, se falhar, mostra o primeiro erro com sua linha. revisar.py coteja o desenho com fidelidade.md (pontos 1 e 3 abaixo), detecta rótulos sobrepostos (ponto 2) e deixa <nome>-revision.png com o suspeito em vermelho. Depois leia o PNG você mesmo. Verifique estes cinco pontos:

1. Cada aresta do desenho está na tabela e vice-versa.
2. Nenhuma etiqueta tapa uma linha nem outra etiqueta.
3. As assimetrias do texto continuam sendo assimetrias (§ regras duras).
4. Os números do texto coincidem com os do desenho (três sínteses, quatro estratos, duas articulações): conte-os no PNG, não os suponha.
5. Lê-se de relance: há um caminho principal claro e as relações secundárias têm traço mais leve.

Corrija e repita até passar os cinco. Se após três voltas algo não encaixar, geralmente é um problema da Fase B ou C (a tabela ou o arquétipo), não de diagramação.

Léxico em uma tabela

O léxico completo, com corpus e fragmentos, está em references/lexico.md. Para orientação:

Relação	Estilo	Traço
Derivação, divisão gênero→espécie	derivacion	sólido, ponta cheia
Sucessão, transição	sucesion	sólido ou hachurado, ponta oca
Gênese, atualização, força	genesis	hachurado, ponta cheia
Virtual: repetição, disfarce, deslocamento	virtual	pontilhado fino, ponta oca
Operação singular do autor (clonagem, extração…)	operacion	traço-ponto + rótulo
Reciprocidade, correlação, paralelismo	reciproca / reciproca rayada / reciproca debil	ponta dupla; a força diminui com o traço
Unilateralidade: determina sem ser determinado	unilateral	uma única ponta, nunca dupla
Inclusão, subsunção	subsuncion + verbo	flecha com etiqueta verbal, ou encaixe
Autorreferência, paradoxo	paradoja	arco que salta de nível
Retroalimentação	retroalim	feixe de arcos pontilhados
Retorno, rejeição, metamorfose entre séries	retorno	arco pontilhado de ponta dupla
Anulação, exclusão	anulacion + «Cancelled»	pontilhada, ou \tachar
Totalização	totalidad / totalidad virtual / totalidad abierta	chave sólida / hachurada / pontilhada
Eixo ou orientação global	eje	flecha longa à margem, traço-ponto, rotulada
Série aberta	\dots	«…»

Regras complementares do corpus: o status ontológico é codificado no contorno (sólido = atual, hachurado = virtual, pontilhado = incognoscível: caja, caja virtual, caja abierta); a espessura hierarquiza (caminho principal grosso, secundário fino); se o texto nomeia a relação, a aresta leva seu nome em itálico pequeno sobre fundo branco (rotulo); um nó é «termo + (apelido ou função)»; os níveis são nomeados à margem (nivel).

O léxico pode ser ampliado se um texto o exigir, mas cada traço novo é definido com nome semântico no próprio .tex, é explicado na legenda do diagrama e é adicionado a references/lexico.md.

Quando não há texto diante

É o normal: o usuário nomeia uma obra e pede o diagrama. Os agentes que testaram esta skill tropeçaram aqui mais do que em qualquer outro lugar, portanto:

• Procure-o se puder (texto de domínio público, um PDF que o usuário tenha em alguma pasta); um trecho real vale mais do que qualquer memória.
• Os diagramas de assets/ejemplos/ não são o texto. São interpretações de um terceiro e às vezes discrepam entre si. Use-os para o vocabulário e o arquétipo, não como trecho citado.
• Tudo que você não puder citar baixa de status: termos inconfundíveis «de memória, sem cotejar»; o resto inferido ou interpretativo. Detalhes em references/fidelidade.md.
• Diga na entrega e ofereça-se para recompilar quando o usuário fornecer o trecho.

Regras duras de fidelidade

Há uma razão por trás de cada uma; se você a entender, saberá aplicá-las em casos que não estão aqui.

• Não simetrize. Se o texto diz que A determina B e não o contrário, a flecha vai num único sentido. Uma ponta dupla afirma dependência mútua; colocá-la «porque fica mais equilibrado» é inventar uma tese. As relações unilaterais de Laruelle e a determinação em última instância são os casos de teste.
• Não complete nem arredonde. Se o autor dá três sínteses, vão três; não se adiciona uma quarta por equilíbrio visual. Se ele deixa uma série aberta, vai «…».
• Não unifique vocabulários. Dois autores que usam a mesma palavra com sentidos diferentes levam nós diferentes, e uma nota os distingue.
• Um elemento sem contraparte fica sem aresta. Se um componente de uma teoria não tem equivalente na outra (as regras de correspondência de Carnap em Sneed), não se inventa uma flecha: fica solto, e se você desenhar uma por interpretação, vai cinza com †.
• A disposição não reordena uma tupla. Se a diagramação obrigar a reordenar os componentes de uma fórmula (⟨Mp, M, C, Mpp⟩), o cabeçalho conserva a ordem do autor e uma nota de rodapé declara o reordenamento.
• Uma dependência em um único sentido (o texto dá A→B e a inversa só está implícita) é desenhada com uma flecha de uma ponta marcada *, e o livro anota que a inversa não é desenhada.
• Mostre as tensões. Paradoxos, cancelamentos, rejeições, o que o texto exclui e o que aponta como incognoscível (o «?», a coisa em si) são desenhados; não são omitidos porque atrapalham.
• O interpretativo é visível. Cinza claro + † + nota de rodapé. O inferido discutível leva *.
• As etiquetas citam, não explicam. O rótulo é a palavra do autor; a explicação vai no parágrafo de entrega.
• Legenda se o diagrama usar mais de três tipos de traço (os do corpus quase nunca precisam, porque cada aresta leva seu nome).

Quando perguntar ao usuário

Pergunte, antes de desenhar, apenas o que muda o diagrama:

• Escopo: todo o texto ou um trecho? Um capítulo longo geralmente resulta em vários diagramas.
• O texto em si, se você não o deu: «Você pode fornecê-lo, ou trabalho com o que posso citar e marco o resto como interpretativo?».
• Qual tese mostrar, se o texto defende várias e cabe apenas uma na figura.
• Idioma das etiquetas. Regra padrão, para não perguntar: os termos técnicos vão no idioma do texto que o usuário nomeia (alemão para Kant, grego transliterado para Platão, francês para Deleuze ou Laruelle, ou o idioma da tradução se ele trabalha sobre uma), e o resto dos rótulos e notas no idioma em que o usuário escreve. Declare a escolha na entrega; se o diagrama for para uma publicação em outro idioma, pergunte.

Não pergunte sobre estilo, arquétipo ou traços: isso você decide com o léxico e justifica.

Entrega

Pasta de trabalho com NN-nome.tex + PDF + PNG + fidelidade.md, e um parágrafo que diga:

1. o que o diagrama mostra (a tese);
2. por que esse arquétipo (uma linha);
3. quais decisões interpretativas foram tomadas (as linhas †);
4. o que do texto ficou de fora e por quê.

Se o trabalho for dentro de ~/.claude/diagramas-tikz/, continue a numeração (o próximo número livre; o último é o 37) e adicione o novo diagrama a todos.tex apenas se o usuário o pedir.

Antipadrões

• Uma lista com flechas. Se todas as arestas são iguais, falta análise.
• Flechas genéricas «→» para relações de tipos diferentes.
• Caixas para tudo. A caixa só aparece quando a forma significa algo.
• Parafrasear termos técnicos («memória pura» em vez de Mnemosyne).
• Comentário do diagramador dentro do desenho. Vai no parágrafo de entrega ou, se for uma decisão interpretativa, em uma nota † de rodapé.
• Preencher o espaço com simetrias que o texto não tem. Um diagrama com lacunas é um diagrama honesto.
• Desenhar a partir da memória de «a doutrina» em vez do trecho: é a causa de quase todas as infidelidades.