SoDam Persona Codex — AI skill for Claude Code

SoDam Persona for Codex

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

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

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

**지금 버전**: `1.1.1` · **관점 수**: 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가지가 준비되어 있는지 확인하세요. 하나라도 없으면 [필요 프로그램](#필요-프로그램)에서 설치 방법을 안내합니다.

#	준비물	왜 필요한가	없으면
1	Codex CLI(터미널에서 쓰는 버전) 또는 Codex 데스크톱 앱, 또는 Codex가 연결된 IDE(코드 편집기) 확장	이 플러그인은 Codex "안"에서 동작하는 부가 기능이라, Codex 자체가 먼저 있어야 합니다	플러그인을 설치할 대상이 없어 진행 불가
2	Node.js 18 이상	hook 2개와 검증 스크립트(validate.mjs)가 JavaScript로 작성되어 Node.js가 실행 엔진 역할을 합니다	hook이 실행되지 않아 페르소나가 전혀 동작하지 않음
3	Git(GitHub에서 설치할 경우에만 필요)	codex plugin marketplace add sodam-ai/SoDam-Persona처럼 GitHub 주소로 설치할 때 Codex 내부적으로 저장소를 내려받는 데 사용	로컬 저장소 설치 방식으로 대체 가능(Git 없이도 가능)
4	터미널(명령어를 글자로 입력해 컴퓨터에 지시하는 검은 화면 프로그램) 사용 경험 아주 조금	설치 명령을 한 줄씩 입력하고 Enter를 누르는 정도만 할 수 있으면 충분	이 문서의 실행 방법에서 터미널 여는 법부터 설명

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

**계정*