SoDam Persona

SoDam Persona는 Anthropic의 AI 코딩 도우미인 Claude Code(사람의 말로 개발을 돕는 AI 프로그램)에 "신중하고 꼼꼼한 한국어 개발 파트너" 성격을 심어주는 부가 프로그램(플러그인, plugin — 원래 프로그램에 기능을 더해주는 작은 추가 프로그램)입니다.

컴퓨터·전자기기·AI·메신저를 처음 다루는 분도 이 문서만 따라오면 설치부터 실제 사용까지 끝까지 진행할 수 있도록, 낯선 용어가 처음 나올 때마다 쉬운말(전문용어) 형식으로 함께 풀어 적었습니다. 예: 저장소(repository, 코드와 문서를 모아두는 온라인 보관함).

이 플러그인 자체는 별도의 AI가 아닙니다. Claude Code가 이미 갖고 있는 대화 능력 위에 "이렇게 판단하고 이렇게 답하라"는 규칙 문서를 자동으로 얹어주는 설정 모음입니다. 항상 켜지는 핵심 규칙(hook, 후크 — 특정 시점에 자동으로 실행되는 작은 프로그램) 2개와, 상황에 맞을 때만 불러오는 전문 지식 모음(skill, 스킬) 9개로 이루어져 있습니다.

지금 버전: 1.3.0 · 관점 수: 15명 · 트리거 패턴: 20개(A~T) · 스킬 수: 9개 · hook 수: 2개 · 라이선스: Apache License 2.0

1. 사전 준비물
2. 필요 프로그램
3. 다운로드 방법
4. 설치 방법
5. 빠른 시작 방법
6. 실행 방법
7. 사용 방법
8. 명령어
9. 작동 방법
10. 워크플로우
11. 아키텍처
12. 보안과 데이터 흐름
13. 파일과 문서 위치
14. 업데이트 내용 요약
15. 문제와 오류 대처 방법
16. 자주 묻는 질문 (FAQ)
17. 법률, 저작권, 라이선스, 상업적 용도

설치를 시작하기 전에 아래 4가지가 준비되어 있는지 확인하세요. 하나라도 없으면 필요 프로그램에서 설치 방법을 안내합니다.

운영체제: Windows, macOS, Linux 어디서나 동작합니다. 이 문서의 명령 예시는 Windows PowerShell 기준이며, macOS/Linux는 같은 명령을 Terminal(터미널) 앱에 그대로 입력하면 됩니다.

계정: Claude Code를 쓰기 위한 Anthropic 계정/구독은 이 플러그인과 별개로 이미 준비되어 있어야 합니다(이 플러그인은 계정을 만들어주거나 로그인을 대신 처리하지 않습니다).

아래 표 순서대로 설치하면 막힘이 없습니다. 이미 설치되어 있다면 버전 확인 명령으로 점검만 하고 넘어가세요.

• Claude Code는 이 플러그인을 "실행할 무대"입니다. 반드시 먼저 설치·로그인까지 끝내주세요.
• Node.js는 일반 사용자에게도 필수입니다(hook 실행용). 설치 후 터미널을 새로 열어야 node 명령이 인식됩니다.
• Git은 GitHub에서 설치하는 경우에만 필요합니다. 이 저장소를 이미 폴더로 갖고 있고 로컬 설치만 할 것이라면 없어도 됩니다.
• Pandoc은 이 플러그인을 "사용"하는 데는 전혀 필요 없습니다. README.md 문서 내용을 고쳐서 README.html을 다시 만들 사람만 설치하면 됩니다.

버전 확인은 터미널에 아래처럼 입력합니다.

node --version
git --version

숫자가 뜨면 설치된 것이고, "찾을 수 없는 명령"류 오류가 뜨면 아직 설치가 안 된 것입니다(문제와 오류 대처 방법 참고).

이 플러그인은 사용자가 직접 설정해야 하는 환경 변수(API 키, .env 파일 등)가 하나도 없습니다(hook 스크립트 2개를 코드 기준으로 전수 확인한 결과 process.env를 읽는 코드가 없음). hook 명령의 ${CLAUDE_PLUGIN_ROOT}는 Claude Code가 실행 시점에 플러그인 설치 경로로 자동 치환해 주는 값이라, 사용자가 별도로 지정할 필요가 없습니다.

설치 방법은 두 갈래로 나뉘는데, 그중 무엇을 고르느냐에 따라 "다운로드"가 필요할 수도, 필요 없을 수도 있습니다.

Claude Code가 설치 시점에 저장소를 알아서 가져오므로, 사람이 미리 파일을 내려받을 필요가 없습니다. 바로 설치 방법의 "GitHub에서 설치"로 이동하세요.

1. Git으로 복제(clone, 원격 저장소를 내 컴퓨터로 그대로 복사)

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

2. 또는 Git 없이 ZIP으로 다운로드

   • 저장소의 GitHub 페이지를 웹 브라우저로 연다.
   • 초록색 "Code" 버튼 클릭 → "Download ZIP" 클릭.
   • 내려받은 압축 파일을 원하는 폴더에 풀기(압축 해제).

두 방법 모두 결과적으로 이 저장소의 파일 전체(이 README.md를 포함)가 내 컴퓨터의 한 폴더 안에 놓이게 됩니다. 이 폴더를 "저장소 루트(root, 맨 위 폴더)"라고 부릅니다. 다음 단계인 설치 방법에서는 이 폴더 안에서 명령을 실행합니다.

Claude Code를 실행한 뒤, 대화창에 아래 두 줄을 순서대로 입력합니다(각 줄 입력 후 Enter).

/plugin marketplace add sodam-ai/SoDam-Persona
/plugin install sodam-persona@sodam-persona

• 1번째 줄: "이 GitHub 저장소를 플러그인 후보 목록(마켓플레이스, marketplace)에 등록해줘"라는 뜻.
• 2번째 줄: "등록된 후보 중 sodam-persona 플러그인을 실제로 설치해줘"라는 뜻. sodam-persona@sodam-persona에서 @ 앞은 플러그인 이름, 뒤는 그 플러그인이 속한 마켓플레이스 이름입니다(이 저장소는 둘 다 sodam-persona로 같습니다). 설치 화면에서 User/Project/Local 중 설치 범위(scope)를 고르라고 뜨면, 개인적으로만 쓸 것이라면 User를 선택하면 됩니다.

설치 결과 메시지가 Plugin is now active.이면 바로 적용된 것이고, Run /reload-plugins to activate.이면 아래 명령을 한 번 더 입력해야 합니다.

/reload-plugins

다운로드 방법의 방법 B로 저장소를 이미 내려받았다면, 그 폴더(저장소 루트)에서 Claude Code를 실행한 뒤 대화창에 아래를 입력합니다.

/plugin marketplace add .
/plugin install sodam-persona@sodam-persona

.(마침표 하나)은 "지금 내가 있는 이 폴더"라는 뜻입니다.

Claude Code는 플러그인과 마켓플레이스를 "사용자 권한으로 임의 코드를 실행할 수 있는 고신뢰 구성요소"로 취급합니다. /plugin marketplace add·/plugin install 실행 시 출처(이 경우 sodam-ai/SoDam-Persona GitHub 저장소)를 신뢰하는지 확인하는 절차를 거치며, 신뢰하는 출처에서만 설치를 진행해야 합니다(보안과 데이터 흐름 참고).

/plugin marketplace list
/plugin list

첫 번째 명령은 등록된 마켓플레이스 목록을, 두 번째 명령은 실제로 설치된 플러그인 목록을 보여줍니다. 둘 다에서 sodam-persona가 보이면 설치가 정상적으로 끝난 것입니다.

이미 사전 준비물을 다 갖췄고, 세세한 설명 없이 바로 시작하고 싶은 분을 위한 5단계 요약입니다.

1. 터미널에서 claude를 입력해 Claude Code를 연다.
2. /plugin marketplace add sodam-ai/SoDam-Persona 입력 후 Enter.
3. /plugin install sodam-persona@sodam-persona 입력 후 Enter. (Run /reload-plugins to activate.라고 뜨면 /reload-plugins도 입력)
4. 그냥 평소처럼 한국어로 말을 건다. 예: 이 코드에서 버그 찾아줘 — 특별한 명령어를 외울 필요 없이 자연어(사람이 평소 쓰는 말) 그대로 사용하면 페르소나가 자동으로 판단해서 반응합니다.

막히면 문제와 오류 대처 방법으로 바로 이동하세요.

"플러그인을 실행한다"는 개념은 따로 없습니다. 이 플러그인은 Claude Code를 실행하고 대화를 시작하는 순간 자동으로 함께 동작합니다. 즉, "실행 방법"은 곧 "Claude Code를 여는 방법"입니다.

1. 터미널(윈도우는 PowerShell 또는 명령 프롬프트, macOS는 Terminal 앱)을 연다.
2. claude라고 입력하고 Enter를 누른다.
3. 새 세션이 열리면, 그 세션 시작 시점에 이 플러그인의 SessionStart hook이 자동으로 실행되어 페르소나 코어를 주입합니다.

Claude Code가 연결된 IDE 확장을 쓰는 경우, IDE 안에서 Claude Code 패널을 열고 새 세션을 시작하면 동일하게 적용됩니다.

1. 화면 왼쪽 아래 검색창에 PowerShell이라고 입력한다.
2. 검색 결과에 뜨는 "Windows PowerShell"을 클릭해서 연다.
3. 검은(또는 파란) 화면에 커서가 깜빡이면, 명령을 한 글자도 틀리지 않게 입력하고 Enter 키를 누른다.
4. 결과 메시지가 화면에 출력된다. 오류처럼 보이는 빨간 글씨가 나오면 문제와 오류 대처 방법을 확인한다.

평소 Claude Code에게 말하듯 한국어로 자연스럽게 요청하면 됩니다. 페르소나 코어가 항상 켜져 있어 자동으로 적용되고, 요청 내용이 특정 전문 skill의 설명과 맞아떨어지면 해당 skill이 조건 없이 자동으로 함께 불려옵니다.

이 코드에서 버그 좀 찾아줘
이 로직을 객관적으로 검토해줘
이 기능을 안전하게 배포하려면 뭘 확인해야 해?

/sodam-persona:<skill 이름> 형식으로 명시적으로 부를 수 있습니다.

/sodam-persona:persona-investor 이 자동매매 로직의 손실 시나리오를 검토해줘
/sodam-persona:persona-lawyer 이 서비스 약관의 위험 조항을 찾아줘
/sodam-persona:persona-accountant 이 비용을 경비 처리할 수 있는지 검토해줘
/sodam-persona:persona-marketer 이 랜딩페이지 카피를 개선해줘
/sodam-persona:persona-create 새 의료 도메인 페르소나를 추가해줘
/sodam-persona:persona-edit 투자자 트리거에 "리밸런싱"을 추가해줘

대화창에 /만 입력하면 지금 쓸 수 있는 명령·skill 목록이 화면에 뜹니다. 이 플러그인의 항목은 sodam-persona:로 시작합니다.

말투에 특정 단어를 섞으면 응답의 깊이가 자동으로 바뀝니다. 자세한 원리는 작동 방법에서 설명합니다.

터미널에서 세션 밖에 직접 실행하는 스크립팅용 명령도 있습니다: claude plugin install sodam-persona@sodam-persona, claude plugin marketplace update sodam-persona 등(claude plugin 다음에 동일한 하위 명령을 붙이면 됨).

이 절은 페르소나가 실제로 "어떤 규칙으로 판단하는지"를 설명합니다. 코드를 직접 읽지 않아도 이해할 수 있도록 정리했습니다.

모든 요청은 아래 4단계 중 하나로 분류되어 응답의 깊이가 결정됩니다.

사용자의 말 속 특정 단어(트리거)를 감지하면, 아래 6가지 효과 중 해당하는 것이 자동으로 발동합니다. 하나의 트리거가 여러 효과를 동시에 낼 수 있습니다.

1. 강도 상승 — "깊게", "철저히", "확실히" 등 → L1에서 L2·L3로
2. 강도 하강 — "간단히", "짧게", "한 줄로" 등 → 다른 모든 효과보다 항상 우선
3. 추가 skill 활성화 — persona-triggers / persona-format / persona-safety
4. 도메인 전문가 활성화 — 투자·돈 → #13, 법률·약관 → #11, 회계·세무 → #14, 마케팅·세일즈 → #15
5. 단일 관점 전면 활성화 — "보안" 단독 → #2, "디자인"/"UI" 단독 → #7, "UX" 단독 → #8, "테스트" 단독 → #4, "AI"/"에이전트"/"MCP" 단독 → #6
6. 근거 제시 모드 (강도는 그대로 두고) — "근거", "출처", "사례", "팩트" 등 → 실제 근거를 제시하고 추측과 사실을 구분해서 표기

이 트리거 단어들은 20개의 패턴 그룹(A~T)으로 정리되어 있으며, 자세한 단어 목록과 충돌 시 우선순위는 persona-triggers skill에 전부 정리되어 있습니다. 우선순위 요약: 분량 제약(간단히 등) > 강도(깊게 등) > 도메인 전문가 > 단일 관점 > 추가 skill.

L1 이상의 모든 응답에서, 아래 15개 관점 중 그 작업과 관련 있는 3~5개를 짧게라도 내부적으로 검토한 뒤 답합니다(트리거 단어가 없어도 자동 적용됩니다). L0 잡담이나 "간단히"류 요청에는 적용되지 않습니다.

위 15개 관점 중 #11·#13·#14·#15는 전용 skill을 따로 갖고 있어, 관련 트리거가 감지되면 훨씬 깊은 지식이 추가로 로드됩니다.

• 전문 투자자(#13, persona-investor): "이게 실패하면 사용자가 돈을 잃는가?"를 항상 자문. 체결 거부·슬리피지·부분 체결 같은 예외 상황, 페이퍼 모드/라이브 모드 구분, 백테스트 과최적화 경고를 다룹니다.
• 전문 변호사(#11, persona-lawyer): 감사 기록(audit log) 의무, 자본시장법 경계(투자자문업 표현 회피), 개인정보보호법·GDPR, 면책·동의 고지 표준을 다룹니다.
• 회계·세무 전문가(#14, persona-accountant): 신고 기한, 경비 처리 적격성, 절세와 탈세의 경계를 다룹니다. "일반 정보 제공용이며 실제 신고·납부 전 세무사·회계사 최종 확인을 권장한다"는 면책 문구를 반드시 포함합니다.
• 마케팅·세일즈 전문가(#15, persona-marketer): 포지셔닝·카피·전환율·SEO를 다루되, 과장·허위 광고 표현은 걸러냅니다.

여러 도메인이 동시에 걸리면(예: "이 투자수익 세금과 법적 리스크") 관련된 도메인 전문가가 모두 함께 활성화됩니다.

1. 데이터 없는 추측을 사실처럼 말하지 않는다 — 가설은 "가능성"으로, 확인된 것은 "확인됨"으로 구분해 표기
2. 직전 답변과 이유 없이 뒤집지 않는다 — 결정을 바꿀 때는 새로운 근거와 바뀐 이유를 함께 제시
3. 사용자의 표면적 말보다 진짜 의도를 먼저 살핀다 — "이 기능 빼자"가 "이 기능이 제대로 작동하길 원한다"는 뜻일 가능성을 먼저 검토
4. 추측보다 직접 확인할 수 있는 데이터(로그·파일)를 우선한다

파일·폴더 삭제, git 강제 푸시, 데이터베이스 변경, 배포, 결제, 외부 메시지 발송 같은 작업은 자동으로 실행하지 않고 항상 먼저 확인을 구합니다. 이는 보안과 데이터 흐름에서 더 자세히 설명합니다.

1. Claude Code 세션 시작
       │
       ▼
2. SessionStart hook 실행 (inject-core.js)
   → persona_core.md 전문을 세션 컨텍스트에 주입 (매 세션 최초 1회)
       │
       ▼
3. 사용자가 메시지 입력
       │
       ▼
4. UserPromptSubmit hook 실행 (inject-marker.js)
   → persona_marker.txt 압축 요약을 매번 주입
   → 대화가 길어지거나(compaction) 서브에이전트를 거친 뒤에도 페르소나를 즉시 복구하는 역할
       │
       ▼
5. Claude Code가 주입된 규칙 + 사용자 발화를 함께 해석
   → 응답 강도(L0~L3) 판정, 트리거 단어 매칭
       │
       ▼
6. 조건에 맞는 skill 조건부 로드
   (persona-triggers / persona-format / persona-safety / 도메인 4종 중 해당하는 것)
       │
       ▼
7. L2·L3는 7단계 응답 형식(복기 → 근본 원인 → 추천 방향 → 실행 순서 →
   검증 방법 → 주의사항 → 다음 작업)을 따라 답변 구성
       │
       ▼
8. 응답 전 자가 검증 체크리스트 통과 확인 후 전달

1. /sodam-persona:persona-create 호출
       │
       ▼
2. 인터뷰 진행 (한 번에 한 질문)
   - 전문 분야, 영문 슬러그, 책임 영역, 면책 필요 여부
       │
       ▼
3. 트리거 단어 15~30개 자동 생성 → 사용자 확인
       │
       ▼
4. 확정 후 최대 8곳의 파일을 동시에 동기화 편집
   (persona-triggers/SKILL.md, persona_core.md, persona_marker.txt,
    새 skill 폴더, persona-format/SKILL.md, reference 문서 2개,
    README.md/README.en.md, validate.mjs)
       │
       ▼
5. node validate.mjs 실행 → ✅ PASS 나올 때까지 반복 수정
       │
       ▼
6. 설치 캐시 재반영 안내 (marketplace update → uninstall → install → /reload-plugins)
       │
       ▼
7. 변경된 파일만 정확히 지정해 git add → conventional commit
   (실제 push·PR·merge는 사용자의 명시적 승인 없이 실행하지 않음)

/sodam-persona:persona-edit도 대상이 기본 관점(표 한 줄만) 또는 도메인 페르소나(최대 4~5곳)로 다르지만, 편집 후 검증(4단계) → 안내(5단계) 흐름은 동일합니다.

Claude Code의 "플러그인"은 다음 4가지 요소로 이루어진 하나의 묶음입니다.

• 마켓플레이스(marketplace): 플러그인이 어디서 왔는지 알려주는 목록 파일(marketplace.json이라는 이름의 파일). "GitHub 저장소"이거나 "내 컴퓨터의 폴더 경로"일 수 있습니다.
• 매니페스트(manifest): 플러그인의 이름·버전·설명이 담긴 파일(plugin.json이라는 이름의 파일).
• hook: 특정 시점(세션 시작 등)에 자동으로 실행되는 작은 프로그램.
• skill: 특정 상황에서만 조건부로 불러오는 지식 문서.

.
├── .claude-plugin/marketplace.json       # Claude Code가 실제로 읽는 마켓플레이스 정의 (정본)
├── .github/workflows/validate.yml        # CI: push/PR마다 validate.mjs 자동 실행
├── LICENSE                               # Apache License 2.0 전문
├── NOTICE                                # 저작권·상표·제3자 인용 고지
├── README.md                             # 이 문서 (한국어, 정본)
├── README.en.md                          # 이 문서의 영어판 (정본, 내용 동일)
├── README.html / README.en.html          # 위 두 문서를 build-docs.mjs로 변환한 HTML (내용 동일)
├── build-docs.mjs                        # README(.md) → README(.html) 재생성 스크립트
├── doc-theme.html                        # 위 스크립트가 쓰는 HTML 테마(CSS)
├── validate.mjs                          # 정합성 자동 검사기
└── plugins/sodam-persona/                # 실제로 배포·설치되는 플러그인 본체
    ├── .claude-plugin/plugin.json        # 플러그인 매니페스트 (정본)
    ├── hooks/
    │   ├── hooks.json                    # SessionStart / UserPromptSubmit hook 등록표
    │   ├── inject-core.js                # SessionStart 시 실행되는 스크립트
    │   ├── inject-marker.js              # UserPromptSubmit 시 실행되는 스크립트
    │   ├── persona_core.md               # 세션 시작 시 주입되는 페르소나 코어 본문
    │   └── persona_marker.txt            # 매 입력마다 주입되는 압축 마커
    ├── skills/
    │   ├── persona-format/SKILL.md       # L2/L3 응답 형식
    │   ├── persona-safety/SKILL.md       # 보안 always-on, 비가역 작업 게이트
    │   ├── persona-triggers/SKILL.md     # 트리거 단어 A~T 상세, 15개 관점 매핑표
    │   ├── persona-investor/SKILL.md     # #13 전문 투자자 도메인
    │   ├── persona-lawyer/SKILL.md       # #11 전문 변호사 도메인
    │   ├── persona-accountant/SKILL.md   # #14 회계·세무 전문가 도메인
    │   ├── persona-marketer/SKILL.md     # #15 마케팅·세일즈 전문가 도메인
    │   ├── persona-create/SKILL.md       # 새 페르소나 생성 인터뷰 진입점
    │   └── persona-edit/SKILL.md         # 트리거 편집 인터뷰 진입점
    ├── commands/
    │   ├── create.md                     # persona-create가 읽어 수행하는 절차 본문
    │   └── edit.md                       # persona-edit이 읽어 수행하는 절차 본문
    └── reference/
        ├── persona_full_core.md          # 페르소나 풀 정의(L3 전면 활성/세션 복구용)
        └── test_scenarios.md             # 트리거 동작 검증용 발화 시나리오 모음

commands/ 폴더는 persona-create/persona-edit skill이 읽어서 수행하는 절차 원문을 담고 있습니다.

새 관점을 추가하거나 트리거를 바꿀 때 숫자가 어긋나는 것("드리프트")을 기계적으로 막기 위한 검사기입니다. 외부 라이브러리 없이 Node.js 내장 기능만 사용합니다.

실행 방법과 결과 읽는 법은 명령어와 문제와 오류 대처 방법을 참고하세요.

.github/workflows/validate.yml이 main 브랜치로의 push와 모든 Pull Request마다 node validate.mjs를 자동으로 실행해, 위 15가지 검사를 통과하지 못한 변경이 main에 들어오지 못하도록 막습니다.

Claude Code는 플러그인과 마켓플레이스를 사용자 권한으로 코드를 실행할 수 있는 고신뢰 구성요소로 취급하며, 설치 시점에 출처를 신뢰하는지 확인합니다. 이 절차는 Claude Code 플랫폼 자체의 안전장치이며, 이 플러그인이 임의로 건너뛸 수 없습니다.

이 페르소나는 삭제·배포·강제 푸시·외부 발송 같은 되돌릴 수 없는 작업 앞에서 "자동 실행하지 말고 먼저 사용자에게 확인하라"는 응답 습관과 판단 기준을 Claude Code에게 지시합니다. 다만 이는 파일 시스템 접근을 물리적으로 차단하는 장치가 아니라, Claude Code가 원래 갖고 있는 승인·권한 체계(도구 사용 권한 프롬프트 등) 위에 "이럴 땐 반드시 멈춰서 물어봐라"는 규칙을 얹는 것입니다. 실제 최종 실행 권한과 승인 절차는 항상 Claude Code 플랫폼 자체의 정책을 따릅니다.

사용자가 입력한 문장
        +
플러그인이 주입한 페르소나 규칙 텍스트(로컬 파일에서 읽은 것)
        │
        ▼
Claude Code가 사용하는 AI 모델(Claude)로 대화 맥락 전송
   (이는 이 플러그인 유무와 무관하게, Claude Code를 쓰는 이상 항상 발생하는
    Claude Code 자체의 정상적인 동작 방식입니다)
        │
        ▼
응답 생성 후 사용자에게 반환

이 플러그인 자체는 자신만의 서버나 원격 저장소로 아무것도 전송하지 않습니다. 개인정보를 수집하거나, 사용 기록을 원격으로 남기거나, 별도 분석(텔레메트리)을 수행하지 않습니다. 다만 Claude Code를 사용하는 이상 대화 내용이 Claude Code가 연동한 AI 모델 제공자(Anthropic)에게 전달되는 것은 이 플러그인과 무관하게 항상 발생하는 일이며, 그 처리 방침은 Anthropic의 공식 개인정보처리방침을 따릅니다.

• API 키·비밀번호·토큰 같은 민감정보가 코드나 대화에 등장하면 즉시 경고하도록 설계되어 있습니다.
• 민감정보 노출 점검 대상 범위: 코드, GitHub, 로그, 화면 출력, 문서, 커밋 기록, 오류 메시지.
• 회계·세무·법률 도메인처럼 개인정보·재무정보를 다루는 응답에는 별도의 면책 문구가 강제됩니다.

validate.mjs의 검사 10번은 이 저장소의 문서와 플러그인 파일에 개발자의 실제 사용자 계정 이름이 포함된 개인 컴퓨터 경로가 실수로 남아 공개 저장소에 노출되는 것을 자동으로 잡아냅니다. 이 문서를 포함한 모든 배포 문서는 이 검사를 통과한 상태로 유지됩니다.

이 표에 없는 폴더(예: 개발 중 생긴 로컬 캐시·메모 파일)는 .gitignore에 등록되어 저장소에 포함되지 않으며, 이 플러그인을 새로 내려받는 사용자에게는 존재하지 않는 파일이므로 이 문서에서 다루지 않습니다.

날짜가 최신인 항목이 위에 오도록 정리했습니다. 항목을 클릭(또는 탭)하면 세부 내용이 펼쳐집니다.

Q. 이 플러그인은 무료인가요? A. 네. Apache License 2.0으로 공개된 무료 오픈소스이며, 개인·상업적 용도 모두 사용할 수 있습니다. 자세한 조건은 법률, 저작권, 라이선스, 상업적 용도를 확인하세요.

Q. 제 컴퓨터 파일을 마음대로 지우거나 고치나요? A. 아니요. 이 플러그인의 hook은 플러그인 폴더 안 고정된 텍스트 파일 2개를 읽는 것 외에는 아무 파일도 쓰거나 지우지 않습니다. 삭제·배포처럼 되돌릴 수 없는 작업은 항상 사용자에게 먼저 확인을 구하도록 설계되어 있습니다. 자세히는 보안과 데이터 흐름 참고.

Q. 인터넷 연결이 꼭 필요한가요? A. Claude Code 자체가 AI 모델과 통신하기 위해 인터넷이 필요합니다. 다만 이 플러그인의 hook 자체는 로컬 파일만 읽을 뿐 별도로 인터넷에 접속하지 않습니다.

Q. 회계·세무나 법률 답변을 실제 전문가 상담 대신 써도 되나요? A. 아니요. 이 페르소나는 실제 자격을 갖춘 세무사·회계사·변호사가 아닙니다. 참고용 정보 제공이 목적이며, 실행성 있는 판단(신고·계약 해석 등) 전에는 반드시 실제 전문가의 확인을 받아야 합니다. 답변에도 이 점이 면책 문구로 항상 함께 표시됩니다.

Q. Codex에서도 쓸 수 있나요? A. 아니요. Codex 지원은 별도 저장소에서 독립적으로 관리되고 있으며, 이 저장소는 Claude Code 전용으로 관리됩니다. Codex를 쓰신다면 별도 저장소를 확인해 주세요.

Q. 여러 대의 컴퓨터에 설치해도 되나요? A. 네. 이 플러그인은 자기완결적으로 설계되어 별도 개인 설정 파일이나 메모리 없이도, 새 컴퓨터에서 설치만 하면 동일하게 동작합니다.

Q. 트리거 단어를 제가 원하는 대로 추가하거나 바꾸고 싶어요. A. /sodam-persona:persona-edit(기존 관점 편집) 또는 /sodam-persona:persona-create(완전히 새로운 전문 분야 추가)를 호출해 인터뷰 형식으로 진행하면 됩니다. 사용 방법과 워크플로우 참고.

Q. 페르소나가 대답을 너무 길게/무겁게 해요. A. "간단히", "짧게", "핵심만" 같은 단어를 말에 섞으면 그 즉시 짧은 형식으로 전환됩니다. 이 규칙은 다른 모든 규칙보다 우선순위가 가장 높습니다.

Q. 반대로 훨씬 더 깊고 꼼꼼하게 봐주면 좋겠어요. A. "객관적으로", "깊게", "철저히", "페르소나 풀버전" 같은 표현을 사용하면 15명 관점 전원이 검토에 들어갑니다.

Q. 오작동이나 버그를 발견했어요. 어디에 알리면 되나요? A. 저장소의 GitHub Issue 기능으로 신고해 주세요. 재현 가능한 발화 예시를 함께 적어주시면 원인 파악이 빨라집니다.

Q. 이 플러그인의 코드를 가져다 제 상업용 제품에 넣어도 되나요? A. 네, Apache License 2.0이 이를 명시적으로 허용합니다. 다만 라이선스·저작권 고지 사본 포함, 수정한 파일에 변경 사실 명시 같은 몇 가지 조건이 있습니다. 법률, 저작권, 라이선스, 상업적 용도에서 조건을 확인하세요. 이 안내는 참고용 요약이며 법률 자문이 아닙니다.

Q. 이 플러그인은 Anthropic이 만든 공식 기능인가요? A. 아니요. 이 프로젝트는 Anthropic과 아무런 제휴·후원 관계가 없는 독립적인 커뮤니티 플러그인입니다. "Claude"와 "Claude Code"는 각 소유자의 상표이며, 이 문서에서는 그 제품을 가리키기 위한 목적으로만 이름을 사용했습니다.

Q. 세션이 오래돼서 대화가 정리(compaction)되거나 서브에이전트를 거치면 페르소나가 사라지나요? A. 아니요. UserPromptSubmit hook이 매 입력마다 압축된 마커를 다시 주입하도록 설계되어 있어, 그런 상황에서도 페르소나가 자동으로 복구됩니다.

아래 내용은 이해를 돕기 위한 요약입니다. 법률 자문이 아니며, 법적 효력을 갖는 원문은 저장소의 LICENSE와 NOTICE 파일입니다. 상업적으로 재배포하거나 법적 판단이 필요한 상황이라면 독립적인 법률 검토를 받으시길 권장합니다(이는 NOTICE 파일에 명시된 안내이기도 합니다).

• 저작권자: Copyright 2026 SoDam AI Studio
• 원문 위치: 저장소 루트 LICENSE 파일

Apache License 2.0은 아래 4가지를 명시적으로 허용합니다.

대신 아래 조건을 반드시 지켜야 합니다.

그리고 아래는 보장되지 않는다는 점을 분명히 알려드립니다(원문 제7·8조 요약).

• 이 소프트웨어는 "있는 그대로(AS IS)" 제공되며, 상품성이나 특정 목적 적합성을 포함해 어떠한 형태의 보증도 하지 않습니다.
• 이 소프트웨어의 사용으로 발생하는 어떠한 손해(영업 손실, 작업 중단, 컴퓨터 고장 등 포함)에 대해서도 저작권자와 기여자는 책임지지 않습니다.
• 사용 및 재배포의 적합성을 판단하고 그에 따른 위험을 부담하는 것은 전적으로 사용자의 책임입니다.

• 이 프로젝트는 아래 개념을 짧은 인용구 형태로만 참조하며, 해당 개념을 자신의 언어로 다시 구현했을 뿐 제3자의 소스 코드를 포함하거나 재배포하지 않습니다.
  • "Chesterton's Fence"(체스터턴의 울타리) — G. K. Chesterton에게 귀속되는 개념
  • "Hyrum's Law"(하이럼의 법칙) — Hyrum Wright에게 귀속되는 격언
  • Goal-Driven Execution(목표 지향 실행) — Andrej Karpathy에게 귀속되는 짧은 문구

이 문서와 프로젝트에서 언급하는 "Claude", "Claude Code", "Anthropic", "Codex", "OpenAI", "GitHub", "Node.js" 등의 제품·회사명은 각 소유자의 상표 또는 등록상표입니다. 이 프로젝트는 이들 중 어느 누구와도 제휴·후원·승인 관계가 없는 독립적인 프로젝트이며, 위 이름들은 오직 해당 제품을 가리키기 위한 목적으로만(명목적 사용) 사용되었습니다.

이 플러그인의 전문 투자자(#13)·전문 변호사(#11)·회계·세무 전문가(#14)·마케팅·세일즈 전문가(#15) 페르소나는 실제 자격을 갖춘 전문가가 아니라 Claude Code의 AI 응답 스타일을 조정하는 소프트웨어 설정입니다.

• 투자·거래 관련 응답은 투자 자문이 아니며, 실제 투자 결정과 그 결과에 대한 책임은 전적으로 사용자에게 있습니다.
• 법률 관련 응답은 법률 자문이 아니며, 실제 법적 효력을 보장하지 않습니다. 계약·규제·컴플라이언스 판단 전에는 변호사의 확인을 받아야 합니다.
• 회계·세무 관련 응답은 일반 정보 제공용이며, 실제 신고·납부 전에는 반드시 세무사·회계사의 최종 확인을 받아야 합니다.
• 마케팅 관련 응답에서 과장·허위 광고에 해당할 수 있는 표현은 걸러내려 하지만, 실제 배포 전 표시·광고 관련 법규 준수 여부는 사용자가 직접 검토해야 합니다.

• 이 플러그인은 Claude Code의 응답 스타일을 조정할 뿐, Claude Code가 실제로 만들어내는 코드·문서·설명 등 AI 생성물의 저작권 상태를 보장하거나 대신 판단해주지 않습니다.
• AI가 생성한 결과물을 상업적 제품·서비스·납품물에 포함하기 전에는 아래를 사용자가 직접 확인해야 합니다.
  • 그 결과물이 기존 저작물과 실질적으로 유사하지 않은지(저작권 침해 가능성)
  • 사용한 AI 서비스(Claude Code/Anthropic 등)의 이용약관이 그 결과물의 상업적 이용을 허용하는지
  • 결과물이 참조했을 수 있는 오픈소스 코드의 라이선스 조건과 충돌하지 않는지
• 이 플러그인의 규칙 문서 자체도 AI 코딩 도구를 이용한 반복 작업 과정에서 작성·정리되었습니다. 라이선스(Apache License 2.0)의 효력에는 영향이 없지만 참고로 밝혀둡니다.

이 플러그인은 Claude Code라는 외부 플랫폼 위에서 동작하는 설정 모음일 뿐이며, Claude Code/Anthropic의 요금제·모델 이용 정책·서비스 약관을 대신 안내하거나 보장하지 않습니다. 아래 항목은 이 문서가 아니라 해당 서비스의 공식 채널에서 직접 확인하세요.

• Claude Code/Anthropic의 요금제와 사용량 제한
• 모델 사용 정책(허용/금지되는 사용 사례)
• Claude Code/Anthropic의 서비스 약관 및 개인정보처리방침
• 상업적 서비스에서 Claude 응답을 재판매·재사용할 때 별도 조건이 있는지 여부

이 저장소를 코드·문서 전체 기준으로 점검한 결과(2026-08-09 기준)입니다.

즉 이 플러그인은 코드·문서 텍스트만으로 이루어져 있어, 이미지·폰트·서드파티 패키지 라이선스로 인한 상업적 사용 제약이 현재 시점에는 존재하지 않습니다. 다만 이후 이미지·의존성이 추가되면 이 표는 다시 점검이 필요합니다.

왕초보를 위한 한 줄 정리: 그대로 쓰기·고쳐 쓰기·복제(포크)·재배포·판매·서비스 운영·교육 자료 활용·고객사 납품까지 전부 가능합니다. 다만 "SoDam" 브랜드 자체를 내 것처럼 사칭하는 것만은 안 됩니다.

• "SoDam"·"sodam-ai" 브랜드명을 자신이 만든 것처럼 사칭해 배포하는 것
• 라이선스 사본과 NOTICE 고지 없이 수정본을 재배포하는 것
• 회계·세무·법률·투자 도메인 페르소나의 답변만 믿고, 실제 전문가 확인 없이 신고·계약·투자 결정을 내리는 것
• Claude Code가 생성한 결과물에 포함될 수 있는 제3자 저작물을, 출처 확인 없이 그대로 상업적으로 재사용하는 것

궁금한 개별 상황이 있다면 저장소의 LICENSE·NOTICE 원문을 직접 확인하시고, 확신이 서지 않는 상업적 재배포 건은 변호사와 상의하시길 권장합니다.