개념적 다이어그램 (Diagramas conceptuales)
이 스킬은 텍스트를 요약하거나 설명하지 않습니다. 텍스트의 개념적 건축학을 재구성하여 가시화합니다: 어떤 개체들이 있고, 저자가 그들 사이에 어떤 관계를 주장하며, 어떤 것을 하나의 이름으로 묶고, 어떤 전역적 방향성이 전체를 관통하는지. 결과물은 회색조 TikZ 다이어그램으로, 선의 형태가 의미를 전달합니다: 한쪽 끝 화살표는 양쪽 끝 화살표와 다르며, 점선은 실선과 다릅니다. 그리고 그 차이는 텍스트에 있습니다.
가장 중요한 기준은 충실성입니다: 다이어그램은 텍스트가 말하는 것을 말하며, 그 이상도 이하도 아닙니다. 저자가 비대칭으로 남겨둔 것을 대칭화하는 예쁜 다이어그램은 다이어그램이 없는 것보다 나쁩니다. 왜냐하면 그것이 권위로 읽히기 때문입니다.
모든 것의 위치
스킬은 ~/.claude/skills/diagramas-conceptuales/에 있습니다. 아래 모든 경로는 해당 폴더를 기준으로 합니다.
| 항목 | 위치 |
|---|---|
| 관계 어휘 (어떤 선이 어떤 관계인지) | references/lexico.md, 시각적 샘플 assets/lexico-muestras.tex |
| 도형 (아키타입) 카탈로그 | references/arquetipos.md |
| 충실성 노트, 템플릿 및 예제 | references/fidelidad.md, assets/fidelidad-plantilla.md |
| 하우스 스타일 및 조판 오류 | references/estilo.md |
| 통합 TikZ 스타일 | assets/diagrama.sty |
| 아키타입별 컴파일 가능 템플릿 | assets/plantillas/*.tex (base.tex는 기본 골격) |
| 아키타입별 해결된 37개 다이어그램 | assets/ejemplos/<arquetipo>-NN-nombre.tex |
| 컴파일 및 확인 | scripts/compilar.py |
| 교차 검증 및 겹침 검사 | scripts/revisar.py |
첫 번째 간선을 그리기 전에 references/lexico.md를 읽으세요: 어휘는 이 스킬의 핵심입니다. 도형을 선택할 때 references/arquetipos.md를 읽으세요. 다른 두 파일은 필요할 때 읽으세요(충실성 노트 작성 시 참조, 뭔가 이상해 보일 때 스타일 참조).
흐름
다섯 단계는 필수이며 이 순서대로 진행됩니다. 근본적인 이유는 어려운 부분이 그리는 것이 아니라 무엇을 그릴지 결정하는 것이기 때문입니다: 충실성 노트가 잘 작성되면 그림은 거의 기계적이지만; 잘못되면 어떤 다듬기도 고칠 수 없습니다.
단계 A — 구조적 읽기
- 그리기 전에 전체 텍스트를 읽으세요. 텍스트가 길면 먼저 다이어그램이 보여줘야 할 테제(들)을 찾고, 사용자에게 전체 텍스트의 다이어그램을 원하는지, 특정 구절의 다이어그램을 원하는지 물어보세요 (보통 한 장 전체는 세 네 개의 다이어그램이지 하나가 아닙니다).
- 저자의 기술 용어를 원래 형태로 식별하세요: Habitus, Mnemosyne, spatium, sentiendum, Aion, dy/dx. 다이어그램에는 저자의 어휘가 나타나며, 결코 의역이 아닙니다. 번역이 있는 경우 원래 용어는 이탤릭체와 괄호 안에 씁니다: "Superego (Thanatos)".
- 텍스트를 네 개의 층위로 분리하세요:
- 개체 또는 실례: 개념, 능력, 수준, 순간들 (id
n). - 텍스트가 그들 사이에 주장하는 관계들 (id
e). - 그룹화 또는 전체성: "인식의 종합", "시간의 순수하고 빈 형식" (id
g). - 축 또는 전역적 방향성: 수축/팽창, 생명→죽음, 단조성 (id
x).
- 개체 또는 실례: 개념, 능력, 수준, 순간들 (id
단계 B — 충실성 노트 (그리기 전)
fidelidad.md를 작성하며 각 노드와 각 간선에 대해 한 행씩 씁니다. assets/fidelidad-plantilla.md를 사용하세요; 형식과 세 개의 해결된 예제는 references/fidelidad.md에 있습니다.
| id | 요소 | 관계 유형 | 방향 | 뒷받침하는 구절 | 상태 |
|---|
- 관계 유형: 어휘(
references/lexico.md)의 한 항목. - 구절: 짧은 인용문과 페이지 또는 섹션.
- 상태:
textual(저자가 직접 말함),inferido(직접적으로 따라나옴; 방법 설명) 또는interpretativo(당신의 해석; 그림에 표시됨).
간선을 뒷받침하는 구절이 없으면 그 간선은 그리지 않습니다. 사용자가 텍스트를 제공하지 않고 "Y에 있는 X의 다이어그램"을 요청하면, 사용자가 제공하거나 안전하게 인용할 수 있는 구절로 작업하고 나머지(거의 모두 interpretativo가 됨)의 상태를 선언합니다. "저자가 보통 말하는 것"에 대한 기억으로 채우지 마십시오: 그것이 바로 이 책이 방지하기 위해 존재하는 것입니다.
단계 C — 아키타입 선택
습관이 아니라 텍스트의 논리에 따라 도형(references/arquetipos.md)을 선택하세요: 발생은 폭포를 요구하고; 장르와 종에 의한 구분은 나무를; 두 질서 간의 상관관계는 평행 열을; 현재 속으로 수축하는 과거는 원뿔을; 절단으로 나뉜 전체성은 절단이 있는 반원판을 요구합니다. 선택을 한 줄로 정당화하고 그것을 노트에 기록하세요. 아키타입은 결합될 수 있지만(08번은 폭포 + 열 + 루프), 각 부분은 그 자체로 읽을 수 있어야 합니다.
단계 D — 그리기
- 템플릿(
assets/plantillas/<arquetipo>.tex)과 비슷한 예제(assets/ejemplos/)에서 시작하세요. 작업 폴더에 복사하고 이름을NN-nombre.tex로 바꾸세요. \usepackage{diagrama}와 함께 TikZ로 작성하세요. 의미론적 이름의 스타일: 각 간선은 해당 관계의 스타일(genesis,sucesion,unilateral,reciproca debil…)로 그려지며, 일반적인 모양이 아닙니다.- 노드 이름을 노트의 id로 지정하세요 (
\node (n3) …) 그리고 각 간선의 id를 문장 끝에 표시하세요(% e4). 이렇게 하면 코드와 테이블을 교차 검증할 수 있습니다. - 고정 그리드(1 단위 = 1,6 cm)의 좌표,
\px{n}으로 크기 조정. interpretativo는 밝은 회색(interp)으로 †와 각주(\nota)를 붙이고; 논쟁의 여지가 있는inferido는 * (\discutible)를 붙입니다.
단계 E — 검증
컴파일하고 이미지를 확인하세요: 컴파일된 다이어그램에도 선 위에 레이블이 있을 수 있습니다.
python ~/.claude/skills/diagramas-conceptuales/scripts/compilar.py 38-nombre.tex
python ~/.claude/skills/diagramas-conceptuales/scripts/revisar.py 38-nombre.tex
compilar.py는 .tex 옆에 PDF + PNG를 생성하고, 실패하면 첫 번째 오류와 해당 줄을 보여줍니다. revisar.py는 그림을 fidelidad.md와 교차 검증하고(아래 1, 3번), 겹치는 레이블을 감지하고(2번), 의심스러운 부분을 빨간색으로 표시한 <nombre>-revision.png를 생성합니다. 그런 다음 직접 PNG를 읽으세요. 다음 다섯 가지를 확인하세요:
- 그림의 모든 간선이 표에 있고 그 반대도 성립합니다.
- 어떤 레이블도 선이나 다른 레이블을 가리지 않습니다.
- 텍스트의 비대칭은 여전히 비대칭입니다 (§ 엄격한 규칙).
- 텍스트의 숫자와 그림의 숫자가 일치합니다 (세 개의 종합, 네 개의 층위, 두 개의 연결): PNG에서 세어보고 추측하지 마세요.
- 한눈에 읽힙니다: 명확한 주요 경로가 있고 보조 관계는 더 가벼운 선을 가집니다.
수정하고 다섯 가지를 모두 통과할 때까지 반복하세요. 세 번의 시도 후에도 맞지 않는 것이 있으면 보통 단계 B 또는 C(표 또는 아키타입)의 문제이지 조판의 문제가 아닙니다.
한 표로 보는 어휘
전체 어휘, 코퍼스 및 발췌문은 references/lexico.md에 있습니다. 참고용:
| 관계 | 스타일 | 선 |
|---|---|---|
| 파생, 장르→종 분할 | derivacion | 실선, 채워진 화살촉 |
| 계승, 전이 | sucesion | 실선 또는 점선, 빈 화살촉 |
| 발생, 현행화, 힘 | genesis | 점선, 채워진 화살촉 |
| 가상: 반복, 위장, 전위 | virtual | 가는 점선, 빈 화살촉 |
| 저자의 독특한 작용 (복제, 추출…) | operacion | 점-선 + 레이블 |
| 상호성, 상관관계, 평행성 | reciproca / reciproca rayada / reciproca debil | 양쪽 화살촉; 선이 갈수록 힘 약해짐 |
| 일방향성: 결정하지만 결정되지 않음 | unilateral | 한쪽 화살촉, 절대 양쪽 아님 |
| 포함, 하위 개념화 | subsuncion + 동사 | 동사 레이블이 있는 화살표 또는 끼워넣기 |
| 자기 참조, 역설 | paradoja | 수준을 뛰어넘는 호 |
| 피드백 | retroalim | 점선 호 다발 |
| 회귀, 거부, 계열 간 변형 | retorno | 양쪽 화살촉이 있는 점선 호 |
| 무효화, 배제 | anulacion + "Cancelled" | 점선, 또는 \tachar |
| 전체화 | totalidad / totalidad virtual / totalidad abierta | 실선 / 점선 / 점선 중괄호 |
| 축 또는 전역적 방향성 | eje | 여백의 긴 화살표, 점-선, 레이블 있음 |
| 열린 계열 | \dots | "…" |
코퍼스의 보충 규칙: 존재론적 상태는 윤곽선으로 코딩됩니다 (실선 = 현행, 점선 = 가상, 점선 = 인식 불가: caja, caja virtual, caja abierta); 두께가 계층을 나타냅니다 (주 경로는 굵게, 보조 경로는 가늘게); 텍스트가 관계를 명명하면 간선은 그 이름을 흰색 배경에 작은 이탤릭체로 표시합니다 (rotulo); 노드는 "용어 + (별칭 또는 기능)"입니다; 수준은 여백에 명명됩니다 (nivel).
어휘는 텍스트가 요구하면 확장될 수 있지만, 각 새로운 선은 해당 .tex 파일에서 의미론적 이름으로 정의되고 다이어그램 범례에서 설명되며 references/lexico.md에 추가됩니다.
텍스트가 없을 때
이것이 일반적입니다: 사용자가 저작을 언급하며 다이어그램을 요청합니다. 이 스킬을 시험한 에이전트들은 다른 어느 곳보다 여기서 어려움을 겪었습니다. 따라서:
- 가능하면 텍스트를 찾으세요 (공개 도메인 텍스트, 사용자가 어떤 폴더에 가지고 있는 PDF); 실제 구절은 어떤 기억보다 가치 있습니다.
assets/ejemplos/의 다이어그램은 텍스트가 아닙니다. 그것들은 제삼자의 해석이며 때로는 서로 일치하지 않습니다. 어휘와 아키타입을 위해 사용하되 인용된 구절로 사용하지 마세요.- 인용할 수 없는 모든 것은 상태가 낮아집니다: "비교하지 않고 기억으로" 인용된 명백한 용어; 나머지는
inferido또는interpretativo. 세부 사항은references/fidelidad.md에 있습니다. - 전달 시 이를 말하고 사용자가 구절을 제공할 때 다시 컴파일하겠다고 제안하세요.
충실성의 엄격한 규칙
각각에는 이유가 있습니다; 그것을 이해하면 여기에 없는 경우에도 적용할 수 있습니다.
- 대칭화하지 마세요. 텍스트가 A가 B를 결정하고 그 반대는 아니라고 말하면, 화살표는 한 방향으로만 갑니다. 양쪽 화살표는 상호 의존성을 주장합니다; "더 균형 잡혀 보이기 때문에" 넣는 것은 테제를 발명하는 것입니다. 라루엘의 일방적 관계와 최종 심급의 결정이 시험 사례입니다.
- 채우거나 반올림하지 마세요. 저자가 세 개의 종합을 주면 세 개가 갑니다; 시각적 균형을 위해 네 번째를 추가하지 마세요. 열린 계열을 남기면 "…"이 갑니다.
- 어휘를 통일하지 마세요. 같은 단어를 다른 의미로 사용하는 두 저자는 별도의 노드를 가지며, 각주가 구분합니다.
- 대응물이 없는 요소는 간선 없이 남깁니다. 한 이론의 구성 요소가 다른 이론에 대응물이 없으면(Carnap의 대응 규칙이 Sneed에는 없음), 화살표를 발명하지 마세요: 그냥 떠 있는 상태로 두고 해석으로 그리면 회색에 †를 붙입니다.
- 배치는 튜플을 재정렬하지 않습니다. 조판이 공식의 구성 요소(⟨Mp, M, C, Mpp⟩)를 재정렬하도록 강제하면, 헤더는 저자의 순서를 유지하고 각주가 재정렬을 선언합니다.
- 한 방향의 의존성 (텍스트가 A→B를 주고 역방향이 암시만 됨)은 * 표시가 있는 한쪽 화살표로 그려지며, 노트는 역방향이 그려지지 않음을 기록합니다.
- 긴장을 보여주세요. 역설, 취소, 거부, 텍스트가 배제하는 것과 인식 불가능으로 지시하는 것("?", 물자체)은 그려집니다; 방해가 된다고 생략하지 마세요.
- 해석적인 것은 보입니다. 밝은 회색 + † + 각주. 논쟁의 여지가 있는 추론은 *를 붙입니다.
- 레이블은 인용하고 설명하지 않습니다. 레이블은 저자의 말입니다; 설명은 전달 단락에 들어갑니다.
- 범례 다이어그램이 세 가지 이상의 선 유형을 사용하는 경우 (코퍼스의 것들은 각 간선이 그 이름을 가지고 있기 때문에 거의 필요하지 않습니다).
사용자에게 물어볼 때
그리기 전에, 다이어그램을 변경하는 것만 물어보세요:
- 범위: 전체 텍스트인가요, 특정 구절인가요? 긴 장은 보통 여러 다이어그램입니다.
- 텍스트 자체를 제공하지 않았다면: "제게 주시겠습니까, 아니면 제가 인용할 수 있는 것으로 작업하고 나머지는 해석적이라고 표시할까요?"
- 텍스트가 여러 테제를 주장하고 그림에 하나만 들어갈 경우 어떤 테제를 보여줄지.
- 레이블 언어. 묻지 않기 위한 기본 규칙: 기술 용어는 사용자가 언급한 텍스트의 언어로 갑니다 (칸트는 독일어, 플라톤은 그리스어 음역, 들뢰즈나 라루엘은 프랑스어, 또는 사용자가 작업하는 번역문의 언어), 나머지 레이블과 각주는 사용자가 쓰는 언어로 갑니다. 전달 시 선택을 선언하세요; 다이어그램이 다른 언어의 출판물에 들어갈 경우 물어보세요.
스타일, 아키타입 또는 선에 대해 묻지 마세요: 그것은 당신이 어휘로 결정하고 정당화하는 것입니다.
전달
NN-nombre.tex + PDF + PNG + fidelidad.md가 포함된 작업 폴더와 한 단락으로 다음을 말하세요:
- 다이어그램이 무엇을 보여주는지 (테제);
- 왜 그 아키타입인지 (한 줄);
- 어떤 해석적 결정이 내려졌는지 († 행들);
- 텍스트 중 무엇이 빠졌고 그 이유는 무엇인지.
작업이 ~/.claude/diagramas-tikz/ 안에 들어가면 번호를 계속 매기고(다음 사용 가능 번호; 마지막은 37) 사용자가 요청할 때만 새 다이어그램을 todos.tex에 추가하세요.
안티-패턴
- 화살표가 있는 목록. 모든 간선이 동일하면 분석이 부족한 것입니다.
- 다른 유형의 관계에 대한 일반적인 화살표 "→".
- 모든 것에 상자. 상자는 형태가 의미를 가질 때만 나타납니다.
- 기술 용어 의역 ("순수 기억" 대신 Mnemosyne).
- 다이어그램 내 다이어그래머의 주석. 전달 단락에 들어가거나, 해석적 결정인 경우 † 각주에 들어갑니다.
- 텍스트에 없는 대칭으로 공간 채우기. 빈 공간이 있는 다이어그램은 정직한 다이어그램입니다.
- "교리"에 대한 기억으로 구절 대신 그리기: 거의 모든 불충실함의 원인입니다.