AI 에이전트를 활용한 증거 우선 구소련 지역 계보 연구

구소련 지역 친족 연구란?

구소련 지역 친족 연구는 Codex와 Claude Code 같은 AI 에이전트를 위한 증거 우선 계보 연구 스킬입니다. 이 스킬은 기록, 해석, 미해결 질문을 명확히 구분하면서 구소련, 소비에트 연방 및 러시아 제국과 관련된 가족사 질문을 조사하는 데 도움을 줍니다.

이 스킬은 교회 장부, 민사 등록부, 군사 데이터베이스, 강제이주 및 탄압 기록, 공개 문서 컬렉션, 색인되지 않은 기록 보관소 스캔 자료를 대상으로 설계되었습니다. 근거 없는 가계도를 만드는 대신 각 발견의 출처를 기록하고, 독립적인 증거와 중복 사본을 구분하며, 무엇이 입증되었고 무엇이 입증되지 않았는지 설명합니다.

내부 지침은 러시아어로 작성되어 있지만 에이전트는 사용자의 언어로 답변합니다. 원문 표기의 이름과 구절을 인용하고 번역을 제공하며, 러시아어, 우크라이나어, 폴란드어, 루마니아어, 독일어, 이디시어 형태를 포함해 기록에 적합한 언어로 검색어를 구성할 수 있습니다.

주요 기능

• 구조화된 사건 접수: 하나의 연구 질문, 알려진 사실, 생존 가능성이 있는 사람, 접근을 제한할 주제를 정의합니다.
• 재현 가능한 등록부: 사람, 자료, 주장, 관계, 검색 기록을 위한 CSV와 최종 보고서 템플릿을 함께 관리합니다.
• 역사적 관할 구역: 현대 지도가 아니라 사건 발생 당시 존재했던 국가, 주, 군, 교구 또는 민사 등록 기관을 기준으로 사건의 관할을 확인합니다.
• 이름 변형 분석: 여러 지역 언어에서 부칭, 결혼 전 성, 음역 및 역사적 표기 형태를 고려합니다.
• 출처 계층: 온라인 가계도나 포럼을 단서로 취급하기 전에 원본 기록, 공식 목록 및 색인을 우선합니다.
• 명시적 증거 상태: 주장을 가설, 단일 출처, 상호 검증, 강한 상호 검증, 모순됨 또는 미해결로 표시합니다.
• 신원 판별: 부모, 집 번호, 정확한 생년월일, 대부모 또는 군부대와 같은 세부 정보가 연결될 때까지 동명이인 후보를 별도의 person_id 값으로 유지합니다.
• 증거 감사: 최종 보고서를 작성하기 전에 참조 무결성을 확인하고 상호 검증이 취약한 부분을 경고합니다.
• 책임 있는 경계: 생존자를 보호하고 로그인 및 CAPTCHA 처리는 사람이 수행하도록 하며, 유료벽, 요청 제한 또는 접근 제어를 우회하지 못하도록 합니다.

사전 요구 사항

Git, Python 3 및 지원되는 Agent Skills 런타임이 필요합니다. 포함된 스크립트는 Python 표준 라이브러리만 사용하므로 추가 Python 패키지는 필요하지 않습니다.

사용 중인 에이전트에 맞는 설치 위치를 선택하세요. Codex는 ~/.codex/skills/를 사용하고, 개인 Claude Code 스킬은 ~/.claude/skills/를 사용합니다. Claude Code는 프로젝트의 .claude/skills/ 디렉터리에서도 스킬을 불러올 수 있습니다.

스킬 설치

Codex에 설치

git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.codex/skills/ex-ussr-kinship-research

개인 Claude Code 스킬로 설치

git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.claude/skills/ex-ussr-kinship-research

하나의 Claude Code 프로젝트에 설치

프로젝트 저장소 안의 .claude/skills/ex-ussr-kinship-research에 저장소를 복제하거나 복사하세요. 이렇게 하면 모든 프로젝트에서 사용할 수 있게 하는 대신 해당 프로젝트에 스킬을 연결할 수 있습니다.

소스 저장소는 GitHub에서 확인할 수 있습니다.

연구 사건 시작

가장 간단한 시작 방법은 구체적인 가족사 질문 하나를 제시하는 것입니다. 알려진 이름, 대략적인 날짜, 장소, 기록 스캔 자료 및 불확실한 점을 포함하되, 검증되지 않은 가족 이야기를 사실로 가정하지 마세요.

요청 예시는 다음과 같습니다.

• 증조부가 1930년대에 카자흐스탄으로 유배되었습니다. 교회 기록에서 그의 부모를 찾도록 도와주세요.
• 결혼 증명서와 군인 카드를 스캔한 자료입니다. 두 기록이 같은 사람을 가리키는지 확인하고 증거의 연결 고리를 만들어 주세요.
• 1890년대 포돌리아의 한 마을에 해당하는 교구와 올바른 FamilySearch 필름을 찾은 다음, 이 성씨의 출생 기록을 조사해 주세요.

에이전트는 광범위한 검색을 시작하기 전에 접수를 진행해야 합니다. 유용한 요청에는 핵심 질문, 알려진 사실, 생존 가능성이 있는 사람, 제한 사항 및 원하는 출력 언어가 명시되어야 합니다. 기본 언어 설정은 자동이므로 에이전트는 일반적으로 연구자가 사용한 언어와 같은 언어로 답변해야 합니다.

연구 작업 공간 만들기

스킬 저장소에서 포함된 스크립트를 사용해 사건 디렉터리를 초기화하세요.

python scripts/init_case.py --case-dir ./my-case --research-question "Who were Maria's parents?" --subject-label "Maria"

이 명령은 사람, 자료, 주장, 관계 및 검색 기록을 추적하는 데 사용하는 구조화된 작업 공간을 만듭니다. 결과로 생성되는 증거 기록을 이해하기 쉽게 유지하려면 사건마다 하나의 집중된 연구 질문만 두세요.

자료 등록 및 해시 생성

저장한 스캔 자료와 문서는 파일 이름이 변경되거나 중복 사본이 생겨도 식별할 수 있어야 합니다. 각 자료에 대해 SHA-256 해시를 생성하세요.

python scripts/hash_artifact.py ./scans/marriage-1902.jpg

유물의 출처 정보와 함께 사건 기록부에 기록하세요. 다운로드한 이미지, 동일한 원기록을 잘라낸 이미지와 미러본은 자동으로 서로 독립적인 증거가 되지 않습니다. 관련 사본에는 동일한 independence_group을 지정하여 별도의 증거로 중복 집계되지 않도록 해야 합니다.

증거 우선 작업 흐름 따르기

1. 대상 주장을 정의하세요. 광범위한 가족 관련 질문을 기록으로 뒷받침하거나 반박할 수 있는 주장으로 구체화하세요. 예를 들어 마리아의 부모를 확인하는 것입니다.
2. 역사적 장소를 확인하세요. 사건 발생일의 관할권을 파악하세요. 관련 주, 지구, 교구 또는 민사 등록기관을 포함해야 합니다.
3. 이름 변형을 작성하세요. 현지 기록 담당자가 사용하는 언어를 기준으로 가능한 철자, 부칭, 결혼 전 성과 음역 표기를 준비하세요.
4. 더 강력한 출처부터 검색하세요. 원본 기록을 우선하고, 그다음 공식 목록, 색인 및 공개된 문서 모음을 확인하세요. 사용자 기여 족보와 포럼 게시물은 증거가 아니라 단서로 취급하세요.
5. 성공한 검색과 실패한 검색을 기록하세요. 검색한 곳, 사용한 질의 또는 확인한 필름과 결과를 기록하세요. 부정적인 검색 결과는 반복 작업을 방지하고 어떤 공개 출처를 모두 확인했는지 명확히 해 줍니다.
6. 증거에서 주장을 생성하세요. 모든 사실 주장을 이를 뒷받침하는 유물에 연결하고 설명 가능한 상태를 지정하세요.
7. 신원을 신중하게 판별하세요. 이름과 마을이 같다는 이유만으로 사람들을 동일 인물로 합치지 마세요.
8. 보고 전에 감사하세요. 감사 스크립트를 실행하고 취약한 연결, 누락된 참조 및 잘못 집계된 보강 증거를 처리하세요.

증거 감사하기

결론을 생성하기 전에 다음을 실행하세요.

python scripts/audit_evidence.py --case-dir ./my-case

감사는 기록부의 참조 무결성을 확인하고 취약한 보강 증거를 표시합니다. 결과를 사용하여 사건 데이터를 수정하거나 주장을 미해결 상태로 표시하세요. 목표는 모든 질문을 확신에 찬 답변으로 몰아가는 것이 아니라, 각 결론이 이용 가능한 증거를 정확히 반영하도록 하는 것입니다.

색인되지 않은 스캔 자료 다루기

FamilySearch의 구소련 지역 교회 장부 중 상당수는 이미지만 제공되는 컬렉션입니다. 따라서 관련 기록이 실제로 존재하더라도 성으로 검색하면 아무 결과도 나오지 않을 수 있습니다. 프로젝트의 현장 지침에서는 올바른 필름을 찾고, 보관소 참조 정보를 필름 식별자로 매핑하며, 관련 권이나 절을 찾고, 핵심 열을 훑어본 다음 후보 기록을 확대해 확인할 것을 권장합니다.

확인한 필름, 이미지 범위, 기록 유형 및 페이지를 기록하세요. 가능하다면 집중적으로 자른 이미지나 열을 합성한 화면을 사용하면 긴 기록부를 검토하기가 쉬워집니다. 브라우저 작업은 예의 있게 진행해야 합니다. 요청 제한을 준수하고, 적절하게 재시도하며, 장시간의 스캔 작업은 전용 탭에서 수행하세요.

연결 단서 찾기

이름만으로는 충분하지 않은 경우가 많습니다. 더 강력한 신원 단서로는 혼인 기록에 반복해서 나타나는 정확한 생년월일, 일관된 번지수, 일치하는 부모 또는 대부모, 군부대 등이 있습니다. 현장 안내서는 사산 기록, 역사적 부칭 표현과 Grigorie 및 Gheorghe와 같은 서기의 대체 표기도 다룹니다.

오래된 기록부에 남은 소련 시대의 여백 주석도 중요할 수 있습니다. 증명서가 발급되었다는 후대의 기록은 해당 인물이나 가족이 그 후대 날짜에 생존해 있었고 서류를 요청했음을 보여 줄 수 있습니다.

고급 조사 요령

출생지와 거주지를 구분하세요

“~에서 태어났다”와 “~에서 자랐다”를 같은 의미로 취급하지 마세요. 마을은 이름이 바뀌거나, 지구 간에 편입되거나, 완전히 폐지되었을 수 있습니다. 사건 발생일을 중심으로 장소의 역사를 정리하고 현대의 지명은 별도로 기록하세요.

성씨 군집을 신중하게 사용하세요

군사 데이터베이스에서는 같은 성과 출생지를 가진 사람들의 집단이 드러나기도 하며, 이를 성씨 둥지라고 부르기도 합니다. 이러한 군집은 가설을 세우는 데 유용하지만, 그 자체로 친족 관계를 입증하지는 않습니다. 제2차 세계대전 전사·실종 데이터베이스에는 생존자가 누락되는 경우도 많으므로, 기록이 없다는 사실만으로 해당 인물이 복무하지 않았다고 볼 수 없습니다.

탄압 및 강제이주 자료를 맥락 속에서 해석하세요

공개된 문서 모음과 복권 관련 기록에는 판결, 가족 및 행정 세부 정보가 포함될 수 있습니다. 법적 근거와 같은 열은 주의 깊게 읽으세요. 기록에 언급된 현지 사건이 가족에게 영향을 준 더 광범위한 강제이주 작전과 동일하지 않을 수 있습니다. 공개 기록만으로 충분하지 않은 경우, 이 기능은 보관소 요청서 초안을 작성할 수 있지만 해당 요청을 전송하지는 않습니다.

가족 자료를 출처로 취급하세요

여권, 구술 역사 녹음 자료 및 연구자의 메모는 출처 유형을 정확히 표시하면 증거로 포함할 수 있습니다. 녹음된 인터뷰에는 타임스탬프를 추가하고, 친척이 직접 목격한 내용, 다른 사람에게 들은 내용 및 연구자가 추론한 내용을 구분하여 보존하세요.

공개 증거를 모두 확인했으면 중단하세요

책임 있는 에이전트는 같은 검색을 무한히 반복하거나 세부 사항을 지어내어 빈틈을 메워서는 안 됩니다. 접근 가능한 출처를 모두 확인했다면 조사한 내용을 요약하고, 생존한 친척에게 물어볼 구체적인 질문을 준비하며, 관련 보관소에 보낼 요청서 초안을 작성하세요.

개인정보 보호 및 접근 규칙

• 생존 인물의 현재 주소, 전화번호 또는 온라인 계정을 찾기 위해 이 기술을 사용하지 마세요.
• 보고서에 포함되는 생존 인물과 미성년자의 개인정보를 최소화하세요.
• 명시적인 동의 없이 비공개 문서나 DNA 데이터를 제3자 서비스에 업로드하지 마세요.
• 사이트 로그인과 CAPTCHA 입력은 사용자가 직접 완료하도록 하세요. 에이전트는 CAPTCHA를 해결하거나 우회해서는 안 됩니다.
• 페이월, 지역 차단, 속도 제한 또는 기타 접근 제어를 회피하지 말고, 유출된 데이터베이스를 사용하지 마세요.
• 탄압, 추방, 입양 또는 예상치 못한 DNA 결과와 관련된 민감한 발견은 연구 질문에 필요한 범위에서만 중립적으로 보고하세요.
• 접근 규정은 변경될 수 있으므로 요청을 제출하기 전에 현재의 기록 보관소 절차를 확인하세요.

저장소 이해하기

SKILL.md에는 핵심 작업 흐름, 필수 규칙 및 언어 정책이 포함되어 있습니다. references/ 디렉터리에는 출처 전략, 증거 규칙, 로케일 지침, 브라우저 사용 방식, 개인정보 보호 지침, 엄선된 시작 출처 및 실무 경험에서 얻은 교훈이 제공됩니다. assets/ 디렉터리에는 사례 템플릿이 있으며, scripts/에는 초기화, 해시 생성 및 감사 유틸리티가 들어 있습니다.

기여자는 references/seed-sources.md에 출처를 추가할 수 있습니다. 항목에는 소유자, 관할권, 수집 유형, 해당 리소스에 원본이 포함되어 있는지 또는 색인인지, 안정적인 식별자, 접근 조건, 제한 사항, 일반적인 오류 및 마지막 확인 날짜가 명시되어야 합니다. 예시에는 개인정보가 노출되어서는 안 됩니다.

결론

ex-USSR Kinship Research는 AI 에이전트를 자동 가계도 생성기가 아니라 구조화된 연구 보조 도구로 전환합니다. 이 도구의 핵심 가치는 추적 가능성에 있습니다. 각 인물, 유물, 주장, 관계 및 검색을 검토할 수 있으며, 불확실성과 모순도 그대로 확인할 수 있습니다. 역사적 관할권, 다국어 이름 변형, 신중한 신원 확인 및 최종 감사를 결합하면 재현 가능하고 한계를 정직하게 밝히는 가족사 연구 결론을 도출할 수 있습니다.

이 프로젝트는 Denis Shiryaev가 유지 관리하며 MIT 라이선스에 따라 배포됩니다.