SoDam-Reverse-Eng (소담-리버스) — 내 코드를 쉬운 한국어로 설명해 주는 도구

컴퓨터·AI가 처음이어도 괜찮습니다. 이 문서를 처음부터 따라가면 됩니다.

내가 만든(또는 허가받은) 코드·앱이 어떻게 동작하는지 AI가 쉬운 한국어로 설명해 주는 Claude Code 플러그인입니다.

⚠️ 정직한 약속: 크랙·불법 복제·비밀번호 추출·보안 우회 안내는 요청해도 거부합니다. 방어·교육·본인 소유물 분석 전용입니다.

🌸 SoDam Family 7형제 중 하나입니다.

0. 컴퓨터·AI가 정말 처음이신가요? (기본 용어)
1. 이게 뭔가요?
2. 무엇을 해 주나요?
3. 무엇을 거부하나요?
4. SoDam 6형제 시너지
5. 사전 준비물
6. 설치 방법
   • 6-1. 빠른 시작 (5분 요약)
7. 명령어
8. 분석 흐름 (워크플로우)
9. 보안·데이터 흐름
10. 아키텍처·파일 구조
11. 파일·문서 위치
12. 문제 해결·FAQ
13. 라이선스·저작권·상업적 용도
14. 연락·기여
15. 업데이트 내용 요약

이미 컴퓨터·스마트폰 사용이 익숙하시면 이 부분은 건너뛰고 바로 1. 이게 뭔가요?로 이동하세요. 이 문서는 아래 용어를 몰라도 처음부터 순서대로 따라오면 끝까지 실행할 수 있도록 만들어졌습니다 — 막히면 이 표로 돌아와 다시 확인하세요.

플러그인이란 기존 프로그램에 새로운 기능을 추가하는 작은 도구입니다. (스마트폰에 앱을 추가 설치하는 것과 비슷한 개념입니다.)

SoDam-Reverse-Eng는 Claude Code라는 AI 도구에 "코드 분석" 기능을 추가하는 플러그인입니다.

• AI에게 "이 코드가 뭐 하는 거야?" 라고 물으면
• AI가 코드를 읽고 쉬운 한국어로 설명해 줍니다
• 분석 결과는 표준 보고서로 깔끔하게 정리됩니다
• 위험한 요청(크랙·우회 등)은 자동으로 거부합니다

• 내가 예전에 만든 코드가 어떻게 동작하는지 다시 파악하고 싶을 때
• 다른 사람이 만든 코드(허가받은 것)를 이해하고 싶을 때
• "이 함수가 왜 이렇게 작동하지?" 궁금할 때
• 내 코드의 보안 취약점이 어디 있는지 찾고 싶을 때

SoDam-Reverse는 6형제 플러그인 중 막내입니다. 형제들과 함께 설치하면 더 강력해집니다.

권장 설치 순서: Harness → Loop → Context → Agentic → Prompt → Reverse(이것)

⚠️ 중요: C:\Users\이름 (홈 폴더)에서 Claude Code를 시작하면 Harness · Loop guard가 정상 작업까지 막습니다. 반드시 프로젝트 폴더 (D:\내프로젝트\ 등)에서 시작하세요.

Harness가 설치된 경우 — 한 번만 실행:

node scripts/re-inject-harness.mjs

→ RE 위험 패턴이 Harness 안전규칙에 실제로 추가됩니다.

⚠️ 알려진 한계: 규칙은 공유되지만 hook 자체는 Reverse가 별도로 계속 등록합니다(Harness 존재 시 자체검사를 생략하는 기능을 2026-07-12에 시도했으나 위험 요청이 무검증 통과하는 실제 회귀가 발견돼 되돌림). 그래서 위험한 요청 1건에 차단 메시지가 2번 뜰 수 있으나, 같은 위험을 두 번 잡는 것뿐이라 안전에는 영향 없습니다.

Node.js란 이 플러그인의 안전장치가 동작하는 데 필요한 "실행 엔진"입니다.

이미 있는지 확인:

1. 키보드에서 ⊞ Windows 키 누르기
2. powershell 입력 → Windows PowerShell 클릭
3. 검은 창이 열리면 아래를 입력하고 Enter:

   node --version
   

4. v18. 이상 숫자가 나오면 OK (예: v20.19.0, v22.14.0)

없다면 (또는 v18보다 낮다면) 설치 방법:

1. 웹브라우저(크롬, 엣지 등) → nodejs.org 접속
2. 초록색 "LTS" 버튼 클릭 → 설치 파일(.msi) 내려받기
3. 내려받은 파일 더블클릭 → "다음(Next)"을 계속 누르기 → 설치 완료
4. PowerShell 창 완전히 닫기 → 새로 열기
5. 다시 node --version 입력하여 버전 확인

💡 컴퓨터를 재부팅해야 반영되는 경우도 있습니다.

이 문서를 Claude Code에서 보고 있다면 이미 있는 것입니다. 없다면 Anthropic 공식 사이트에서 Claude Code를 설치하세요.

명령어가 안 뜨는 원인 1위: Claude Code를 잘못된 폴더에서 시작했을 때

Claude Code는 켤 때의 폴더를 기준으로 명령어를 읽습니다. 채팅창에서 cd 다른폴더를 입력해도 명령어는 다시 읽히지 않습니다.

올바른 순서:

1. PowerShell(검은 창)을 열고
2. cd D:\내프로젝트폴더 입력 (프로젝트 폴더로 이동)
3. claude 입력해서 Claude Code 실행

❌ 홈 폴더(C:\Users\이름)에서 실행하면 /re-start 명령이 안 뜹니다.

📦 이 저장소는 공개(Public) 저장소입니다. 별도 초대·승인 절차 없이 누구나 아래 방법으로 바로 받을 수 있습니다.

먼저 다운로드부터 하세요. 아래 두 방법 중 편한 것을 고르면 됩니다 — 결과는 동일합니다. git을 써 본 적이 없다면 방법 B를 권장합니다.

방법 A — git으로 복제 (git 사용 경험이 있는 분)

1. PowerShell(검은 창)을 열고 복제 명령어 입력:

   git clone https://github.com/sodam-ai/SoDam-Reverse-Eng.git

   → 현재 폴더 안에 SoDam-Reverse-Eng 폴더가 생성됩니다.

2. 복제된 폴더 경로 확인 (예: C:\Users\내이름\SoDam-Reverse-Eng)

방법 B — GitHub 웹페이지에서 ZIP으로 직접 다운로드 (git 불필요, 처음이신 분께 추천)

1. 브라우저로 https://github.com/sodam-ai/SoDam-Reverse-Eng 접속
2. 초록색 <> Code 버튼 클릭 → Download ZIP 클릭
3. 받은 SoDam-Reverse-Eng-main.zip 파일의 압축을 풀어 원하는 위치에 저장 (예: C:\Users\내이름\SoDam-Reverse-Eng)

💡 로그인이나 계정 없이 누구나 받을 수 있습니다. 압축을 풀면 폴더 이름 끝에 -main이 붙어 있을 수 있는데, 원하는 이름(SoDam-Reverse-Eng)으로 바꿔도 상관없습니다.

다운로드가 끝났다면, 위 A 또는 B로 받은 폴더 경로를 Claude Code 채팅창에 입력해 마켓플레이스로 등록하세요:

/plugin marketplace add C:\Users\내이름\SoDam-Reverse-Eng

💡 내이름 부분을 실제 사용자 이름으로 바꿔 입력하세요. 경로에 공백이 포함된 경우 큰따옴표로 감싸세요: /plugin marketplace add "C:\내 이름 포함 경로\SoDam-Reverse-Eng"

마켓플레이스 등록 후 아래를 입력:

/plugin install sodam-reverse@sodamreverse-marketplace

또는 /plugin 입력 → 메뉴에서 Browse marketplaces → sodam-reverse → Install 선택.

플러그인은 Claude Code 시작 시에만 로드됩니다. 반드시 완전 종료 후 재시작해야 합니다.

1. 채팅창에 /exit 입력 → Enter
2. 터미널(검은 창) 완전히 닫기
3. PowerShell 새로 열기
4. 반드시 프로젝트 폴더에서 시작:

   cd D:\내프로젝트폴더
   claude

Claude Code가 열리면 /re-p 입력 → 자동완성에 아래가 떠야 정상:

/re-ping    (sodam-reverse)  ← 진단용
/re-start   (sodam-reverse)  ← 분석 시작

(sodam-reverse) 꼬리표가 붙어 있으면 플러그인으로 제대로 로딩된 것입니다.

진단 명령어 실행:

/re-ping

→ "Pong! /re-ping 정상 작동합니다." 응답이 오면 설치 완료.

/re-selftest

기대 결과: ✅ 13개 항목 전부 초록색(1층 스킬규칙 6개 + 2층 deny-hook 2개 + 3층 무결성 5개)

초록색 3개가 나오지 않으면 → TROUBLESHOOTING.md 참고

selftest 출력에서 핵심 안전파일 5개의 해시를 references/integrity.json에 저장하세요(이미 있는 항목은 유지):

{
  "hooks/hooks.json": "<셀프테스트가 출력한 해시>",
  "hooks/re-deny-guard.mjs": "<셀프테스트가 출력한 해시>",
  "hooks/_selftest.mjs": "<셀프테스트가 출력한 해시>",
  "references/deny-corpus.json": "<셀프테스트가 출력한 해시>",
  "references/mask-patterns.json": "<셀프테스트가 출력한 해시>"
}

→ 다시 /re-selftest 실행 → "3층 무결성: 해시 일치"가 5개 파일 전부에서 ✅ 확인

💡 처음 설치하실 때는 references/integrity.json이 비어 있어서 selftest가 5개 파일의 해시를 화면에 한 번에 출력해 줍니다. 이 5개(hooks.json·re-deny-guard.mjs·_selftest.mjs·deny-corpus.json·mask-patterns.json) 전부가 실제로 검사에 쓰입니다 — 개발자용 상세는 CHECKPOINT.md를 참고하세요.

위 6단계를 이미 하셨다면, 설치 후 첫 분석까지 이 5줄만 따라 하면 됩니다.

1. Claude Code 완전 재시작(설치 직후 필수) 후 /re-ping 입력 → "Pong!" 뜨면 설치 성공.
2. /re-selftest 입력 → 안전장치 13개 항목 전부 ✅ 인지 확인(1개라도 ❌면 §12 문제해결 먼저 참고).
3. /re-start samples/safe-login.js 입력 → "본인 소유/허가 대상인가요?" 등 질문에 **"예"**로 답하기.
4. 잠시 기다리면 한국어 분석 보고서가 화면에 출력됩니다(요약·함수설명·근거위치 포함).
5. 이후 내 코드로 실습: /re-start [내 파일 경로] — 이게 전부입니다.

막히면 §12(문제 해결·FAQ)를, 각 단계의 자세한 이유는 §6(설치 방법)을 참고하세요.

/re-start(소스 코드 분석)만 쓴다면 이 항목은 건너뛰어도 됩니다. /re-android(APK 분석) 또는 /re-binary(실행파일 분석)를 쓰려면 Java 17+·JADX·Apktool(안드로이드) 또는 JDK 21+·Ghidra(바이너리, 2026-08-19 실측 정정 — 이전엔 Java 17로 안내됨) 같은 추가 프로그램이 필요합니다.

상세 설치 방법(공식 배포처 링크·확인 명령·실제 검증된 버전)은 별도 문서로 정리했습니다: 📄 INSTALL.md — 필요 프로그램 설치 안내

💡 명령어가 "Unknown command"로 안 뜨면: 컴퓨터에 다른 Claude Code 플러그인이 여러 개 설치돼 있으면, 이름이 짧은 명령어(/re-start 등)가 다른 플러그인과 겹쳐 인식이 안 될 수 있습니다(2026-08-13 실사용 테스트로 확인된 실제 사례). 이럴 땐 앞에 플러그인 이름을 붙인 완전한 형태로 입력하세요: /sodam-reverse:re-start처럼 아래 모든 명령어 앞에 sodam-reverse:를 붙이면 항상 확실하게 동작합니다.

Phase 2·3 명령어:

사용자: /re-start 내코드/login.js
          ↓
[0단계] 안전장치 자가검증 (자동, 2026-08-02부터 동의 게이트 앞에 선행)
  `node hooks/_selftest.mjs`로 안전 3층(아래 참고)이 전부 정상인지 자동 재확인합니다.
  ❌가 하나라도 있으면 동의 게이트로 넘어가지 않고 여기서 즉시 중단합니다(fail-closed).
          ↓
[1단계] 동의 게이트 (버튼 선택형 질문 3개, 2026-07-27부터)
  AI가 소유권·분석 목적·이용 동의 질문 3개를 한 번에 띄웁니다 — 타이핑 대신 버튼(선택지)을 눌러 답합니다.
  세 질문 모두 "예" 계열 선택 → 다음 단계로. 하나라도 "아니오" → 즉시 중단
  (정확한 질문 문구는 §12 Q5 참고)
  통과하면 `.sodam-re/consent-log.jsonl`에 동의 기록 1줄이 추가됩니다(경로·시각, 2026-08-02부터).
          ↓
(0단계 안전 3층 상세 — 참고용, 실행 순서는 위 [0단계] 참고)
  1층: AI가 크랙·우회 내용인지 자체 판단
  2층: deny-hook이 위험 패턴 실시간 차단
  3층: 안전파일 변조 여부 SHA-256으로 확인
          ↓
[2단계] 분석 시작 (읽기 전용)
  - 파일 읽기만 (절대 실행 안 함)
  - 경로 조작 (../, 심볼릭 링크) 차단 시도 — **AI(1층) 판단 기반**(코드로 100% 강제되는 것은 아님, 2026-07-13 보안점검에서 확인)
  - 비밀번호 · 키 발견 시 자동 마스킹
          ↓
[3단계] 표준 보고서 출력
  ┌─────────────────────────────────────────────┐
  │ ■ 한 줄 요약 (이 코드가 하는 일 1줄로)       │
  │ ■ 함수별 설명 (파일명:줄번호 근거 포함)       │
  │ ■ 불확실한 점 (AI가 확신 못하는 부분 명시)   │
  │ ■ 다음 확인사항 (추가로 볼 것 제안)          │
  └─────────────────────────────────────────────┘
          ↓
[4단계] 로컬 저장
  .sodam-re/ 폴더에 저장 (.gitignore 등록됨)
  외부 서버 전송 없음

내 컴퓨터의 코드
    ↓ (분석을 위해 AI에 전송)
Claude AI (Anthropic 서버)
    ↓ (분석 결과만 반환)
내 컴퓨터 .sodam-re/ 저장

• AI에 전송: 코드 내용 (분석을 위해 필요 — Claude API 이용 약관 적용)
• 외부 전송 안 됨: 분석 결과, 동의 기록, 차단 로그
• 마스킹 처리 후 저장: 코드 중 발견된 비밀번호·키·토큰

fail-closed 원칙: hook에 오류가 생기면 "통과"가 아니라 분석 즉시 중단입니다.

[플러그인 폴더]/
└── .sodam-re/                     ← 분석 결과 저장 폴더 (자동 생성)
    ├── consent-log.jsonl          ← 동의 통과 기록 (한 줄에 하나씩 append, 덮어쓰기 없음)
    └── safety-log.jsonl           ← 차단 이벤트 기록 (원문 대신 SHA-256 해시만 저장)

⚠️ 정확성을 위한 표시: 분석 보고서 자체는 ".sodam-re/ 폴더 안에만 저장되고 외부로 전송되지 않는다"는 원칙만 확정돼 있으며, 파일별로 어떤 이름 규칙으로 저장할지는 아직 고정돼 있지 않습니다. 확실히 코드로 확인된 것은 위 두 파일(consent-log.jsonl·safety-log.jsonl)뿐이라, 확인 안 된 폴더 구조를 임의로 적지 않았습니다.

.sodam-re/ 폴더는 .gitignore에 등록되어 Git에 업로드되지 않습니다.

SoDam-Reverse-Eng/
│
├── .claude-plugin/              ← Claude Code 플러그인 선언
│   ├── plugin.json
│   └── marketplace.json
│
├── commands/                    ← 명령어 정의 (/re-start 등)
│   ├── re-ping.md               ← 진단 명령어
│   ├── re-start.md
│   ├── re-report.md             ← 실사용 라이브 검증 완료
│   ├── re-selftest.md
│   ├── re-agent.md              ← AI 에이전트 구조 분석, 실사용 라이브 검증 완료
│   ├── re-android.md            ← 실사용 라이브 검증 완료
│   └── re-binary.md             ← 실사용 라이브 검증 완료
│
├── skills/                      ← 분석 AI 로직
│   ├── re-router/               ← 1층 안전규칙 + 요청 분류
│   ├── re-analyze-mycode/       ← 소스코드 분석
│   ├── re-report/               ← 보고서 생성
│   ├── re-analyze-agent/        ← 라이브 검증 완료
│   ├── re-analyze-android/      ← 실사용 라이브 검증 완료
│   └── re-analyze-binary/       ← 실사용 라이브 검증 완료
│
├── hooks/                       ← 안전장치 (2층 · 3층)
│   ├── re-deny-guard.mjs        ← 2층: 위험 패턴 실시간 차단
│   ├── _selftest.mjs            ← 3층: SHA-256 무결성 점검
│   └── hooks.json               ← hook 설정
│
├── references/                  ← 데이터·규칙 파일
│   ├── deny-corpus.json         ← 위험 패턴 (키워드 60개 + 정규식 7개)
│   ├── mask-patterns.json       ← 마스킹 패턴 15개
│   ├── trust-catalog.md         ← 신뢰 도구 카탈로그 (15개 repo)
│   ├── report-template.md       ← 보고서 표준 양식
│   └── integrity.json           ← 안전파일 SHA-256 해시 저장소
│
├── scripts/                     ← 유틸리티 스크립트
│   ├── re-inject-harness.mjs    ← Harness 시너지 설정
│   ├── re-inject-context.mjs    ← Context 시너지 설정
│   ├── check-family.mjs         ← 6형제 상태 확인
│   ├── check-trust-freshness.mjs← 도구 신뢰도 신선도 점검
│   └── rotate-safety-log.mjs    ← 안전로그·동의기록 보존기간 관리(자동만료)
│
├── mcp/
│   └── catalog.json             ← Phase 2·3 외부 도구 큐레이션 설정(신뢰등급·라이선스)
│
├── samples/                     ← 테스트용 예제 파일
│   ├── safe-login.js            ← 정상 분석 테스트용
│   ├── deny-demo.txt            ← 차단 테스트용
│   ├── mycode-injection-demo.js ← 소스코드 프롬프트 인젝션 방어 테스트용
│   ├── android-injection-demo.xml← 안드로이드 프롬프트 인젝션 방어 테스트용
│   ├── binary-injection-demo.txt← 바이너리 프롬프트 인젝션 방어 테스트용
│   ├── agent-injection-demo.md  ← 프롬프트 인젝션 방어 테스트용
│   ├── agent-injection-demo-2.md← 결합공격(레드팀) 방어 테스트용
│   └── agent-injection-demo-3.md← 플러그인 설정파일 위장 인젝션 테스트용
│
├── .sodam-re/                   ← 분석 결과 저장 (자동 생성, .gitignore)
│
├── README.md                    ← 이 파일 (한국어 개요)
├── README.en.md                 ← English overview
├── INSTALL.md                   ← 추가 도구(Android·바이너리) 설치 상세
├── TROUBLESHOOTING.md           ← 오류 해결 가이드
├── CHECKPOINT.md                ← 개발 진행 상태 (개발자용)
├── SETUP_BLOCKED_FILES.md       ← 안전파일 코드 전문
├── LICENSE                      ← Apache-2.0 라이선스 전문
└── NOTICE                       ← 저작권 고지

3층 안전 흐름 요약:

[1층] skills/ 규칙    →  AI가 위험 출력 자체를 거부
[2층] hooks/re-deny-guard.mjs  →  위험 도구 호출 즉시 차단
[3층] hooks/_selftest.mjs      →  SHA-256으로 파일 변조 감지

원인 1 — 폴더 문제: Claude Code를 홈 폴더(C:\Users\이름)에서 실행했거나, 채팅창에서 cd로 이동한 것을 "이동했다"고 착각한 경우.

해결:

1. Claude Code 완전히 닫기
2. PowerShell 새로 열기
3. 프로젝트 폴더로 이동 후 실행:

   cd D:\내프로젝트폴더
   claude

4. /re-ping 입력 → "Pong!" 응답 확인

원인 2 — 다른 플러그인과 이름 겹침: 폴더는 맞게 실행했는데도 "Unknown command"가 뜬다면, 설치된 다른 플러그인 중 하나가 똑같이 짧은 명령어 이름을 쓰고 있어서 겹친 것입니다(실제 확인된 사례, §7 참고). 해결: /re-start 대신 /sodam-reverse:re-start처럼 앞에 sodam-reverse:를 붙여서 입력하세요.

설치 확인용 진단 명령어입니다. "Pong! /re-ping 정상 작동합니다." 라고 응답이 오면 플러그인이 제대로 로딩된 것입니다. 이 명령이 안 되면 /re-start도 안 됩니다.

nodejs.org → LTS 설치 → 터미널 껐다 켜기 → node --version 확인

C:\Users\이름 (홈 폴더)에서 실행하고 있을 가능성이 큽니다.

cd D:\내프로젝트폴더
claude

프로젝트 폴더에서 Claude Code를 다시 시작하세요.

질문 3개가 뜨면 자연어로 타이핑하지 말고, 버튼(선택지)을 직접 클릭하거나 번호를 선택하세요. "예" 계열 선택지를 골라야 동의로 처리됩니다 — "아니오"를 선택하거나 응답을 거부하면 그 즉시 분석이 중단됩니다.

정상 동작입니다. 이 도구는 방어·교육·본인 소유물 전용입니다.

SETUP_BLOCKED_FILES.md에서 5개 파일이 모두 있는지 확인 → 없는 파일만 다시 만들기 → Claude Code 완전 재시작 → 다시 /re-selftest

💡 만약 이 파일들을 안전을 위해 읽기전용으로 잠가 두셨다면(attrib +R, SETUP_BLOCKED_FILES.md 참고), 수정 전에 먼저 잠금을 해제(attrib -R)해야 편집기로 저장이 됩니다.

SHA-256 불일치:

node hooks/_selftest.mjs

출력 해시 → references/integrity.json 저장 → 재실행

⚠️ 주의: integrity.json에 이미 값이 들어있는 상태에서 해시가 달라 ❌가 뜬 경우, 위 명령은 "불일치(변조 의심)"라고만 알려주고 새 해시를 화면에 출력하지 않습니다(해시 출력은 integrity.json이 비어있을 때만 나옵니다). 이럴 때는 ❌가 뜬 파일 경로(hooks/hooks.json · hooks/re-deny-guard.mjs · hooks/_selftest.mjs · references/deny-corpus.json · references/mask-patterns.json 중 하나)를 아래 명령의 <파일경로> 자리에 넣어 새 해시를 직접 확인하세요:

node -e "console.log(require('crypto').createHash('sha256').update(require('fs').readFileSync('<파일경로>')).digest('hex'))"

버그입니다. references/mask-patterns.json에 해당 패턴이 없는 것입니다. 해당 보고서를 공유하지 마시고 GitHub Issues에 신고해 주세요.

파일 하나씩 분석하세요:

/re-start src/auth.js

폴더 전체보다 파일 단위가 훨씬 잘 동작합니다.

node scripts/re-inject-harness.mjs

"RE 규칙 N개 주입 완료" 메시지가 나오면 성공.

→ TROUBLESHOOTING.md — 실패 패턴 전체 해결법

Apache License 2.0 · © 2026 SoDam AI Studio

구체적으로 자주 묻는 상황 (Apache-2.0 기준, 아래 "반드시 해야 하는 것" 의무를 지키는 한 전부 가능합니다):

위 표는 이 도구 자체의 라이선스에 대한 안내입니다. 이 도구로 무엇을 분석하는지(제3자 코드·앱)에 대한 적법성은 완전히 별개 문제이며, 아래 "⚠️ 반드시 알아야 할 법적 책임 한계"에서 따로 다룹니다.

• "Claude", "Claude Code", "Anthropic" — Anthropic 소유 상표
• "IDA Pro" — Hex-Rays 소유 상표 (Phase 3 선택 기능)
• 위 상표들은 본 제품과 공식 제휴 또는 보증 관계 없음

• 이 도구가 만드는 분석 보고서: /re-start·/re-android·/re-binary·/re-agent 등이 만드는 보고서는 AI가 작성합니다. 보고서를 상업적으로 사용하거나, 대외 제출하거나, 법적·계약적 판단의 근거로 삼기 전에는 반드시 사람이 직접 검토하고, 분석 대상 원본의 저작권·출처, 그리고 보고서 내용이 실제 코드와 일치하는지 확인하세요. 다른 저작물과 우연히 유사한 표현이 포함될 가능성도 배제할 수 없습니다.
• 이 프로젝트 자체의 개발 방식: 이 프로젝트의 소스코드·문서 작성에는 AI 코딩 도구(Claude Code)가 광범위하게 사용되었습니다(2026-09-01 기준 전체 커밋 103건 중 43건에 "Co-Authored-By: Claude" 공동저자 표기 확인 — 확인된 사실). AI 보조로 작성된 저작물의 저작권 성립 범위·귀속은 국가·관할마다 다르게 취급될 수 있어(예: 저작권 등록 가능 여부), 이 점이 실무적으로 중요한 상황(예: 특허·저작권 등록, 분쟁 대응)이라면 법무/전문가 검토가 필요합니다 — 이 문서는 그 결론을 대신 내리지 않습니다.

이 섹션은 법률 자문이 아닙니다. 실제 법적 판단이 필요한 상황이라면 반드시 변호사와 상담하세요. 아래는 "이 도구가 안전하다"는 것과 "내가 무엇을 분석하는가가 항상 합법이다"는 것이 서로 다른 문제임을 알려드리기 위한 안내입니다.

요약: 이 도구(SoDam-Reverse-Eng) 자체의 라이선스(Apache-2.0)는 상업적 사용을 포함해 자유롭게 허용하지만, "무엇을 분석하는가"에 대한 법적 책임은 도구의 라이선스와 완전히 별개입니다. 도구가 안전장치를 갖췄다고 해서 분석 행위 자체가 항상 합법인 것은 아닙니다 — 확신이 서지 않으면 분석 전에 변호사와 상담하세요.

• "있는 그대로(AS-IS)" 제공
• 품질 · 성능 · 특정 목적 적합성에 대한 보증 없음
• 사용 결과에 대한 책임은 사용자 본인에게 있음
• "100% 안전"은 어떤 보안 도구도 보장할 수 없습니다

라이선스 전문: LICENSE · 저작권 고지: NOTICE

• 버그 신고 · 기능 요청: GitHub Issues — 공개 저장소라 누구나 등록 가능 또는 이메일
• 이메일: startmxk@gmail.com
• GitHub 저장소: https://github.com/sodam-ai/SoDam-Reverse-Eng (공개 — 별도 초대 불필요)
• 기여 방법: Pull Request 환영. 큰 변경은 먼저 Issue로 논의해 주세요. 단, 안전장치 핵심 파일(§10의 "보호파일" 8개 — deny-hook·무결성 목록 등)에 대한 변경은 프로젝트 설계상 AI가 스스로 수정하지 않는 영역이라, 반드시 이메일로 먼저 상의한 뒤 사람이 직접 검토·반영합니다.

각 항목을 클릭하면 상세 내용이 펼쳐집니다. (개발 이력 기반 — GitHub·브라우저 모두 접기/펼치기 지원)

개발 상세 이력은 CHECKPOINT.md(개발자용)를 참고하세요.

English version: README.en.md 오류 해결: TROUBLESHOOTING.md