Skip to content
Conduit

skill

SoDam-Persona-Codex

OpenAI Codex용 한국어 페르소나 플러그인. 45개 역할·39개 스킬, 의도 기반 관점 선택, Windows 훅, 설치 무결성 진단·행동 시험 및 한·영 사용 가이드를 제공합니다.

sodam-ai/SoDam-Persona-Codexcommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/sodam-ai/SoDam-Persona-Codex itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 21, 2026

SoDam Persona for Codex

처음 사용하는 분의 최단 경로

쉬운 시작 안내에서 설치 → 새 대화 → 관점 표시 → 진단 순서로 확인하세요. 개발·시험·배포 기준은 개발 안내를 따릅니다.

  • 45개 역할과 39개 스킬을 유지하고 전문 지침의 공통 정본·활성 기준을 통일했습니다.
  • 법률·투자 표현 치환 지침과 모든 행위 기록·특정 OS 보호 방식의 일괄 강제를 실제 과업 조건에 맞게 정리했습니다. 법률 해석은 법무/전문가 검토 필요입니다.
  • 개인 업무 선호를 공개 공통 규칙과 분리했습니다. 기존 사용자의 승인된 선호를 취소하지 않습니다.
  • 진단은 JSON 등록 정보·정확한 버전·설치 캐시 SHA-256·설치 훅 출력을 검사합니다. 내용이 다르면 설치 코드를 실행하지 않습니다.
  • 270개 사례를 실제 Codex 새 대화로 실행하는 시험 명령을 추가했습니다. 역할 선택과 답변 품질을 구분하고, 품질은 사람이 실제 답변을 검토해야 합니다.
  • node check-docs.mjs가 MD/HTML 본문 및 한·영 제목 구조를 검사합니다. 번역 의미·화면 품질의 자동 보장은 아닙니다.
  • 이 소스는 로컬 후보입니다. 자동 시험 53개와 후보 지침을 직접 제공한 전체 행동 시험을 수행했습니다. 전체 재시험 최초 CLI 실패 2개는 별도 재실행 통과했으나 원인은 미확인입니다. 마지막 마케팅 수정 후 관련 6개 사례를 추가 확인했습니다. Desktop 자동 훅·모든 답변의 전문 정확성·공개 배포 완료는 주장하지 않습니다. 실제 검증 기록을 확인하세요.

적용 관점 표시

일반 자연어 응답 첫 줄에 [페르소나: L2 · CAD·BIM 정보 정합성 관점]처럼 실제 적용 관점을 반드시 표시합니다. 진행 안내와 최종 답변에 각각 표시하고, 전문 관점이 없으면 실제 L단계와 전문 관점 미적용을 표시합니다. 짧은 답변도 생략하지 않습니다. 사용자 지정 JSON·코드 전용 출력 또는 표시 금지 지시는 우선합니다. 표시 자체는 도구 실행이나 작업 성공의 증거가 아닙니다. 현재 대화에 이미 주입된 지침은 파일 수정으로 바뀌지 않으므로 새 대화에서 확인하세요.

현재 반영 상태 (2026-10-09)

이 저장소는 원본 sodam-ai/SoDam-Persona를 Codex 전용으로 포팅한 sodam-ai/SoDam-Persona-Codex의 작업 소스입니다. 현재 1.11.2·45개 관점·39개 스킬·2개 훅이며 생성/편집 스킬과 compat/ 호환 매니페스트를 보존합니다. 추가 관점 표시 의무와 진단 보완의 소스 검사는 통과했지만 설치본 버전 불일치와 실제 Desktop 전체 흐름은 해결/검증되지 않았습니다. 추가 수정은 이 문서가 포함된 커밋 기준으로 확인하세요. 버전 문자열만으로 파일 일치를 보장하지 않습니다. SoDam-Agent 전용 팀 규칙은 포함하지 않습니다.

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

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

이 플러그인 자체는 별도의 AI가 아닙니다. Codex가 이미 갖고 있는 대화 능력 위에 "이렇게 판단하고 이렇게 답하라"는 규칙 문서를 자동으로 얹어주는 설정 모음입니다. Codex가 해당 이벤트를 전달할 때 실행되도록 설정된 hook(후크 — 특정 시점에 실행되는 작은 프로그램) 2개와, 상황에 맞을 때 불러오는 전문 지식 모음(skill, 스킬) 39개로 이루어져 있습니다. 설치·권한·환경에 따라 실제 자동 실행 여부를 확인해야 합니다.

이 소스의 버전: 1.11.2 · 관점 수: 45개 · 활성 기준: 의도 기반(단어만으로 선택하지 않음) · 스킬 수: 39개 · hook 수: 2개 · 라이선스: Apache License 2.0

설치 전 확인: 기본 GitHub 설치와 ZIP 다운로드는 기본 브랜치의 현재 내용을 가져옵니다. 이 문서를 보는 브랜치와 기본 브랜치의 버전이 다를 수 있으므로 설치 후 실제 플러그인 버전을 확인하세요. 별도 작업 브랜치를 시험하려면 아래 시험용 설치 절을 따르세요. Git 브랜치 반영은 Release 생성이나 기존 설치본의 자동 업데이트가 아닙니다.

목차

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

사전 준비물

설치 전에 읽는 왕초보 안내

이 문서는 원본 프로젝트의 Codex 포팅 소스 기준입니다. 문서·파일이 있음 → 설치됨 → 활성화됨 → 훅이 실행됨 → 실제 답변이 맞음은 각각 다른 확인 단계입니다. 폴더를 다른 곳으로 옮기거나 PC를 다시 켠 것만으로 후보가 설치되지 않습니다.

  1. Windows 시작 메뉴에서 PowerShell을 찾아 엽니다. 명령 블록에는 한 줄씩 입력하고 Enter를 누릅니다. 코드 블록의 세 개짜리 백틱과 설명 문장은 입력하지 않습니다.
  2. Node.js·Git이 없다면 아래 공식 다운로드에서 운영체제에 맞는 설치 파일을 받습니다. Node.js는 지원 중인 LTS, Git은 운영체제에 맞는 설치 프로그램을 선택합니다. 설치 프로그램을 실행한 뒤 PowerShell을 다시 열고 버전을 확인합니다.
  3. Codex가 없다면 공식 CLI/앱 안내의 현재 설치 방법을 따르고 계정으로 로그인합니다. 이 문서가 새 계정·무료 이용·설치 권한을 제공하지는 않습니다. CLI 명령과 앱 화면에서 쓰는 대화는 구분하세요.
  4. 명령어는 PowerShell에, “도면을 검토해줘” 같은 요청과 $persona-...는 Codex 대화 입력칸에 씁니다. 브라우저 주소창·메신저·일반 ChatGPT 대화에 플러그인 설치 명령을 넣어도 설치되지 않습니다.
  5. 휴대전화로 README를 읽을 수 있지만 이 프로젝트는 모바일 앱이 아닙니다. 휴대전화·메신저에 독립 설치하는 명령은 제공하지 않습니다. 실제 지원은 사용하는 Codex 호스트에서 확인하세요.
쉬운 뜻이 문서에서 쓰는 용어
프로그램을 실행하는 글자 명령 창터미널 / PowerShell
원본 코드와 문서가 모인 폴더저장소 / 프로젝트 최상위
Codex에 규칙을 추가하는 묶음플러그인
정해진 시점에 실행되는 작은 프로그램훅(hook)
특정 요청에 적용하는 전문 지침스킬(skill)
검사 결과가 통과했는지 표시한 값PASS 또는 종료코드 0; 모든 실사용 성공을 보장하지 않음

가장 짧은 설치·실행 순서

일반 사용자는 프로젝트 개발·시험 프로그램을 먼저 실행할 필요가 없습니다. PowerShell에 아래 명령을 한 줄씩 입력합니다. codex plugin --help에서 설치 명령이 없으면 공식 Codex 업데이트와 조직 정책을 먼저 확인합니다.

node --version
codex --version
codex plugin --help
git --version
codex plugin marketplace add sodam-ai/SoDam-Persona-Codex
codex plugin add sodam-persona@sodam-persona
codex plugin list
codex

GitHub 명령은 공개 기본 브랜치의 배포본을 설치합니다. 이미 등록된 출처가 있거나 오류가 나오면 아래 설치·오류 절을 먼저 읽습니다. 최신 로컬 후보를 시험하려면 위 명령을 반복하기 전에 로컬 설치 절을 따릅니다. 설치 후 새 빈 Codex 대화에 다음 문장을 입력합니다.

도면과 BIM 모델의 치수·단위·개정 불일치를 어떤 순서로 검토할지 설명해줘. 파일은 수정하지 마.

정상 기대: 응답 첫 줄에 실제 적용 관점이 있고 본문이 단위·개정 비교를 설명합니다. 실제 파일을 제공하지 않았는데 “검토 완료”라고 하면 잘못된 응답입니다. 표시만 나오고 본문이 요청과 다르거나 설치 진단이 실패하면 사용 검증 완료로 판단하지 않습니다.

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

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

환경 기준: Windows·macOS·Linux에서 Codex 플러그인과 Node.js를 사용할 수 있어야 합니다. 현재 실제 검증은 Windows / Codex CLI 0.160.1 / Node.js 26.7.0 / Pandoc 3.7.0.2입니다. CI 설정은 Ubuntu / Node.js 20이며 원격 CI 실행은 미확인입니다. Node.js 18 및 모든 앱·IDE·운영체제 조합을 시험한 것은 아닙니다. 새 설치는 Node.js 공식 다운로드의 지원 중인 LTS 버전을 사용하고 해당 환경에서 검사하세요. 명령 예시는 PowerShell 기준입니다.

v1.10.2 검증 기록(2026-09-23, Windows): v1.10.2 소스에서 정합성 검사, hook·검증기 자동 테스트 총 22건, 공식 플러그인 구조 검사, 격리된 임시 환경의 설치·직접 hook 실행, 한·영 HTML 재생성과 Chrome 화면·콘솔 검사가 통과했습니다. 기존 개인 설치본 갱신이나 일반 자연어 요청에서 hook 자동 호출까지 입증한 것은 아닙니다.

이전 v1.10.2 시험의 미확인 범위: 당시 개인 설치본은 v1.10.1이었습니다. 일반 자연어 요청에서 v1.10.2 hook 자동 호출, macOS/Linux 실기기, 모든 Codex 앱·IDE 조합은 미검증입니다. CI·브라우저 검사도 해당 커밋과 환경에 한정됩니다. 설치 확인을 각 환경에서 진행하세요.

계정과 권한: Codex를 쓰기 위한 OpenAI 계정·이용 권한은 이 플러그인과 별도로 준비해야 합니다. 조직용 계정은 관리자가 플러그인 설치를 제한할 수 있습니다. 이 플러그인은 계정을 만들거나 로그인·결제·조직 권한을 대신 처리하지 않습니다.

필요 프로그램

아래 표 순서대로 준비하고 각 단계의 확인 명령이 성공하는지 확인하세요. 이미 설치되어 있다면 버전 확인 명령으로 점검만 하고 넘어가세요.

프로그램최소 버전다운로드설치 확인 명령
Codex CLI / 데스크톱 앱플러그인 명령 지원 필요; CLI 0.160.1에서 검증공식 CLI 설치 안내, 공식 앱 안내codex --version, codex plugin --help (CLI)
Node.js20 이상 권장Node.js 공식 다운로드 (지원 중인 LTS 권장)node --version
Git최신 버전 (GitHub 설치 시에만)Git 공식 다운로드git --version
Pandoc (문서 편집자만, 선택)최신 버전Pandoc 공식 설치pandoc --version
  • Codex CLI/데스크톱 앱은 이 플러그인을 "실행할 무대"입니다. 반드시 먼저 설치·로그인까지 끝내주세요.
  • Node.js는 일반 사용자에게도 필수입니다(hook 실행용). 설치 후 터미널을 새로 열어야 node 명령이 인식됩니다.
  • Git은 GitHub에서 설치하는 경우에만 필요합니다. 이 저장소를 이미 폴더로 갖고 있고 로컬 설치만 할 것이라면 없어도 됩니다.
  • Pandoc은 이 플러그인을 "사용"하는 데는 전혀 필요 없습니다. README.md 문서 내용을 고쳐서 README.html을 다시 만들 사람만 설치하면 됩니다.

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

node --version
git --version

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

환경 변수 안내

일반 사용을 위해 이 프로젝트에 API 키·.env를 만들 필요는 없습니다. 두 훅은 process.env를 읽지 않으며 ${PLUGIN_ROOT}는 호스트가 제공하는 설치 경로입니다. 개발용 diagnose.mjs는 CODEX_HOME 또는 --home으로 검사할 홈을 지정하고, evaluate.mjs는 Codex CLI를 호출해 호스트의 인증·사용량을 사용합니다. 홈은 설정·캐시가 있는 폴더이며 프로젝트 폴더와 다릅니다. CODEX_HOME이 설정되어 있으면 기본 CLI 홈보다 우선합니다. 다른 플러그인이나 모델 제공자의 키 요구는 별도이며, 키를 README·Git·평가 기록에 적지 마세요.

다운로드 방법

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

방법 A — GitHub에서 곧바로 설치 (다운로드 단계 없음, 권장)

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

방법 B — 저장소를 내 컴퓨터에 먼저 내려받은 뒤 로컬 설치

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

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

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

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

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

설치 방법

GitHub에서 설치 (권장)

터미널을 열고 아래 두 줄을 순서대로 입력합니다(각 줄 입력 후 Enter).

codex plugin marketplace add sodam-ai/SoDam-Persona-Codex
codex plugin add sodam-persona@sodam-persona
  • 1번째 줄: "이 GitHub 저장소를 플러그인 후보 목록(마켓플레이스, marketplace)에 등록해줘"라는 뜻.
  • 2번째 줄: "등록된 후보 중 sodam-persona 플러그인을 실제로 설치해줘"라는 뜻. sodam-persona@sodam-persona에서 @ 앞은 플러그인 이름, 뒤는 그 플러그인이 속한 마켓플레이스 이름입니다(이 저장소는 둘 다 sodam-persona로 같습니다).

로컬 저장소에서 설치

다운로드 방법의 방법 B로 저장소를 이미 내려받았다면, 그 폴더(저장소 루트) 안에서 터미널을 열고 아래를 입력합니다.

codex plugin marketplace add .
codex plugin add sodam-persona@sodam-persona

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

현재 로컬 후보를 시험하는 방법

이 로컬 후보를 시험하려면 먼저 실제 대상 폴더에 최상위 README와 .claude-plugin/marketplace.json이 있는지 확인하고 위 로컬 설치 명령을 사용합니다. 등록명이 같은 기존 마켓플레이스가 있다면 codex plugin marketplace list로 출처를 확인하세요. 다른 출처를 덮어쓰기 위해 곧바로 제거하지 말고 개인 수정·설정과 원본을 먼저 보존합니다. GitHub 기본 브랜치 설치는 미커밋 로컬 후보를 가져오지 않습니다. 공개 저장소의 브랜치·버전·커밋 확인과 설치 후 진단은 별도입니다. 이 문서 작성으로 전역 설치본을 갱신하지 않았습니다.

설치 뒤 권한·신뢰 확인

설치만으로는 아직 끝난 것이 아닙니다.

  1. 새 Codex task(작업 세션)를 시작합니다.
  2. 설치·hook 실행·연결 권한을 묻는 화면이 나타나면, 표시된 플러그인 이름과 실행 내용을 읽습니다.
  3. sodam-persona가 맞고 node로 이 플러그인의 hooks/inject-*.js를 실행하는 내용인지 확인한 뒤 허용합니다.
  4. 계정·조직·Codex 버전에 따라 확인 화면의 문구나 표시 시점이 다르거나 별도 화면이 없을 수 있습니다. 조직 정책으로 설치가 막히면 관리자 승인이 필요합니다.

이 플러그인은 Codex의 권한 절차를 우회하지 않습니다. 실제 실행 권한은 사용 중인 Codex의 보안 정책이 결정합니다(보안과 데이터 흐름 참고).

설치 확인

codex plugin marketplace list
codex plugin list

첫 번째 명령은 등록된 마켓플레이스 목록을, 두 번째 명령은 설치된 플러그인 목록을 보여줍니다. 출처·버전·활성 상태를 확인하고 node diagnose.mjs로 후보와 설치 파일을 비교하세요. 이어서 새 대화에서 위 CAD/BIM 예제를 입력해 관점 표시, 요청에 맞는 본문, 확인하지 않은 파일을 확인했다고 말하지 않는지 점검합니다. 목록이나 표시만으로 자동 훅 실행·모든 기능의 정상 작동이 입증되지는 않습니다.

업데이트와 제거

새 버전으로 바꿀 때는 아래 순서를 지키세요. 설치 캐시 때문에 마켓플레이스만 갱신하고 끝내면 기존 플러그인 파일이 계속 쓰일 수 있습니다.

codex plugin marketplace upgrade sodam-persona
codex plugin remove sodam-persona@sodam-persona
codex plugin add sodam-persona@sodam-persona

업데이트 뒤에는 기존 task를 계속 쓰지 말고 새 task를 시작합니다. 완전히 제거하려면 마지막 add를 실행하지 말고, 필요할 때 codex plugin marketplace remove sodam-persona로 마켓플레이스 등록도 지웁니다. 제거 명령은 플러그인 캐시를 삭제하므로 필요한 사용자 수정본이 있다면 먼저 별도 폴더에 복사하세요.

빠른 시작 방법

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

  1. 터미널을 연다.
  2. codex plugin marketplace add sodam-ai/SoDam-Persona-Codex 입력 후 Enter.
  3. codex plugin add sodam-persona@sodam-persona 입력 후 Enter.
  4. 새 Codex task를 시작한다. 권한·신뢰 확인 창이 뜨면 플러그인 이름과 실행 명령을 확인하고 허용을 누른다.
  5. 그냥 평소처럼 한국어로 말을 건다. 예: 이 코드에서 버그 찾아줘 — 특별한 명령어를 외울 필요 없이 자연어(사람이 평소 쓰는 말) 그대로 사용하면 페르소나가 자동으로 판단해서 반응합니다.

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

실행 방법

플러그인만 따로 실행하는 사용자 앱은 없습니다. Codex에서 설치·활성 상태와 실행 권한을 갖춘 뒤 호스트가 해당 이벤트를 전달하면 훅이 지침을 주입하도록 설계되어 있습니다. CLI·Desktop·IDE가 같은 설치 홈·파일·훅을 사용한다고 가정하지 말고 각 환경에서 진단과 새 대화의 실제 응답을 확인하세요.

터미널에서 Codex CLI로 실행

  1. 터미널(윈도우는 PowerShell 또는 명령 프롬프트, macOS는 Terminal 앱)을 연다.
  2. codex라고 입력하고 Enter를 누른다(정확한 실행 명령은 설치한 Codex CLI 버전의 공식 안내를 따른다).
  3. 새 task에서 설치·활성·권한과 SessionStart 이벤트 전달이 갖춰지면 훅이 코어를 주입합니다. 실제 답변을 확인하고 자동 훅을 확인하지 못했으면 미검증으로 남깁니다.

Codex 데스크톱 앱으로 실행

  1. 설치된 Codex 앱 아이콘을 실행한다.
  2. 새 대화(작업)를 시작한다.
  3. 앱의 실제 설치본과 권한을 확인하고 새 대화에서 관점 표시·본문을 시험합니다. CLI 설치 성공만으로 앱 자동 훅 실행을 보장하지 않습니다.

IDE(코드 편집기) 확장으로 실행

IDE 안에서 Codex 패널을 열고 새 세션을 시작합니다. 해당 확장이 이 플러그인 구조·훅 이벤트를 지원하는지 확인해야 하며, 모든 IDE 조합은 미검증입니다.

터미널을 처음 쓰는 분을 위한 아주 기본적인 안내 (Windows 기준)

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

사용 방법

아무것도 외우지 않고 쓰는 방법 (기본)

평소 Codex에게 말하듯 한국어로 자연스럽게 요청하면 됩니다. hook이 활성화된 세션에서는 페르소나 코어가 자동으로 적용되고, 요청 내용이 특정 전문 skill의 설명과 맞으면 Codex가 해당 skill을 선택해 읽을 수 있습니다. 자동 선택은 모델과 요청 맥락의 영향을 받으므로 반드시 적용해야 하는 전문 분야는 아래처럼 $skill-name을 직접 적으세요.

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

특정 전문가 관점을 직접 지정하고 싶을 때

$ 뒤에 skill 이름을 붙여 명시적으로 부를 수 있습니다.

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

건축·인테리어 작업을 처음 요청하는 방법

건축·인테리어 분야에서는 “설계”, “디자인”, “모델링”, “렌더링”, “시공”이 서로 다른 결과물을 뜻합니다. 아래 표에서 가장 가까운 문장을 그대로 복사해 시작하면 됩니다.

이 문서의 “15년+”는 AI 페르소나가 취하는 전문가 관점의 기준입니다. 사용자가 15년 경력자라는 뜻이 아니며, 사용자의 설계·시공·견적 지식이나 Revit·Rhino 등 프로그램 숙련도를 자동으로 전문가 수준으로 가정하지 않습니다.

하고 싶은 작업처음 입력할 자연어 예시주도 역할과 확인 범위
건축 배치·법규·인허가·설계도서“이 대지에 가능한 건축 배치와 확인할 법규를 초보자도 알게 설명해줘”#16 건축 설계가 주도. 실제 법규·구조·소방·인허가는 해당 지역 자격자가 최종 확인
실내 동선·마감·천장·가구 상세“이 평면의 실내 동선과 마감 계획을 검토해줘”#17 인테리어 설계가 주도. 치수·성능·설비·시공 상세는 현장과 자격자가 확인
공법·공정·품질·하자“이 인테리어 공사를 어떤 순서로 시공하고 무엇을 검측해야 해?”#18 시공이 주도. 현장 실측·안전 계획·전문 공종 승인이 필요
물량·단가·공사비·VE“이 도면으로 견적을 만들려면 어떤 수량과 단가 자료가 필요해?”#19 견적이 주도. 지역·시점·브랜드·세금·운반·폐기 조건이 없으면 확정 금액을 단정하지 않음
건축과 인테리어 전체 방향 통합“외관과 실내의 디자인 언어와 재료 기준을 통일해줘”#20 디자인 디렉터가 주도하고 #23·#24가 검토
Revit·Rhino·BIM·3D 형상 작업“Revit 모델을 Rhino로 넘길 때 단위·좌표·형상 손실을 점검해줘”#21 3D 모델링이 주도. 프로그램 버전과 사용자의 도구별 숙련도를 먼저 확인
재질·조명·카메라·렌더 품질“이 실내 장면을 D5로 렌더하려면 재질·조명·카메라를 어떻게 잡아야 해?”#22 렌더링·시각화가 주도. 렌더 이미지는 승인 도면이나 시공 기준이 아님
건축 콘셉트·매스·파사드“이 대지에 맞는 건축 매스와 파사드 대안 3개를 제안해줘”#23 건축 디자인이 주도하고, 법규·인허가 영향은 #16이 검토
인테리어 분위기·재료·색채·가구“카페 인테리어 무드와 재료 팔레트 대안 3개를 제안해줘”#24 인테리어 디자인이 주도하고, 상세·성능·설비 영향은 #17이 검토
도면 종류를 아직 모름“첨부한 도면으로 무엇을 확인할 수 있는지, 필요한 다음 도면이 무엇인지 알려줘”AB 도면 라우팅이 도면 종류·목적을 먼저 확인한 뒤 #16~#24 중 주도 1개와 검토 역할을 선택

처음 요청할 때 아래 정보를 가능한 만큼 함께 주면 답변 정확도가 높아집니다.

  1. 프로젝트 종류와 용도: 주택, 카페, 사무실, 전시장 등
  2. 현재 단계: 아이디어, 기본설계, 실시설계, 견적, 시공, 준공 중 어디인지
  3. 대상 지역: 국가·도시와 적용해야 할 법규 관할
  4. 원본 자료: 대지 정보, 치수, 사진, 도면, 모델, 표제란, 최신 파일 버전
  5. 원하는 결과물: 설명, 체크리스트, 디자인 대안, 도면 검토, 모델링 순서, 렌더 설정 등
  6. 사용하는 프로그램과 버전: Revit, Rhino, 3ds Max, Blender, SketchUp, Cinema 4D, D5, Twinmotion, Unreal, Unity 등
  7. 프로그램별 본인 숙련도: 처음 사용, 기초, 중급, 실무 사용 중 하나
  8. 예산·일정·현장 제약과 아직 확인되지 않은 조건

자료가 부족하면 페르소나는 확인된 사실과 가정을 분리하고 필요한 질문을 먼저 해야 합니다. 이미지·3D 모델·렌더는 의사결정 자료이며, 허가도서·구조 계산·소방 설계·제작도·시공도·확정 견적을 대신하지 않습니다.

이미지·영상 작업을 처음 요청하는 방법

이미지와 영상은 아이디어·제작·편집·검수가 서로 다른 단계입니다. “이미지”나 “영상”만 말하면 목적을 한 번 확인하며, 원하는 결과를 구체적으로 적으면 해당 역할이 바로 작동합니다.

하고 싶은 작업자연어 요청 예시주도 역할
이미지 생성·합성·보정“이 렌더 이미지를 원본은 보존하면서 합성하고 4K로 업스케일해줘”#32. 3D 장면 설정 변경은 #22 협업
영상 콘셉트·스토리보드·샷“카페 워크스루 영상의 30초 스토리보드와 카메라 동선을 짜줘”#33. 3D 모델·렌더는 #21+#22 협업
컷·자막·음향·색보정·출력“이 영상을 세로형 숏폼으로 편집하고 자막·음량·출력 사양을 맞춰줘”#34
실제 품질·출처·권리 확인“이미지와 영상을 실제로 검수하고 음원·폰트·모델의 상업적 이용 근거를 정리해줘”#35, 법률 판단은 #11 협업

처음 요청할 때 목적·플랫폼·화면비·크기 또는 길이·FPS·원본·유지할 요소·사용 프로그램과 버전·프로그램별 숙련도·마감·권리 상태를 가능한 만큼 알려주세요. 3D 시각화 경력만으로 이미지·영상 프로그램 전체를 전문가 수준으로 가정하지 않습니다. 생성·내보내기 성공과 실제 화면·소리 검수도 구분합니다.

생성형 AI 도구·플랫폼 작업을 처음 요청하는 방법

로컬에서 실행되는 ComfyUI와 인터넷 서비스인 Midjourney·Higgsfield·Runway는 필요한 정보와 위험이 다릅니다. 제품명만 말하면 작업 목적을 확인하며, 아래처럼 요청하면 알맞은 역할이 바로 작동합니다.

하고 싶은 작업자연어 요청 예시주도 역할
ComfyUI 설치·실행·오류·워크플로우“기존 워크플로우는 보존하고 ComfyUI CUDA 오류를 로그부터 진단해줘”#36
노드·체크포인트·LoRA·VAE·API·VRAM“이 워크플로우의 누락 노드와 모델 경로를 확인하고 VRAM 사용을 줄여줘”#36
Midjourney·Higgsfield·Runway 기능·비용 비교“공식 자료 기준으로 영상 기능·플랜·크레딧을 날짜와 함께 비교해줘”#37, 비용은 #12 협업
외부 플랫폼 업로드·권리·보안 확인“고객 이미지를 올리기 전에 데이터 처리와 상업 이용 조건을 검토해줘”#37+#2+#35, 법률 판단은 #11
실제 이미지·영상 생성과 검수“ComfyUI에서 이미지를 생성하고 실제 출력까지 확대 검수해줘”#36+#32+#35

로컬 도구는 운영체제·GPU·VRAM·프로그램·Python·CUDA·PyTorch·노드·모델 버전을, 외부 플랫폼은 계정·플랜·잔여 크레딧·업로드 허용 자료·공식 확인 날짜를 가능한 만큼 알려주세요. 설치됨·서버 도달·워크플로우 로드·생성 성공·파일 존재·실제 결과 검수·권리 확인은 서로 다른 상태입니다.

두 페르소나의 15년+는 디지털 콘텐츠·CG·자동화 경험을 포함한 전문 판단의 깊이입니다. ComfyUI·Midjourney·Higgsfield 같은 개별 제품을 15년 사용했다는 의미로 표현하지 않습니다.

사용 가능한 skill 목록 확인

지원하는 Codex 화면에서는 /skills 또는 $로 사용 가능한 스킬을 확인합니다. 지원 여부와 호출 이름은 호스트·버전·설치 상태에 따라 확인하세요. 목록 화면이 없으면 PowerShell에서 codex plugin list로 설치 상태를 확인하고 새 대화에서 실제 응답을 시험합니다.

응답 강도를 내가 직접 조절하고 싶을 때

원하는 답변 길이와 검토 범위를 명확히 요청하세요. 단어 하나만으로 특정 단계나 모든 역할이 자동 선택되지는 않습니다. 관련 관점·요청 범위·실제 위험도를 함께 판단하는 원리는 작동 방법에서 설명합니다. 형식 생략 요청은 응답 형식을 바꾸는 것이며 설치된 플러그인을 제거하는 명령은 아닙니다.

원하는 것이렇게 말하면 됨
아주 짧고 간단한 답"간단히", "짧게", "핵심만"
관련 전문가 관점을 깊게 검토"객관적으로", "깊게", "철저히"
페르소나 형식 없이 자유롭게"그냥 답해", "페르소나 끄고"
관련 관점을 종합하여 깊게 검토"페르소나 풀버전"

명령어

Codex 플러그인 관리 명령 (터미널에 입력)

명령설명
codex plugin marketplace add <출처>마켓플레이스(플러그인 후보 목록)에 등록. <출처>는 sodam-ai/SoDam-Persona-Codex처럼 GitHub 저장소 이름이거나 .처럼 로컬 폴더 경로
codex plugin marketplace list등록된 마켓플레이스 목록 확인
codex plugin marketplace upgrade sodam-persona마켓플레이스에 등록된 소스를 최신 상태로 갱신
codex plugin add sodam-persona@sodam-persona실제로 플러그인을 설치
codex plugin list현재 설치된 플러그인 목록 확인
codex plugin remove sodam-persona@sodam-persona플러그인 제거

페르소나 skill 호출 (Codex 대화창에 입력)

명령설명
/skills 또는 $이 기능을 지원하는 Codex 화면에서 지금 쓸 수 있는 skill 목록 보기. 표시되지 않으면 codex plugin list로 설치를 먼저 확인
$persona-investor <내용>전문 투자자 관점(#13) 명시 호출
$persona-lawyer <내용>전문 변호사 관점(#11) 명시 호출
$persona-accountant <내용>회계·세무 전문가 관점(#14) 명시 호출
$persona-marketer <내용>마케팅·세일즈 전문가 관점(#15) 명시 호출
$persona-architectural-designer <내용>법규·인허가·배치·도면 중심 건축 설계 관점(#16)
$persona-interior-designer <내용>동선·마감·조명·상세 중심 인테리어 설계 관점(#17)
$persona-construction-expert <내용>공법·공정·품질·안전·하자 중심 시공 관점(#18)
$persona-cost-estimator <내용>물량·단가·공사비·VE 중심 견적 관점(#19)
$persona-design-director <내용>건축·인테리어 통합·일관성·승인 기준 관점(#20)
$persona-spatial-3d-modeling-expert <내용>Revit·Rhino·BIM·형상·좌표·파일 변환 중심 3D 모델링 관점(#21)
$persona-rendering-visualization-expert <내용>재질·조명·카메라·D5·Twinmotion·Unreal·Unity 중심 렌더링 관점(#22)
$persona-architectural-design-expert <내용>콘셉트·매스·형태·파사드·외장재 중심 건축 디자인 관점(#23)
$persona-interior-design-expert <내용>분위기·색채·재료·조명·가구 구성 중심 인테리어 디자인 관점(#24)
$persona-source-verification-expert <내용>외부 자료 검색·공식 원문·최신성·출처 신뢰도 검증 관점(#25)
$persona-research-analyst <내용>조사 설계·비교·종합·불확실성 분석 관점(#26)
$persona-ideation-strategist <내용>아이디어 발산·평가·선별·실험 설계 관점(#27)
$persona-project-manager <내용>범위·일정·예산·자원·위험·의존성·납품 관리 관점(#28)
$persona-product-owner <내용>사용자 가치·제품 목표·로드맵·백로그·우선순위 관점(#29)
$persona-pmo-governance-expert <내용>표준·단계 승인·보고·포트폴리오·변경 통제 관점(#30)
$persona-project-analyst-coordinator <내용>회의·결정·액션·요구사항·상태 데이터 추적 관점(#31)
$persona-image-production-expert <내용>이미지 생성·보정·합성·배경 제거·업스케일 관점(#32)
$persona-video-production-director <내용>영상 콘셉트·스토리보드·샷·카메라·생성 관점(#33)
$persona-video-post-production-expert <내용>컷·자막·음향·색보정·인코딩 관점(#34)
$persona-media-quality-rights-reviewer <내용>이미지·영상 품질·출처·동의·라이선스 검수 관점(#35)
$persona-generative-ai-workflow-engineer <내용>ComfyUI형 로컬 도구·워크플로우·노드·모델·CUDA·VRAM·API·복구 관점(#36)
$persona-generative-ai-platform-operator <내용>Midjourney·Higgsfield·Runway형 외부 플랫폼 기능·계정·크레딧·업로드·출력 관점(#37)
$persona-agent-harness-expert <내용>AI 에이전트 지시·훅·스킬 충돌·오발동 검토(#38)
$persona-system-integration-expert <내용>Desktop·CLI·MCP·플러그인·외부 프로그램 연결 검증(#39)
$persona-acceptance-evidence-expert <내용>완료 주장·수용 기준·실제 증거 검증(#40)
$persona-context-handoff-expert <내용>여러 PC·AI·대화의 결정·승인·작업 인계(#41)
$persona-cad-bim-consistency-expert <내용>건축 도면·BIM·표의 치수·단위·개정 정합성(#42)
$persona-design-construction-integration-expert <내용>설계 변경의 시공·간섭·물량·비용·일정 영향(#43)
$persona-archviz-business-creative-expert <내용>건축시각화의 공간 가치·홍보·사업 제안(#44)
$persona-domain-automation-productization-expert <내용>건축·콘텐츠 반복 업무의 스크립트·CLI·MCP·앱 제품화(#45)
$persona-create인터뷰 방식으로 새 도메인 페르소나를 추가. 실제 등록부의 다음 번호 사용(현재 #46)
$persona-edit인터뷰 방식으로 기존 페르소나의 트리거 단어 추가·수정·제거

문서/코드 편집자 전용 명령 (저장소 루트에서 실행)

명령설명
node validate.mjs관점 ID·이름, 스킬 메타데이터·참조, 버전, 훅 형식, 개인 경로 노출과 스크립트 문법 등 정합성 자동 검사
node --test test-hooks.mjs두 hook의 정상·빈·잘못된·2 MiB 입력과 원문 누락·공백 복구 동작 검사
node --test test-validator.mjs등록부·버전·배선·크기·개인 경로·폴더명 오류를 검증기가 실제로 차단하는지 검사
node diagnose.mjsJSON 등록 정보·정확한 버전·설치 캐시 파일 해시·설치 훅·소스 정합성의 읽기 전용 진단
node check-docs.mjs한·영 MD/HTML 본문과 제목·토글 구조 비교; 번역 의미·화면 품질은 별도 검토
node evaluate.mjs --list라우팅 270개와 형식 2개의 시험 ID 목록 표시; 실제 AI 호출은 하지 않음
node evaluate.mjs --execute --case R42-positive --out ./evaluation-results/run-01새 임시 CLI 대화의 실제 후보 시험; 인증·사용량 필요, 같은 결과 파일 덮어쓰기 금지
node build-docs.mjsREADME.md/README.en.md를 다시 읽어 README.html/README.en.html을 재생성(Pandoc 필요)

작동 방법

v6는 답변 길이·작업 범위·검토 깊이·실제 위험도를 각각 판단합니다. 짧은 보고 요청은 승인된 전체 검증 범위를 줄이지 않습니다. 깊게·확실·버그라는 단어만으로 위험 작업이나 추가 승인으로 분류하지 않습니다.

공통 판단 정본은 plugins/sodam-persona/reference/operating_contract.md, 분야 상세는 plugins/sodam-persona/reference/domain_routing.md입니다. 기존 37개와 신규 8개를 포함한 45개는 역할 목록이며 주도 역할과 관련 검토만 선택합니다. 내부 관점 전환은 독립 전문가 검증이 아닙니다.

L0는 단순 조회, L1은 설명·의견, L2는 구현·검토, L3는 실제 비용·외부 공개·손실·비가역 위험입니다. 사용자 지시와 상위 지시를 우선하며 명시적 제외·중단·보존을 숨은 의도로 뒤집지 않습니다. 승인 범위의 가역적인 작업은 지속하고 새로운 위험·범위 확대·도구별 쓰기 게이트는 확인합니다.

도구는 선택→호출→적용→출력 확인으로 검증합니다. 문서·빌드·실사용, 미디어 생성·기술 검사·실제 시청/청취·판매 품질을 구분합니다. 완료는 요구사항별 증거와 미검증 범위로 보고합니다. 실패를 숨기거나 검증을 무력화하지 않습니다.

신규 역할

  • #38 AI 에이전트 하네스·지시 체계 설계 전문가
  • #39 시스템 통합·실행 환경 검증 전문가
  • #40 완료 증거·수용 기준 검증 전문가
  • #41 작업 맥락·결정 이력·AI 인수인계 전문가
  • #42 CAD·BIM 도면 체계·설계정보 정합성 전문가
  • #43 설계·시공 통합 검토·변경 영향 전문가
  • #44 건축시각화 크리에이티브·사업 제안 전문가
  • #45 건축·콘텐츠 업무 자동화·도구 제품화 전문가

15년+는 전문 검토 수준이며 실제 경력이나 자격 증명이 아닙니다.

워크플로우

평소 대화의 흐름 (매 세션)

1. 설치·활성·권한·호스트 이벤트 지원 확인
   → 새 Codex 대화 시작
2. 호스트가 SessionStart 이벤트 전달
   → inject-core.js가 고정 코어 텍스트를 hook JSON으로 출력
3. 사용자 요청 입력 → 호스트가 UserPromptSubmit 이벤트 전달
   → inject-marker.js가 고정 마커 텍스트를 hook JSON으로 출력
4. Codex가 상위 지시·실제 요청 의도·명시적 제외를 함께 판단
   → 단어 매칭만으로 역할을 켜지 않음
5. 관련 주도·검토 역할과 필요한 스킬·도구 선택
   → 답변 길이·범위·검토 깊이·실제 위험을 독립 판단
6. 승인 범위에서 실행 → 실제 결과·실패·미검증 확인
7. 일반 자연어는 첫 줄에 실제 관점 표시
   → 결과·변경·검증·한계를 요청한 분량으로 보고; 7섹션 강제 없음

위 흐름은 설정의 의도이며 모든 호스트에서 자동 전달을 관측한 기록이 아닙니다. 긴 대화·compaction·서브에이전트 전달은 별도 미검증입니다. 관점 표시만으로 훅 자동 실행이나 도구 실행을 증명하지 않습니다.

건축·인테리어 작업의 권장 흐름

1. 입력 확인
   용도·지역·단계·치수·원본 파일·최신 버전·예산·일정·사용 프로그램을 확인
       │
       ▼
2. 주도 역할 선택
   기술 설계 #16/#17 · 시공 #18 · 견적 #19 · 통합 #20
   3D #21 · 렌더 #22 · 건축 디자인 #23 · 인테리어 디자인 #24
       │
       ▼
3. 대안과 판단 기준 작성
   디자인 작업은 보통 2~3개 대안, 장단점, 선택 기준, 적용 한계를 제시
       │
       ▼
4. 기술 교차 검토
   법규·구조·피난·방화·접근성·설비·재료 성능·시공성·예산 영향을 분리
       │
       ▼
5. 모델링·시각화 검증
   단위·좌표·형상·재질·조명·카메라·출력에서 설계 의도가 왜곡되지 않았는지 확인
       │
       ▼
6. 시공·견적 인계
   도면·시방·수량·단가·공정·검측·변경 사항과 미확정 조건을 기록
       │
       ▼
7. 자격자 최종 확인
   인허가·구조·소방·전기·기계설비·안전·계약·확정 공사비는 해당 자격자와 책임자가 승인

한 요청에서 주도 페르소나 1개와 검토 페르소나 최대 2개를 기본으로 사용합니다. 법규·안전에 필요한 전문가는 이 제한과 별도로 추가될 수 있습니다. “디자인”만 말해 건축·인테리어·통합 중 어느 분야인지 알 수 없으면 한 번 확인하고, 명확하면 #23 또는 #24를 바로 주도로 선택합니다.

작업 단계가 바뀔 때는 앞 단계의 결과물을 그대로 확정 자료로 간주하지 않습니다. 예를 들어 무드보드 → 마감표, 렌더 → 시공도, 3D 모델 → BIM 납품본, 개략 견적 → 계약 금액으로 넘어갈 때마다 필요한 치수·성능·속성·승인·가격 기준을 다시 확인합니다.

이미지·영상 작업의 권장 흐름

1. 목적·플랫폼·대상·완료 기준 확인
   → 2. 원본·출처·권리·프로그램·숙련도 확인
   → 3. 크기·비율·길이·FPS·코덱·오디오 사양 결정
   → 4. #32 이미지 또는 #33 영상 기획·제작
   → 5. #34 영상 후반작업
   → 6. #35 실제 화면·재생·소리·권리 검수
   → 7. 마스터·배포본·설정·출처·승인 기록 보관

파일 생성이나 내보내기 로그만으로 완성을 선언하지 않습니다. 이미지는 실제 결과를 확대 보기와 게시 크기로 확인하고, 영상은 전체 재생 또는 대표 프레임·오디오·메타데이터를 확인합니다. 확인하지 못한 항목은 미검수, 권리 근거가 없는 항목은 미확인으로 표시합니다.

생성형 AI 도구·플랫폼 작업의 권장 흐름

1. 목적·이미지/영상·완료 기준·공개/납품 위치 확인
   → 2. 로컬 도구(#36) 또는 외부 플랫폼(#37) 선택
   → 3. 환경·버전·계정·플랜·크레딧·업로드 허용 범위 확인
   → 4. 모델·노드·워크플로우 또는 플랫폼 모델·설정 준비
   → 5. 짧고 저비용인 대표 생성으로 먼저 검증
   → 6. 생성 실행·출력 파일·사양을 확인
   → 7. #32/#33/#34가 창작·편집 기준을 확인
   → 8. #35가 실제 화면·재생·출처·동의·라이선스를 검수
   → 9. 버전·설정·비용·출처·승인·복구 정보를 기록

ComfyUI 업데이트는 기존 워크플로우·모델·커스텀 노드와 복구 경로를 기록한 뒤 복사본에서 시험합니다. 외부 플랫폼은 기능·요금·정책을 공식 자료나 실제 계정 화면으로 확인하고 날짜를 기록합니다. API 키·세션·쿠키·결제 정보는 문서·프롬프트·워크플로우·스크린샷·저장소에 넣지 않습니다.

새 도메인 페르소나를 추가하는 흐름 ($persona-create)

1. $persona-create 호출
       │
       ▼
2. 인터뷰 진행 (한 번에 한 질문)
   - 전문 분야, 영문 슬러그, 책임 영역, 면책 필요 여부
       │
       ▼
3. 트리거 단어 15~30개 자동 생성 → 사용자 확인
       │
       ▼
4. 확정 후 관련 파일을 빠짐없이 함께 동기화 편집
   (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 upgrade → remove → add → 새 task)
       │
       ▼
7. 변경된 파일만 정확히 지정해 git add → conventional commit
   (실제 push·PR·merge는 사용자의 명시적 승인 없이 실행하지 않음)

$persona-edit는 기본 관점 한 줄 또는 도메인 페르소나의 트리거·코어·마커·전용 skill·문서·검증기를 필요한 범위만 수정합니다. 편집 뒤에는 같은 방식으로 정합성을 검사하고 설치 캐시 갱신 방법을 안내합니다.

아키텍처

플러그인 개념 이해하기

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

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

이 저장소가 Claude Code용 파일도 함께 갖고 있는 이유

이 프로젝트는 원래 Claude Code(다른 AI 코딩 도구)의 플러그인으로 시작했다가 Codex 전용으로 이식(porting)되었습니다. 그 흔적으로 plugins/sodam-persona/.claude-plugin/plugin.json과 루트의 .claude-plugin/marketplace.json이 남아 있지만, 이 둘은 이전 호스트와의 호환을 위한 것일 뿐 Codex 설치 과정에서는 전혀 사용되지 않습니다. Codex가 읽는 마켓플레이스 정의는 .agents/plugins/marketplace.json이며, 플러그인 매니페스트는 plugins/sodam-persona/.codex-plugin/plugin.json입니다. Agent Plugins 1.0 형식은 plugins/sodam-persona/compat/plugin.portable.json에 보존합니다. 플러그인 루트에 같은 이름의 매니페스트를 두면 현재 Codex에서 기본 hook 탐색이 건너뛰어질 수 있어 분리했습니다.

저장소 전체 구조

SoDam-Persona-Codex/
  .agents/plugins/marketplace.json
  .claude-plugin/marketplace.json
  .github/workflows/validate.yml
  .gitattributes
  .gitignore
  LICENSE
  NOTICE
  README.md
  README.en.md
  README.html
  README.en.html
  QUICKSTART.md
  QUICKSTART.en.md
  DEVELOPMENT.md
  DEVELOPMENT.en.md
  VERIFICATION.md
  VERIFICATION.en.md
  LEGAL_REVIEW.md
  LEGAL_REVIEW.en.md
  INTEGRATION_VERIFICATION.md
  build-docs.mjs
  doc-theme.html
  check-docs.mjs
  validate.mjs
  diagnose.mjs
  diagnose-core.mjs
  codex-launch.mjs
  evaluate.mjs
  test-hooks.mjs
  test-validator.mjs
  test-supplemental.mjs
  test-diagnose.mjs
  test-evaluate.mjs
  test-docs.mjs
  plugins/
    sodam-persona/
      .claude-plugin/
        plugin.json
      .codex-plugin/
        plugin.json
      commands/
        create.md
        edit.md
      compat/
        plugin.portable.json
      hooks/
        hooks.json
        inject-core.js
        inject-marker.js
        persona_core.md
        persona_marker.txt
      persona-registry.json
      reference/
        built_environment_collaboration.md
        domain_routing.md
        generative_ai_tools_collaboration.md
        media_production_collaboration.md
        operating_contract.md
        persona_full_core.md
        role_activation_contract.md
        routing_cases_ko.json
        routing_cases.json
        test_scenarios.md
        user_preferences.example.md
      skills/
        persona-acceptance-evidence-expert/
          SKILL.md
        persona-accountant/
          SKILL.md
        persona-agent-harness-expert/
          SKILL.md
        persona-architectural-design-expert/
          SKILL.md
        persona-architectural-designer/
          SKILL.md
        persona-archviz-business-creative-expert/
          SKILL.md
        persona-cad-bim-consistency-expert/
          SKILL.md
        persona-construction-expert/
          SKILL.md
        persona-context-handoff-expert/
          SKILL.md
        persona-cost-estimator/
          SKILL.md
        persona-create/
          SKILL.md
        persona-design-construction-integration-expert/
          SKILL.md
        persona-design-director/
          SKILL.md
        persona-domain-automation-productization-expert/
          SKILL.md
        persona-edit/
          SKILL.md
        persona-format/
          SKILL.md
        persona-generative-ai-platform-operator/
          SKILL.md
        persona-generative-ai-workflow-engineer/
          SKILL.md
        persona-ideation-strategist/
          SKILL.md
        persona-image-production-expert/
          SKILL.md
        persona-interior-design-expert/
          SKILL.md
        persona-interior-designer/
          SKILL.md
        persona-investor/
          SKILL.md
        persona-lawyer/
          SKILL.md
        persona-marketer/
          SKILL.md
        persona-media-quality-rights-reviewer/
          SKILL.md
        persona-pmo-governance-expert/
          SKILL.md
        persona-product-owner/
          SKILL.md
        persona-project-analyst-coordinator/
          SKILL.md
        persona-project-manager/
          SKILL.md
        persona-rendering-visualization-expert/
          SKILL.md
        persona-research-analyst/
          SKILL.md
        persona-safety/
          SKILL.md
        persona-source-verification-expert/
          SKILL.md
        persona-spatial-3d-modeling-expert/
          SKILL.md
        persona-system-integration-expert/
          SKILL.md
        persona-triggers/
          SKILL.md
        persona-video-post-production-expert/
          SKILL.md
        persona-video-production-director/
          SKILL.md

commands/ 폴더는 v6 생성·편집 절차의 내부 참조입니다. Codex에서는 이를 직접 slash 명령으로 실행하지 않고, persona-create/persona-edit skill이 그 내용을 읽어서 수행합니다.

자동 정합성 검사 (validate.mjs)

v6 검사는 45개 역할 ID·이름, 34개 도메인 배선, 39개 스킬 메타데이터, 세 매니페스트 버전, 두 훅 명령·출력 형식·12000자 상한, Markdown 링크와 플러그인 상대 참조, JavaScript 문법, 개인 경로 및 주요 비밀정보 패턴을 검사합니다. 경로 조작 형식·심볼릭 링크·배포물의 비밀정보 파일도 차단합니다.

자동 검사는 의미상 면책의 충분성·모든 활성 발화·실제 권한 화면·사용자 흐름을 보장하지 않습니다. 도메인 경계와 행동 품질은 별도 시험하고 미확인 범위를 보고해야 합니다. 이전 v5의 A~AQ 표 파서는 v6 판단 정본에 적용하지 않습니다.

지속적 통합(CI)

.github/workflows/validate.yml은 main push와 Pull Request에서 정합성 검사·6개 테스트 파일·Pandoc 설치·MD/HTML 동기화 검사를 실행하도록 설정되어 있습니다. CI 실패가 병합을 차단하는지는 GitHub 브랜치 보호 규칙에 달려 있습니다.

보안과 데이터 흐름

hook이 하는 일 / 하지 않는 일

하는 일하지 않는 일
플러그인 폴더 안의 고정된 텍스트 파일(persona_core.md, persona_marker.txt) 읽기네트워크로 어디에도 접속하지 않음
읽은 내용을 정해진 JSON 형식으로 표준출력에 내보내기코드를 즉석에서 만들어 실행(eval)하지 않음
Codex가 stdin(표준입력)으로 보내는 hook 메타데이터를 끝까지 받은 뒤 응답(EPIPE 오류 방지 목적일 뿐, 그 내용을 저장하거나 활용하지 않음)외부 프로그램을 새로 실행하지 않음
어떤 파일도 쓰거나 지우지 않음
사용자 데이터를 수집하거나 어디로도 전송하지 않음

신뢰 승인 절차

플러그인의 설치·활성화·hook 실행 허용 여부는 Codex 버전, 사용 화면, 계정, 조직 정책이 결정합니다. 권한 확인 화면이 나타나면 플러그인 이름과 node 실행 대상을 확인한 뒤 승인하세요. 별도 화면이 없더라도 이 플러그인이 Codex 권한 체계를 우회하는 것은 아니며, 조직 정책이 차단한 기능을 스스로 켤 수 없습니다.

비가역 작업 게이트는 "행동 지침"이지 "시스템 방화벽"이 아님

이 페르소나는 현재 승인된 범위·원본 보존·비용·공개·손실 위험을 구분하는 응답 습관과 판단 기준을 Codex에게 제공합니다. 승인된 가역 작업은 진행하고, 새 위험·범위 확대·도구별 쓰기 게이트는 별도로 확인하도록 지시합니다. 다만 이는 파일 시스템 접근을 물리적으로 차단하는 장치가 아니라, Codex가 원래 갖고 있는 승인·권한 체계 위에 "이럴 땐 반드시 멈춰서 물어봐라"는 규칙을 얹는 것입니다. 실제 최종 실행 권한과 승인 절차는 항상 Codex 플랫폼 자체의 정책을 따릅니다.

데이터가 실제로 흘러가는 경로

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

런타임 훅에는 자체 서버·원격 저장소 전송이나 별도 분석(텔레메트리) 기능이 없습니다. Codex가 원격 모델을 사용하는 경우 대화와 제공된 자료가 해당 모델 제공자에게 전달될 수 있으며, 실제 처리는 호스트 설정과 제공자 정책을 확인해야 합니다. 개발용 실제 AI 평가도 Codex 인증·통신·사용량을 사용합니다. 로컬 훅의 동작과 Codex·외부 도구의 통신을 구분하고 비밀정보를 대화·평가 입력에 넣지 마세요.

개인정보·민감정보 보호 습관

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

자기 정합성 보안 장치

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

파일과 문서 위치

찾는 것위치
이 설명서(한국어)저장소 루트 README.md / README.html
이 설명서(영어)저장소 루트 README.en.md / README.en.html
라이선스 전문저장소 루트 LICENSE
저작권·상표·제3자 인용 고지저장소 루트 NOTICE
실제 설치되는 플러그인 본체plugins/sodam-persona/
hook 이벤트와 실행 명령 정의plugins/sodam-persona/hooks/hooks.json
SessionStart 실행 스크립트 / 코어 본문plugins/sodam-persona/hooks/inject-core.js, persona_core.md
UserPromptSubmit 실행 스크립트 / 압축 마커plugins/sodam-persona/hooks/inject-marker.js, persona_marker.txt
39개 skill 전체plugins/sodam-persona/skills/persona-*/SKILL.md
의도 기반 활성·제외 정본plugins/sodam-persona/reference/role_activation_contract.md, domain_routing.md
45개 역할·34개 도메인·39개 스킬 등록부plugins/sodam-persona/persona-registry.json
라우팅 예제 180개+한국어 보강 90개plugins/sodam-persona/reference/routing_cases.json, routing_cases_ko.json
라우팅 적용 스킬plugins/sodam-persona/skills/persona-triggers/SKILL.md
도메인 전문가 34종 상세plugins/sodam-persona/skills/ 아래 34개 도메인 persona-* 폴더
새 페르소나 생성/편집 절차 원문plugins/sodam-persona/commands/create.md, edit.md
초보자 시작·개발·검증·권리 안내최상위 QUICKSTART.md, DEVELOPMENT.md, VERIFICATION.md, LEGAL_REVIEW.md 및 각각의 .en.md
설치 환경 별도 기록최상위 INTEGRATION_VERIFICATION.md (기록 당시 범위; 현재 상태는 재진단)
정합성 검사 스크립트저장소 루트 validate.mjs
문서 HTML 재생성 스크립트저장소 루트 build-docs.mjs, doc-theme.html
Codex 마켓플레이스 정의(정본).agents/plugins/marketplace.json
Codex 매니페스트(정본)plugins/sodam-persona/.codex-plugin/plugin.json
Agent Plugins 1.0 보존본 / 이전 Claude 호환 매니페스트plugins/sodam-persona/compat/plugin.portable.json, .claude-plugin/plugin.json
수동·자동 시험 시나리오plugins/sodam-persona/reference/test_scenarios.md
CI(자동 검사) 설정.github/workflows/validate.yml

이 표는 공개 배포 구성의 안내입니다. 표에 없다는 이유만으로 파일이 자동 제외되지는 않습니다. 공개 전 git status --short, git ls-files, .gitignore로 실제 포함 파일을 확인하세요. 개인 캐시·메모·CHECKPOINT.md·평가 결과를 포함해 원본 폴더 전체를 무검토 ZIP으로 배포하지 마세요.

업데이트 내용 요약

  • Codex가 생성한 명령 스킬 2개는 원본으로 재구성한 바이트가 같을 때만 정상으로 인정하도록 진단을 수정했습니다. 알 수 없는 추가 파일이나 변조는 계속 실패 처리합니다.
  • 제품명 단독 활성·금융 분야 강제 협업·일반 구현의 잘못된 역할 인계·마케팅의 과도한 협업을 실제 요청 책임 기준으로 수정했습니다. 세무 기한과 보관 기간은 적용 관할·연도·사업 유형의 공식 근거가 필요합니다.
  • 자동 시험 53개, 전체 후보 행동 시험과 실패 재실행, 마지막 마케팅 사례 6개, 격리 설치 수명주기, 한·영 화면 검사를 기록했습니다. 전문 품질·Desktop 자동 실행은 별도 미확인입니다.
  • README의 과거 버전·시험 개수·환경 변수·설치 출처 설명을 갱신하고 영문 및 생성 HTML을 동기화했습니다. 과거 변경 요약은 역사 기록이며 현재 설치 상태를 뜻하지 않습니다.
  • 소스 수정·문서 생성·GitHub 반영·Release·전역 설치 업데이트는 서로 다른 단계입니다.
  • 진행 안내와 최종 답변 첫 줄에 실제 적용 관점을 표시하도록 지침을 보강했습니다. 미적용·사용자 출력 형식 우선·표시와 실행 증거의 구분을 유지합니다.
  • 누락된 diagnose.mjs를 기존 Codex 배포 코드와 동일하게 복원하고 루트 중복 매니페스트를 compat 보존 상태로 정리했습니다.
  • 이전 1.11.1 단계에서 자동 시험 35/35와 문서·화면 검증은 통과했지만 당시 설치본 1.11.0과 소스 1.11.1은 불일치했습니다. 실제 Desktop 전체 사용은 미확인입니다.
  • 한국어/영어 MD를 기준으로 HTML을 생성합니다. 이번 문서 수정은 설치·commit·push·Release 생성이 아닙니다.
  • 45개 관점·39개 스킬. 기존 생성·편집 스킬과 compat/ 호환 매니페스트 보존.
  • 활성·제외·책임 경계, 고정 입력 180개와 한국어 보강 입력 90개. 입력 수는 모델 실행 성공 수가 아님.
  • 로컬 자동 시험 35개 통과. 실제 설치된 CLI/Desktop 자동 선택은 미확인.
  • 언어별 Markdown에서 HTML 생성. 전역 설치·공개 배포·push 미실행.

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

  • Codex가 사용하는 매니페스트를 .codex-plugin/plugin.json으로 고정하고 Agent Plugins 1.0 파일은 compat/에 보존했습니다.
  • 두 hook에 Windows 전용 실행 명령과 30초 제한을 추가하고 정합성 검사에 해당 조건을 넣었습니다.
  • 설치·신뢰 승인·실제 자연어 요청에서의 자동 주입은 별도로 확인해야 합니다.
  • 실제 hook 실행 테스트와 검증기 실패 감지 테스트를 추가하고 CI에 연결했습니다.
  • persona-registry.json을 관점·패턴·도메인·버전·hook 상한의 구조화 정본으로 연결했습니다.
  • SessionStart 직렬화 출력을 14,153자에서 12,000자 미만으로 줄이고 검사 상한도 12,000자로 고정했습니다.
  • node diagnose.mjs로 소스와 설치본의 버전 차이, 활성 상태, hook 실행, 저장소 정합성을 한 번에 확인할 수 있습니다.
  • 배포 전 최종 점검에서 커밋된 HEAD만 별도 폴더에 풀어 전체 테스트·문서 빌드·플러그인 구조 검사를 다시 통과했고, 실제로 실행하지 못한 원격 CI와 브라우저 화면 검증은 완료된 것처럼 쓰지 않도록 문서를 바로잡았습니다.
  • Apache License 2.0 공식 원문 일치 여부, NOTICE의 제3자 문구, 외부 자산·의존성·민감정보를 다시 점검하고, 프로젝트 라이선스가 제3자 자료나 외부 AI 결과물의 권리까지 보장하지 않는다는 경계를 명확히 했습니다.
  • ComfyUI형 로컬 실행환경·워크플로우·노드·모델·CUDA·VRAM·API·복구를 담당하는 #36을 추가했습니다.
  • Midjourney·Higgsfield·Runway형 외부 플랫폼의 기능·계정·플랜·크레딧·업로드·다운로드를 담당하는 #37을 추가했습니다.
  • 제품명 단독 오작동, 허위 15년 제품 경력, 설치·큐 성공을 실제 품질 완료로 오인, 업데이트에 의한 기존 환경 파손, 외부 업로드·API 키·비용·권리 위험을 회귀 검사로 보호합니다.
  • 이미지 제작·편집(#32), 영상 제작·연출(#33), 영상 편집·후반작업(#34), 미디어 품질·권리 검수(#35)를 추가했습니다.
  • 3D 렌더 설정(#22), 렌더 결과 보정(#32), 워크스루 연출(#33), 영상 출력(#34), 실제 품질·권리 검수(#35)의 책임과 인계를 분리했습니다.
  • 단독 이미지·영상·렌더 오발동, 프로그램 숙련도 과대평가, 생성·내보내기 성공을 실제 검수로 오인하는 문제를 회귀 검사로 차단했습니다.
  • 프로젝트 매니저(#28), 프로덕트 매니저·프로덕트 오너(#29), PMO·프로젝트 거버넌스(#30), 프로젝트 분석·운영 코디네이터(#31)를 분리했습니다.
  • 기존 #9는 가벼운 기획·요구사항 라우터로 좁히고, AH~AK 패턴이 실행·제품·거버넌스·운영 책임을 구분하도록 연결했습니다.
  • PM·PO·PMO·PA 약어 단독 오작동, 건축 Project Architect 충돌, 근거 없는 완료율·일정·담당자 생성을 막는 회귀 검사를 추가했습니다.
  • 자료 검색·출처 검증(#25), 리서치·분석(#26), 아이디어·콘셉트 전략(#27)을 독립 페르소나로 추가했습니다.
  • 단순 검색, 비교 조사, 근거 기반 아이디어 작업이 각각 #25, #25+#26, #25+#26+#27로 조합되도록 AE~AG 트리거를 연결했습니다.
  • 파일·코드·UI·데이터베이스·SEO 검색, 감탄, IDE 언급으로 잘못 켜지는 상황을 제외하고 당시 전체 관점·패턴·스킬 수 정합성 검사를 보강했습니다.
  • 건축 디자인 전문가(#23)와 인테리어 디자인 전문가(#24)를 별도 추가했습니다.
  • #20 디자인 디렉터는 건축·인테리어 통합·일관성·승인 기준을 담당하도록 좁히고, 분야별 디자인 트리거를 AC·AD로 분리했습니다.
  • 설계(#16·#17), 디자인(#23·#24), 디렉션(#20), 모델링·렌더링(#21·#22)의 역할과 사용자 역량 보정·회귀 검사를 동기화했습니다.
  • 초보자용 요청 예시·실무 인계 워크플로우·13개 도메인 명령·오류 대응·FAQ를 v1.6.0 구조에 맞춰 보강했습니다.
  • 15년+가 페르소나의 검토 깊이라는 점을 명시하고, 사용자 숙련도로 오인하지 않도록 했습니다.
  • 사용자의 3D 시각화 업종 경험과 설계·시공·견적 입문 상태를 분리하고, Revit·Rhino를 포함한 프로그램별 숙련도는 별도로 판단합니다.
  • 설계·시공은 쉬운 설명부터 자격자 확인까지 단계화하고, 시각화 경력만으로 모든 3D 도구를 전문가 수준으로 가정하지 않도록 회귀 검사를 추가했습니다.
  • 도면 관련 작업, CAD/DWG와 평면·입면·단면·상세·시공도 요청을 감지하는 AB 패턴을 추가했습니다.
  • 건축·인테리어 설계, 시공, 견적, 3D 모델링으로 목적별 분기하고 비건축 도면과 자격자 업무 경계를 분리했습니다.
  • 당시 전체 관점·28패턴·16스킬과 hook·문서·검증기를 동기화했습니다.
  • Revit·Rhino를 포함한 15년+ 3D 모델링 전문가(#21)와 건축·인테리어 렌더링·시각화 전문가(#22)를 분리 추가했습니다.
  • 모델링/3D/쓰리디와 렌더링/랜더링/렌더/랜더 표현을 모두 지원하고, 데이터 모델링·웹 렌더링 오발동을 차단했습니다.
  • 다문자 패턴 ID(Z 다음 AA), 당시 전체 관점·27패턴·16스킬, 도구 상태 검증과 모델→렌더→시공·견적 인계 규칙을 동기화했습니다.
  • 건축 설계·인테리어 설계·시공·견적·디자인 디렉터를 15년+ 경력의 조건부 전문 관점으로 추가했습니다.
  • 공통 프로젝트 입력, 역할 인계, 충돌 우선순위, 동시 활성, 법정 자격 오인 방지를 built_environment_collaboration.md에 통합했습니다.
  • 당시 관점을 #20까지, 트리거 패턴을 Y까지, 스킬을 14개까지 확장하고 hook·문서·검증기를 동기화했습니다.
  • 원본의 silent-failure 경고, 저신호 트리거 정리, 도메인 트리거 동기화, 법률·투자·회계세무 면책, 복구용 풀 코어 보완, 채팅 활성 표시를 Codex 전용 구조에 맞춰 이식했습니다.
  • validate.mjs를 15개 검사로 확장해 Codex hook 변수·스크립트, 실제 직렬화 출력 상한, 도메인 트리거 드리프트, skill 폴더명 안전성을 자동 검증합니다.
  • Agent Plugins 1.0 루트 plugin.json을 정본으로 추가하고 .codex-plugin/plugin.json을 fallback으로 유지했습니다. 당시 세 매니페스트의 버전은 1.5.1으로 통일했습니다.
  • hook 주입 파일의 LF 고정 규칙을 추가했고, 기존 Codex 포트의 투자자 필수 면책과 보안 보강은 그대로 보존했습니다.
  • 배포 전 검증에서 훅 44개, 패키지 32개, 실패·경계값 16개 시나리오와 임시 Marketplace 설치본 실행을 통과했습니다.
  • README 다크 모드가 넓은 화면의 오른쪽에서 흰색으로 끊기던 문제를 수정하고 한국어·영문 HTML을 다시 생성했습니다.
  • 회계·세무(#14)·법률(#11) 도메인에만 있던 "실행성 답변 시 면책 문구 필수" 규칙이 투자자(#13, 매매·포지션·타이밍 판단)에는 없었던 것을 발견.
  • skills/persona-investor/SKILL.md에 필수 면책 조항 추가, validate.mjs의 면책 검사(7번)에 편입 — 적용 완료(node validate.mjs 통과 확인).
  • 당시에는 코어·마커의 #13 면책 강제와 legacy 매니페스트의 license 필드가 미반영 상태였습니다. 이 후속 항목은 2026-09-16 v1.3.0 동기화에서 모두 반영 완료되었고, 현재 validate.mjs가 회귀 여부를 검사합니다.
  • LICENSE(Apache License 2.0 공식 원문)·NOTICE(저작권자·제3자 인용·상표 고지)·이 문서의 법률, 저작권, 라이선스, 상업적 용도 섹션은 내용·구조 모두 이상 없음을 재확인.
  • 의존성 파일(package.json 등)·이미지·폰트·assets 폴더가 저장소 전체에서 0건인 것도 재확인 — 배포물에 포함된 제3자 패키지·자산은 발견되지 않음.
  • .agents/plugins/marketplace.json 신설 — Codex가 실제로 읽는 마켓플레이스 정의를 정식으로 분리.
  • 플러그인 버전 1.1.1로 갱신.
  • 이미 폐지된 GUIDE.md/GUIDE.en.md 문서를 가리키던 죽은 참조 2곳 제거.
  • persona-triggers/SKILL.md에 실수로 남아 있던 실제 개인 컴퓨터 경로 노출 제거.
  • validate.mjs에 검사 2종 신설: "문서 안 파일 참조가 실제로 존재하는가"(9번), "개인 절대경로가 노출되지 않았는가"(10번). 이후로는 같은 실수가 반복되면 CI가 자동으로 잡아냅니다.
  • $persona-create, $persona-edit 인터뷰형 skill 신설 — 코드를 몰라도 대화로 새 도메인 전문가를 추가하거나 기존 트리거 단어를 고칠 수 있게 됨.
  • 새 페르소나 이름(영문 슬러그) 입력값 검증 추가 — 잘못된 형식이 파일 경로에 그대로 쓰이는 것을 방지(경로 조작 위험 차단).
  • 기존에 별도 문서였던 "초보자 가이드(GUIDE)"를 폐지하고 이 README 한 곳으로 통합.
  • README.md/README.en.md를 고치면 README.html/README.en.html을 똑같이 재생성해주는 build-docs.mjs 스크립트 신설.
  • hook이 필요한 파일을 못 찾았을 때 프로그램이 거칠게 멈추는 대신, 조용히 정상 종료하도록 완화.

이 프로젝트에서 가장 큰 변화가 몰린 날입니다.

  • 관점 수를 13에서 14로(회계·세무 전문가 신설), 다시 당시 15번째 관점으로 마케팅·세일즈 전문가를 신설.
  • 회계·세무(#14)·법률(#11) 도메인에 고빈도 트리거 단어를 대폭 확충.
  • 기존 관점 5개에 트리거 단어를 보강(관점 수 자체는 변경 없음).
  • validate.mjs 정합성 검사기 최초 도입 + GitHub Actions(CI) 자동 실행 연동.
  • 회계·세무·법률 답변에 면책 문구가 누락되는 것을 실제 라이브 테스트에서 발견 → "항상 켜짐" 규칙으로 강제 격상.
  • 저장소 안에 남아 있던 개발자의 실제 컴퓨터 경로 노출 제거.
  • Apache License 2.0 라이선스와 NOTICE 파일 최초 추가(저작권자: SoDam AI Studio).
  • 한국어/영어 README·GUIDE 문서를 공개 배포용으로 전면 개편(설치법·아키텍처·보안 데이터 흐름·라이선스·상표 안내 추가).
  • 프로젝트 이름을 persona-plugin에서 sodam-persona로 통일.
  • 배포 대상이 아닌 내부 백로그 문서 4개를 .gitignore로 제외.
  • 배포·삭제·마이그레이션·머지·릴리스 같은 되돌릴 수 없는 작업을 감지해 자동 실행을 막고 사전 확인을 강제하는 트리거 패턴(R) 신설.
  • "완료라고 말하기 전에 실제 검증(실행·테스트·빌드)을 거쳤는가"를 확인하는 자가 검증 완료 게이트 추가.
  • 페르소나 v5를 Claude Code(당시 대상 플랫폼)용 플러그인 형태로 최초 패키징.
  • 초보자용 상세 README와 GUIDE 문서 최초 작성.
  • 근거·출처·증거를 요구하는 트리거 단어 29개(Q 패턴) 추가 — 추측을 사실처럼 말하지 않도록 하는 규율의 시작점.

이후 이 프로젝트는 Codex 전용으로 이식되어 지금의 SoDam Persona for Codex가 되었습니다.

문제와 오류 대처 방법

증상원인해결 방법
codex plugin marketplace add . 실행 시 실패저장소 루트 폴더가 아닌 다른 위치에서 실행했거나, .agents/plugins/marketplace.json이 없음저장소를 내려받은 폴더로 이동한 뒤(README.md가 보이는 위치) 다시 실행
업데이트하려는데 "Marketplace not found" 오류remove를 upgrade보다 먼저 실행해서 마켓플레이스 등록 자체가 사라짐반드시 upgrade → remove → add 순서를 지킬 것. 순서를 바꾸면 이 오류가 재현됩니다
설치는 됐는데 페르소나가 전혀 활성화 안 되는 느낌플러그인이 비활성화됐거나 권한·조직 정책·설치 캐시 때문에 hook이 실행되지 않음codex plugin list에서 활성화 상태 확인 → 새 task 시작 → 권한 창이 뜨면 내용을 확인하고 허용. 창이 없는데도 동작하지 않으면 조직 정책과 설치 캐시 확인
플러그인 코드를 고쳤는데 실제 대화에 반영이 안 됨설치 캐시는 파일을 고친다고 자동으로 갱신되지 않음codex plugin marketplace upgrade sodam-persona → codex plugin remove sodam-persona@sodam-persona → codex plugin add sodam-persona@sodam-persona 순서로 재설치 후 새 task 시작
건축 디자인을 요청했는데 #23 대신 #20만 나오거나 새 페르소나가 보이지 않음v1.6.0 이전 설치 캐시를 쓰거나 “디자인”만 입력해 분야가 불명확함위 업데이트 순서로 재설치하고 새 task 시작 → “건축 매스와 파사드 디자인”처럼 분야를 명확히 쓰거나 $persona-architectural-design-expert를 직접 호출
인테리어 디자인·무드보드 요청이 기술 설계나 일반 디자인으로만 처리됨설치본이 오래됐거나 실내 분위기·재료·색채 의도가 발화에 없음새 task에서 “인테리어 무드와 재료 팔레트”처럼 요청하거나 $persona-interior-design-expert를 직접 호출
검색·리서치·아이디어 요청에서 #25~#27이 보이지 않음v1.7.0 이전 설치 캐시를 쓰거나 작업 의도가 너무 짧음최신 버전을 재설치하고 새 task에서 “공식 원문을 찾아 검증”, “사례를 비교 분석”, “근거 기반 대안 제안”처럼 목적을 함께 적거나 해당 skill을 직접 호출
이미지·영상 요청이 일반 디자인이나 렌더링 역할로만 처리됨설치 캐시가 v1.9.0 이전이거나 이미지·영상이라는 명사만 있고 작업 의도가 없음최신 버전을 재설치하고 이미지 합성·워크스루 연출·영상 편집·품질 및 권리 검수처럼 목적을 적거나 #32~#35를 직접 호출
ComfyUI 같은 로컬 생성형 AI 도구를 설치했는데 #36이 보이지 않음설치 캐시가 v1.10.0 이전이거나 제품명만 말하고 작업 의도를 적지 않음최신 플러그인을 재설치하고 설치·워크플로우 편집·노드/모델 진단·CUDA/VRAM 복구·API/큐 작업을 요청하거나 $persona-generative-ai-workflow-engineer를 직접 호출
Midjourney·Higgsfield·Runway 안내가 현재 화면과 다르거나 #37이 보이지 않음기능·요금제·크레딧·정책이 바뀌었거나 플랫폼 이름만 입력함공식 최신 정보 확인을 요청하고 가능하면 현재 화면이나 URL을 제공. 필요하면 $persona-generative-ai-platform-operator를 직접 호출
서버가 응답하거나 작업이 큐에 들어갔지만 검증된 결과가 없음도달 가능·로드·큐 등록·생성·파일 존재·실제 검수를 한 상태로 합침상태를 각각 보고하고 실제 결과를 열어 본 뒤 #35 품질·권리 검수를 거쳐 완료 판단
생성·내보내기 성공 뒤 결과가 깨지거나 재생되지 않음완료 로그를 실제 화면·소리 검수로 잘못 판단함이미지 실제 보기와 영상 전체 재생·싱크·자막·음량 검수를 수행한 뒤 완료로 판단
프로젝트 관리 요청이 기존 #9로만 처리되거나 #28~#31이 보이지 않음v1.8.0 이전 설치 캐시를 쓰거나 역할 문맥 없이 약어만 입력함최신 버전을 재설치하고 “프로젝트 일정·위험 관리”, “제품 백로그 우선순위”, “PMO 승인 체계”, “액션아이템 추적”처럼 책임을 명확히 적거나 해당 skill을 직접 호출
PM·PO·PA 같은 약어가 예상과 다른 역할로 해석됨약어는 조직·산업마다 뜻이 다르며 자동 활성에서 제외됨Project Manager, Product Owner, Project Analyst, Project Architect처럼 전체 직무명과 원하는 결과를 함께 적기
검색 결과에 원문 링크나 최신 확인일이 없음인터넷·브라우저 도구를 사용할 수 없거나 원문 접근이 차단됨출처를 추측하게 두지 말고 “현재 검색 불가/원문 미확인”으로 표시하게 한 뒤, URL·PDF·자료를 직접 제공하거나 검색 가능한 환경에서 다시 실행
“도면 검토해줘”라고 했는데 원하는 검토가 나오지 않음도면 종류·프로젝트 단계·목적·원본 형식이 없어 AB 라우팅이 주도 역할을 확정하지 못함평면도/상세도/시공도 등 종류, 설계/디자인/시공/견적/BIM 중 목적, DWG/PDF/RVT 등 형식, 최신 버전을 함께 제공
Revit·Rhino·D5 같은 프로그램이 자동으로 조작되지 않음페르소나는 판단·절차·검토 기준을 제공하며, 해당 프로그램을 원격 조작하는 기능 자체는 아님원하는 작업 순서·설정·내보내기 형식·검수표를 요청. 실제 조작은 사용자가 하거나 별도 도구 연동과 권한이 있어야 함
터미널에 node를 입력했더니 "인식할 수 없는 명령"이라고 나옴Node.js가 설치되지 않았거나, 설치 후 터미널을 새로 열지 않음nodejs.org에서 설치 후 열려 있던 터미널을 모두 닫고 새로 열기
node build-docs.mjs 실행 시 "pandoc이 설치되어 있지 않습니다"Pandoc 미설치문서를 직접 고칠 사람만 필요. 플러그인을 그냥 "쓰기"만 한다면 이 오류는 무시해도 됨. 고치려면 pandoc.org/installing.html에서 설치
codex plugin marketplace add sodam-ai/SoDam-Persona-Codex 실행 시 네트워크 오류Git 미설치, 저장소 이름 오탈자, 방화벽/프록시 차단git --version으로 Git 설치 확인 → 저장소 이름 철자 재확인 → 회사·학교망이라면 프록시 설정 확인
node validate.mjs 실행 결과가 ❌ FAIL관점·스킬·참조·버전·훅 등의 정합성 오류(주로 새 페르소나 추가/편집 도중)출력된 오류 목록을 한 줄씩 읽고, 표시된 파일을 직접 열어 숫자를 맞춘 뒤 다시 실행. 아키텍처의 "현재 검사 범위"에서 각 번호의 의미를 확인
투자·회계세무·법률의 실행성 답변에 면책 문구가 안 보임예상된 동작이 아닌 실제 결함일 가능성이 높음최신 버전으로 재설치하고 새 task에서 다시 확인. 계속되면 재현 문장과 버전을 GitHub Issue에 기록. validate.mjs 정적 검사와 실제 면책 발화 시험도 실행
Windows PowerShell에서 명령을 입력했더니 경로 관련 오류따옴표·백슬래시가 사람이 옮겨 적는 과정에서 바뀜이 문서의 코드 블록을 그대로 복사해서 붙여넣기(직접 타이핑하지 말 것)
세션이 길어진 뒤 페르소나가 흐트러진 느낌해당 환경에서 hook이 실행되지 않았거나 마커의 지시가 충분히 반영되지 않았을 수 있음codex plugin list 확인 → 새 task에서 재현 → 계속되면 node diagnose.mjs 결과와 재현 문장을 Issue에 기록

자주 묻는 질문 (FAQ)

Q. 왜 45개 역할인데 스킬은 39개인가요? A. 역할은 검토 관점 목록이고 스킬은 실행 지침 파일입니다. 모든 역할에 독립 스킬이 하나씩 있는 구조가 아닙니다. 34개 도메인 스킬과 공통 형식·안전·라우팅 3개, 생성·편집 2개를 합해 39개입니다. 45명이 별도 AI로 동시에 실행된다는 뜻도 아닙니다.

Q. PowerShell에서 $persona-...를 입력하면 되나요? A. 아니요. $persona-...는 Codex 대화 입력칸에 쓰는 스킬 요청입니다. PowerShell에서는 codex plugin ..., node ..., git ... 명령을 사용합니다. 스킬 호출 지원과 정확한 이름은 설치된 호스트에서 확인하세요.

Q. 컴퓨터를 껐다 켰는데 왜 최신 후보가 적용되지 않나요? A. 재부팅은 설치·업데이트가 아닙니다. 원본·마켓플레이스 스냅샷·설치 캐시·대화에 주입된 지침은 서로 다릅니다. 설치 출처와 버전·파일 진단을 확인하고 검증된 후보를 반영한 뒤 새 대화에서 시험하세요.

Q. 모바일이나 메신저에 직접 설치할 수 있나요? A. 이 저장소에는 모바일/메신저 독립 앱이나 설치 기능이 없습니다. README HTML을 읽는 것과 Codex 플러그인을 실행하는 것은 다릅니다. 다른 앱과의 연결은 별도 구현·권한·검증이 필요합니다.

Q. 진단에서 생성 파일 2개가 나오거나 버전이 달라요. A. Codex 0.160.1의 create/edit 이식 파일 2개는 원본에서 재구성한 내용과 정확히 같을 때만 정상으로 인정합니다. 다른 파일·변조·버전 불일치는 정상으로 처리하지 않습니다. 다른 Codex 버전의 생성 형식은 별도 검증해야 합니다. 파일이 다르다고 캐시 전체를 삭제하거나 강제로 통과시키지 마세요.

Q. 이 플러그인은 무료인가요? A. 이 저장소의 코드는 Apache License 2.0으로 공개되어 별도의 플러그인 사용료가 없습니다. 다만 Codex/OpenAI 계정·구독·사용량 요금과 인터넷 비용은 별개일 수 있습니다. 자세한 조건은 법률, 저작권, 라이선스, 상업적 용도를 확인하세요.

Q. 제 컴퓨터 파일을 마음대로 지우거나 고치나요? A. 아니요. 이 플러그인의 hook은 플러그인 폴더 안 고정된 텍스트 파일 2개를 읽는 것 외에는 아무 파일도 쓰거나 지우지 않습니다. Codex의 실제 파일 작업은 승인 범위·도구 권한에 따르며, 새 공개·비용·손실 위험과 도구별 쓰기 게이트는 별도 확인합니다. 훅이 파일을 쓰지 않는다는 사실은 Codex 자체의 파일 수정 권한을 제한하지 않습니다. 자세히는 보안과 데이터 흐름 참고.

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

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

Q. Claude Code에서도 쓸 수 있나요? A. 저장소 안에 예전 호환용 파일(.claude-plugin/)이 남아 있긴 하지만, 현재 이 프로젝트는 Codex 전용으로 관리되고 있으며 새 기능·트리거 갱신은 Codex 매니페스트를 기준으로 이뤄집니다. Claude Code 사용을 전제로 한 최신성은 보장하지 않습니다.

Q. 여러 대의 컴퓨터에 설치해도 되나요? A. 여러 컴퓨터에 설치할 수 있습니다. 하지만 Codex 버전·계정 권한·Node.js·조직 정책·설치 버전에 따라 동작이 달라질 수 있으므로 각 컴퓨터에서 설치 확인을 진행하세요.

Q. 이미지 제작(#32), 영상 연출(#33), 영상 후반작업(#34), 미디어 검수(#35)는 무엇이 다른가요? A. #32는 정지 이미지 생성·보정·합성, #33은 메시지·스토리보드·샷·카메라·소스 생성, #34는 컷·자막·음향·색보정·인코딩, #35는 실제 품질·출처·동의·라이선스 증거를 담당합니다. 3D 렌더 장면 설정은 #22가 담당합니다.

Q. 이미지나 영상 파일이 생성되면 완성된 것인가요? A. 아닙니다. 실제 이미지와 영상 재생을 확인해야 합니다. 확인하지 못한 결과는 미검수이며, 권리 근거가 불명확하면 공개·광고·판매·납품 가능하다고 판단할 수 없습니다.

Q. 생성형 AI 도구 전문가(#36)와 플랫폼 운영 전문가(#37)는 무엇이 다른가요? A. #36은 ComfyUI 같은 로컬·자체 호스팅 환경의 설치, Python, GPU/CUDA/VRAM, 모델, 노드, 워크플로우 JSON, API, 큐, 로그, 보존과 복구를 맡습니다. #37은 Midjourney·Higgsfield·Runway 같은 외부 플랫폼의 최신 기능, 계정, 요금제, 크레딧, 업로드·다운로드, 비용과 정책 근거를 맡습니다. 창작·편집·실제 품질·출처·동의·라이선스 검수는 계속 #32~#35가 담당합니다.

Q. 유료 요금제를 쓰면 생성 결과물을 자동으로 상업적으로 사용할 수 있나요? A. 아닙니다. 유료 결제만으로 상업 이용 권리가 증명되지는 않습니다. 최신 서비스 약관, 요금제별 권리, 입력 자료 라이선스, 모델·체크포인트 라이선스, 음악·폰트 권리, 초상·퍼블리시티권, 상표, 고객 계약을 각각 확인하고 출처와 확인일을 기록해야 합니다.

Q. 프로젝트 매니저(#28), 프로덕트 오너(#29), PMO(#30), 프로젝트 분석·운영(#31)은 어떻게 다른가요? A. #28은 프로젝트 납품을 위해 일정·예산·자원·위험을 통합하고, #29는 사용자 가치와 제품 백로그 우선순위를 결정합니다. #30은 여러 프로젝트의 표준·승인·포트폴리오를 통제하고, #31은 회의·결정·액션·요구사항·상태 데이터를 정확히 추적합니다. 단순 약어 대신 전체 직무명과 원하는 결과를 적는 것이 가장 안전합니다.

Q. 검색(#25), 리서치(#26), 아이디어(#27)는 어떻게 다른가요? A. #25는 신뢰할 자료를 찾아 원문·날짜·버전을 확인합니다. #26은 조사 질문과 비교 기준을 세우고 여러 자료에서 결론과 정보 공백을 도출합니다. #27은 목표에 맞는 대안을 만들고 평가·실험합니다. 근거 기반 아이디어 요청에서는 세 역할이 순서대로 함께 작동합니다. 검색 도구가 없는 환경에서는 출처를 꾸미지 않고 제한을 밝힙니다.

Q. 3D 시각화 경력이 있으면 설계·시공·견적도 전문가로 간주하나요? A. 아니요. 시각화 업종 경험은 형태·재료·빛·카메라 의도를 설명하는 배경으로만 사용합니다. 설계·시공·견적 지식은 입문 상태로 보고 쉬운 용어부터 설명하며, Revit·Rhino·3ds Max·Blender·SketchUp 등도 프로그램별 숙련도를 따로 확인합니다.

Q. 건축 설계(#16)와 건축 디자인(#23)은 무엇이 다른가요? A. #16은 배치·법규·인허가·면적·피난·설계도서 같은 기술 설계를 맡고, #23은 콘셉트·매스·형태·파사드·외장재 같은 미적 방향을 맡습니다. 실제 프로젝트에서는 서로 검토하되 주도 역할을 하나로 정합니다. 인테리어도 같은 원리로 #17은 기술 설계, #24는 분위기·재료·색채·가구 구성 중심 디자인을 담당합니다.

Q. 렌더 이미지나 무드보드를 바로 시공 기준으로 써도 되나요? A. 안 됩니다. 렌더와 무드보드는 의도와 분위기를 전달하는 자료입니다. 실제 시공에는 치수, 재료명·제품번호, 성능, 접합·고정 방식, 설비 간섭, 시방, 승인된 도면과 현장 확인이 추가로 필요합니다.

Q. Revit·Rhino·3ds Max·Blender·SketchUp·Cinema 4D·D5·Twinmotion·Unreal·Unity를 모두 전문가처럼 다뤄야 하나요? A. 아닙니다. 플러그인은 프로그램 이름만으로 사용자의 숙련도를 단정하지 않습니다. 처음 쓰는 프로그램이라면 설치·화면 위치·클릭 순서부터, 익숙한 프로그램이라면 좌표·단위·속성·변환·품질 검수 중심으로 설명하도록 요청할 수 있습니다.

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

Q. 페르소나가 대답을 너무 길게/무겁게 해요. A. "간단히", "짧게", "핵심만" 같은 단어를 말에 섞으면 그 즉시 짧은 형식으로 전환됩니다. 짧은 보고 요청은 작업 범위나 검토 깊이를 줄이지 않으며 상위 지시를 따릅니다.

Q. 반대로 훨씬 더 깊고 꼼꼼하게 봐주면 좋겠어요. A. 깊은 검토 요청은 검토 깊이에 반영합니다. 45개 역할 중 관련 역할을 선택하며 전원 활성이나 고위험 단계 승격을 강제하지 않습니다.

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

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

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

Q. 세션이 오래돼서 대화가 정리(compaction)되거나 서브에이전트를 거치면 페르소나가 사라지나요? A. UserPromptSubmit hook은 해당 이벤트가 전달될 때 마커를 재주입하도록 설계되어 있습니다. compaction·서브에이전트·모든 Codex 환경에서 실제 전달되는지는 미검증이므로 자동 복구를 보장할 수 없습니다. 새 task에서 확인하세요.

법률, 저작권, 라이선스, 상업적 용도

아래 내용은 이해를 돕기 위한 요약이며 법률 자문이 아닙니다. 라이선스 조건을 정하는 문서는 저장소의 LICENSE입니다. NOTICE는 출처·고지를 전달하는 문서이며 라이선스 조건을 추가하거나 바꾸지 않습니다. 상업적 재배포나 권리 귀속 판단이 중요하면 독립적인 법률 검토를 받으세요.

라이선스: Apache License 2.0

  • 프로젝트에 표시된 저작권 고지: Copyright 2026 SoDam AI Studio (NOTICE 기준). 실제 법적 주체명, 기여자 권리 이전, AI 보조 작성물의 권리 귀속은 이번 기술 점검에서 독립적으로 입증하지 않았으므로 공식 납품·투자·권리 보증이 필요한 경우 법무/전문가 검토 필요
  • 원문 위치: 저장소 루트 LICENSE 파일
  • 공식 참고 링크: Apache 공식 원문 (2026-10-09 확인; 공식 명칭 Apache License, Version 2.0, 영어 원문 정본. 저장소 LICENSE 및 아래 요약과 함께 확인)

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

허용 사항의미
상업적 이용이 코드를 회사·개인 사업에 그대로 쓰거나 판매하는 제품에 포함해도 됩니다
수정코드를 자유롭게 고칠 수 있습니다
배포원본 그대로든 수정한 형태든 다른 사람에게 다시 배포할 수 있습니다
특허 사용각 기여자가 허여할 수 있고 그 기여분 때문에 필연적으로 침해되는 특허 청구항에 한해 사용권이 부여됩니다. 특정 특허 소송을 제기하면 해당 특허 라이선스가 종료될 수 있습니다(원문 제3조)

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

조건의미
라이선스 사본 포함이 코드(또는 그 일부)를 다시 배포할 때 Apache License 2.0 전문 사본을 함께 제공해야 합니다
변경 사항 명시원본을 수정했다면, 수정한 파일에 "변경했다"는 사실을 눈에 띄게 표시해야 합니다
저작권·특허·상표 고지 유지원본 소스에 있던 저작권·특허·귀속 고지를 삭제하지 않고 유지해야 합니다
NOTICE의 관련 고지 포함원본에 NOTICE가 있으므로 Apache License 2.0 제4조(d)에 따라 배포하는 부분에 해당하는 귀속 고지를 읽을 수 있는 형태로 제공해야 합니다(NOTICE, 문서 또는 화면 표시 등). 원문과 적용 범위를 확인하세요

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

  • 이 소프트웨어는 "있는 그대로(AS IS)" 제공되며, 상품성이나 특정 목적 적합성을 포함해 어떠한 형태의 보증도 하지 않습니다.
  • 원문 제8조는 적용 법률에서 요구하거나 별도 서면 합의한 경우 등을 제외하고 책임을 제한합니다. 모든 관할·모든 상황에서 손해배상 책임이 절대 없다고 단정할 수는 없습니다.
  • 사용 및 재배포의 적합성을 판단하고 그에 따른 위험을 부담하는 것은 전적으로 사용자의 책임입니다.

Apache License 2.0이 실제로 적용되는 범위

왕초보 한 줄 정리: 이 저장소에 Apache License 2.0이 표시되어 있어도, 그 라이선스는 SoDam AI Studio와 각 기여자가 적법하게 허락할 수 있는 권리에만 적용됩니다. 다른 사람의 글·상표·이미지·고객 자료·AI 서비스 결과물까지 자동으로 허락해 주는 문서는 아닙니다.

대상현재 확인된 상태공개·상업적 사용 전 해야 할 일
이 프로젝트가 직접 작성한 코드·문서·프롬프트·규칙Apache License 2.0 적용이 표시되어 있음. 다만 저작권자 법적 주체명, 기여자 권리 이전, AI 보조 작성물의 권리 사슬은 독립적으로 입증하지 않음LICENSE와 관련 NOTICE 고지를 유지하고, 수정 파일에 변경 사실을 표시. 권리 보증이 필요한 납품은 법무/전문가 검토 필요
기존 배포의 제3자 출처 3건 (NOTICE에 이력 보존; 현재 v6에서 문구 제거)출처만 식별됨. 별도 허락·라이선스·관할별 인용 예외 적용 여부는 확인되지 않음해당 문구를 다시 사용하는 경우, 공개·상업 재배포 전에 허락, 적용 가능한 라이선스 또는 인용 예외 등 적법한 근거를 기록. 근거가 불명확하면 법무/전문가 검토 필요
제품명·회사명·상표호환성·출처 설명을 위한 문자 표기만 있으며 로고 파일은 없음제휴·후원·공식 승인을 암시하지 말고, 원본 출처 설명에 필요한 범위만 사용
Codex 등 외부 AI 서비스의 입력·출력이 프로젝트의 Apache License 2.0만으로 권리나 상업적 이용 가능 여부를 보장할 수 없음입력 자료의 권리·동의, 출력의 유사성·침해 가능성, 계정 유형별 최신 약관과 정책을 사용자가 직접 확인
사용자가 넣는 고객 자료·내부 문서·개인정보현재 저장소에는 실제 자료가 없지만, 설치 후 사용자가 입력할 수 있음업로드·처리 권한, 비밀유지 의무, 개인정보 처리 근거와 고객 동의를 먼저 확인

NOTICE에 출처를 적는 것은 출처 표시일 뿐, 제3자 자료의 이용 허락을 새로 만들어 주지 않습니다. 또한 Apache License 2.0 제5조에 따라 프로젝트에 포함할 목적으로 의도적으로 제출한 기여물은 별도 표시나 계약이 없다면 같은 라이선스 조건으로 제출된 것으로 다뤄질 수 있으므로, 기여자는 제출 권한이 있는 자료만 제공해야 합니다.

저작권 및 제3자 인용 (NOTICE 파일 요약)

  • 기존 배포의 제3자 인용 출처를 NOTICE에 보존합니다. 현재 v6 persona-triggers/SKILL.md에서는 아래 문구를 제거했으므로 현재 스킬에 인용이 포함되어 있다고 해석하지 마세요. NOTICE는 현재 포함과 과거 출처 이력을 구분하도록 정정했으며 이용 허락의 증거가 아닙니다.
    • "Chesterton's Fence" — G. K. Chesterton의 The Thing 중 "The Drift from Domesticity"와 연결되는 원칙을 단순화한 의역
    • "Hyrum's Law" — Hyrum Wright에게 귀속되고 https://www.hyrumslaw.com/에 게시된 관찰을 축약한 표현
    • Goal-Driven Execution — Andrej Karpathy에게 귀속되는 공개 게시물의 짧은 발췌. 확인한 공개 아카이브: https://adhx.com/karpathy/status/2015883857489522876
  • 이 출처 표시는 해당 문구가 퍼블릭 도메인이거나 이 프로젝트에 별도 허락되었거나 모든 국가에서 자유롭게 재사용 가능하다는 보장이 아닙니다. 공개·상업적 재배포 전에 인용 허용 범위, 관할법, 정확한 출처와 표시 방법은 법무/전문가 검토 필요입니다.
  • 현재 배포 후보에서는 제3자 소스 코드·이미지·아이콘·폰트·영상·음원 파일은 발견되지 않았습니다.

상표 고지

이 문서와 프로젝트에서 언급하는 "Claude", "Claude Code", "Anthropic", "Codex", "OpenAI", "GitHub", "Node.js" 등의 제품·회사명은 각 소유자의 상표 또는 등록상표입니다. 이 프로젝트는 이들 중 어느 누구와도 제휴·후원·승인 관계가 없는 독립적인 프로젝트입니다. Apache License 2.0은 상표 사용권을 주지 않으므로, 해당 이름은 제품 식별·호환성·원본 출처 설명과 NOTICE 재현에 필요한 합리적인 범위에서만 사용해야 합니다.

도메인 전문가 페르소나에 대한 중요한 법적 고지

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

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

AI가 생성한 콘텐츠(코드·문서 등)를 사용할 때 주의할 점

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

외부 서비스, API 요금제, 모델 이용 정책은 별도로 확인해야 합니다

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

  • Codex/OpenAI의 요금제와 사용량 제한
  • 모델 사용 정책(허용/금지되는 사용 사례)
  • 상업적 서비스에서 Codex 응답을 재판매·재사용할 때 별도 조건이 있는지 여부
  • 개인용 서비스 약관: https://openai.com/policies/terms-of-use/
  • 기업·개발자·API용 서비스 계약: https://openai.com/policies/services-agreement/
  • 사용 정책: https://openai.com/policies/usage-policies/
  • 개인정보처리방침: https://openai.com/policies/privacy-policy/
  • 공식 플러그인 설치·권한 안내: https://help.openai.com/en/articles/20001256/

위 링크와 정책은 바뀔 수 있으므로 실제 사용·배포·납품 시점에 다시 확인해야 합니다.

저장소에 포함된 자산·외부 의존성 점검

이 저장소를 코드·문서 전체 기준으로 점검한 결과(2026-09-23, Git 추적 대상 64개 파일 기준)입니다.

점검 항목결과
package.json, package-lock.json, pnpm-lock.yaml, yarn.lock, requirements.txt, pyproject.toml, Cargo.toml, go.mod 등 의존성 파일저장소 전체에서 0건 확인 — 배포물에 묶여 들어가는 외부 패키지 의존성은 확인되지 않음
이미지·아이콘·폰트·영상·음원 파일(png, svg, ico, woff, ttf, mp4, mp3 등)저장소 전체에서 0건 확인
assets, public, static, samples, examples, fixtures 폴더저장소 전체에서 0건 확인
샘플 계정, 이메일, 전화번호, 실제 사용자 홈 경로, 실제 고객 데이터Git 추적 대상 64개 파일에서 실제 데이터 0건 확인. 검증기의 차단 기능을 시험하기 위한 일반화된 가짜 Windows 사용자 경로 문자열 1개만 차단 확인용 테스트에 포함(실제 사용자 정보 아님)
로컬 작업 기록(.omc, .omx, .remember, .plugin-config, CHECKPOINT.md 등).gitignore로 배포 대상에서 제외됨. 수동으로 폴더를 압축할 때 포함하지 말 것
hook 스크립트(inject-core.js, inject-marker.js)의 외부 패키지 사용 여부Node.js 내장 모듈만 사용, 외부 패키지 import/require 0건

현재 저장소에 포함된 이미지·폰트·외부 패키지에서 추가 라이선스 의무는 확인되지 않았습니다. Node.js·Pandoc·Codex처럼 사용자가 별도로 설치하는 도구의 라이선스와 이용약관은 각각 따로 적용됩니다. 이후 자산이나 의존성을 추가하면 다시 점검해야 합니다.

상업적 용도 요약

왕초보를 위한 한 줄 정리: Apache License 2.0이 적용되는 이 프로젝트의 코드·문서는 그대로 쓰기, 고쳐 쓰기, 포크, 재배포, 판매, 서비스 운영, 교육 및 고객사 납품에 사용할 수 있습니다. 다만 상표, 제3자 인용, AI 생성 결과, 추가한 자료, 외부 서비스 약관과 실제 권리 귀속은 별도 확인 대상입니다.

현재 공개·납품 판단: 현재 v6 스킬에서 과거 제3자 문구 3건은 제거되어 있습니다. NOTICE는 출처 이력을 보존하며 현재 포함 상태도 이에 맞게 정정했습니다. 이것만으로 모든 권리가 검증된 것은 아닙니다. 기여자 권리, AI 보조 작성물의 출처·유사성, 추가 자료 및 외부 서비스 조건은 납품 전 별도로 확인해야 합니다. 법무/전문가 검토 필요 사항은 권리 점검 기록에 구분했습니다.

하고 싶은 것Apache 2.0상 가능 여부조건·별도 확인 사항
이 플러그인을 회사·개인 업무에 그대로 사용(재배포하지 않음)가능이 저장소 라이선스상 별도 재배포 의무 없음. Codex/OpenAI 이용약관·요금은 별도
복제하거나 GitHub에서 포크(fork)해서 내 계정에 두기가능공개 포크는 재배포이므로 LICENSE와 관련 고지를 유지. 비공개 로컬 복사만으로 공개 배포가 되는 것은 아님
이 플러그인을 수정해서 내 상업 제품/서비스에 포함가능위 "조건" 표(라이선스 사본·변경 명시·고지 유지) 준수
이 코드를 다시 패키징해서 유료로 재배포가능위와 동일. Apache License 2.0은 재배포 자체에 요금을 매기는 것을 금지하지 않습니다
이 플러그인을 기반으로 한 서비스를 운영(SaaS 등)가능소스·플러그인을 고객에게 배포하면 위 재배포 조건 준수. 서버 내부에서만 사용하더라도 Codex/OpenAI 약관, 개인정보, 전문업 규제를 별도 확인. 실제 투자·법률·세무 자문으로 오인되지 않도록 면책 고지 제공 권장
교육 자료(강의·튜토리얼·사내 교육)로 활용가능교육용 사용 자체는 허용되지만 자료를 나누어 주면 재배포 조건을 준수하고 외부 자료 권리도 확인
회사/고객사에 납품하는 산출물에 포함가능위 "조건" 표 준수. 고객사에도 라이선스 사본과 NOTICE 고지가 함께 전달되어야 함
"SoDam", "sodam-ai" 브랜드명을 그대로 써서 내 제품의 출처·후원자로 오인되게 배포허용된다고 볼 수 없음라이선스는 상표 사용권을 주지 않습니다(원문 제6조). 원본 출처 설명 등 합리적이고 통상적인 표시 범위를 넘는 사용은 권리자 확인 필요

공개·배포·납품 전 우선순위

우선순위해야 할 일
Must HaveLICENSE 사본 제공, NOTICE의 관련 고지 전달, 수정 파일에 변경 사실 표시, 상표로 제휴·후원을 오인시키지 않기, 외부 서비스 약관·개인정보·고객 자료 사용 동의 확인. 과거 제3자 문구를 다시 넣는 경우 그 사용 권리 근거를 확인·기록하거나 법무/전문가 검토 받기
Should Have제3자 인용의 정확한 출처와 적용 범위를 기록하고, 저작권자 표기의 법적 주체명·기여자 권리 이전·AI 보조 작성물의 권리 귀속 기록을 정리하기
Could Have회사/고객사 납품 계약, 면책·보증·손해배상 범위, 국가별 규제에 대해 변호사 검토를 받고 외부 자료 목록 또는 SBOM을 릴리스마다 보관하기

하면 안 되는 것 (요약)

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

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

초보자용 확인·업데이트·배포 순서

먼저 알아둘 상태 구분

확인 대상무엇을 의미하나요?무엇까지 증명하지는 못하나요?
GitHub의 파일다른 사람이 내려받는 배포 원본내 PC 설치본의 자동 업데이트
내 PC의 소스 파일지금 수정하고 검사하는 파일Codex가 그 파일을 실제로 사용함
설치본과 버전Codex에 등록된 플러그인과 버전같은 버전의 모든 파일이 동일함
훅 직접 실행지침을 정상적인 JSON으로 전달함AI 답변이 항상 지침을 따름
새 대화의 실제 답변해당 대화에서 관점 표시와 판단이 나옴모든 미래 요청에서 오류 없음

2026-10-09 검증 기록에서 소스 후보는 1.11.2, 기존 전역 설치본은 **1.11.1(enabled)**으로 서로 달랐습니다. 격리 설치한 1.11.2는 소스 61개 파일 및 Codex가 생성한 명령 스킬 2개와 일치했고 직접 훅 실행·제거·재설치를 통과했습니다. 전역 설치 업데이트나 Desktop 자동 적용은 수행·확인한 것이 아닙니다. 독자의 실제 상태는 아래 명령으로 직접 확인하세요. 상세 시험 조건·실패·미확인 항목은 검증 기록에 있습니다.

1단계 — 진단하기

PowerShell은 명령을 입력하는 창입니다. 파일 탐색기에서 이 프로젝트 폴더를 열고 주소창에 powershell을 입력한 뒤 Enter를 누르면 그 폴더에서 창을 열 수 있습니다. 아래 명령은 한 줄씩 입력하고 Enter를 누릅니다. node를 찾지 못하면 필요 프로그램의 Node.js 설치부터 확인하세요.

node --version
codex --version
codex plugin list
node diagnose.mjs

codex plugin list에서 sodam-persona@sodam-persona의 활성 상태·버전·소스 위치를 봅니다. diagnose.mjs는 파일을 수정하지 않고 정확한 버전, 활성 상태, 설치 캐시 파일 내용, 일치하는 설치본의 두 훅과 소스 정합성을 확인합니다. 종료코드 0은 이 진단 조건 통과, 종료코드 1은 조건 중 하나가 맞지 않는다는 뜻입니다. 버전 불일치·비활성·미설치·설치 상태 확인 불가·훅 오류·정합성 오류라면 해당 원인을 해결하고 다시 실행하세요. 숫자 0은 실제 Desktop 대화 검증 완료를 뜻하지 않습니다.

2단계 — 설치 출처에 맞게 업데이트하기

  • GitHub 설치: 위의 업데이트와 제거 절차는 Git 마켓플레이스 스냅샷을 갱신하는 방식입니다. 업데이트 전에 원본 출처가 Codex 포팅 저장소인지 확인합니다.
  • 로컬 폴더 설치: marketplace upgrade가 로컬 폴더의 수정본을 GitHub 최신 파일로 바꿔 주지는 않습니다. 표시된 소스 폴더를 먼저 확인하고, 개인 수정은 백업한 뒤 검증된 파일만 업데이트합니다. 미커밋 변경이 있으면 무작정 git pull, 강제 초기화, 폴더 덮어쓰기를 하지 마세요.
  • 제거·재설치 전: 개인 수정이 캐시에 있으면 먼저 보존하세요. 어느 폴더가 원본인지 불명확하면 삭제 대신 codex plugin list와 원본 파일을 대조합니다.
  • 업데이트 후: 진단을 재실행하고 새 대화를 만듭니다. 앱 재시작만으로 최신 버전이 설치되는 것은 아닙니다. 버전이 같아도 수정 파일이 다를 수 있어 실제 사용하는 소스 위치도 확인합니다.

3단계 — 실제로 요청해 보기

새 Codex 대화에 아래 문장을 평소처럼 입력합니다. 매번 새 대화에서 비교하면 이전 요청의 영향이 줄어듭니다.

건축 도면과 BIM 모델의 치수가 서로 다를 때 무엇부터 확인해야 해?

건축시각화 홍보 영상의 콘셉트와 고객 제안서 구성을 잡아줘.

“BIM과 ComfyUI를 사용했습니다.” 이 문장 맞춤법만 확인해줘. 다른 작업은 하지 마.

일반 자연어 답변 첫 줄에 실제 적용한 관점이 나와야 합니다. 마지막 요청은 단어만 언급했으므로 건축·생성 도구 작업을 시작해서는 안 됩니다. 전문 관점을 쓰지 않았다면 전문 관점 미적용을 표시합니다. JSON·코드만 요구하거나 표시 금지를 명시하면 사용자가 정한 출력 형식을 우선합니다. 관점 문구만 흉내 내는 것으로 충분하지 않으며 답변 내용도 요청과 맞아야 합니다.

4단계 — 소스를 수정한 사람의 검사

일반 사용자는 아래 개발 검사를 매번 실행할 필요가 없습니다. 소스 또는 문서를 바꿨다면 저장소 최상위에서 실행합니다. 이 프로젝트에는 package.json·TypeScript 구성·별도 lint 명령이 없습니다. JavaScript 구문·정합성·Node 내장 시험과 Pandoc 문서 생성으로 검사합니다.

node --check validate.mjs
node --check diagnose.mjs
node validate.mjs
node --test test-hooks.mjs test-validator.mjs test-supplemental.mjs test-diagnose.mjs test-evaluate.mjs test-docs.mjs
node build-docs.mjs
node check-docs.mjs
git diff --check

현재 자동 시험은 53개입니다. 훅의 정상·빈·잘못된 입력과 복구, 등록부·버전·파일 변조·권한 오류, 설치 진단, 평가 기록 보존·형식, 문서 동기화를 검사합니다. 180개 기본+90개 한국어 라우팅 사례는 시험 입력 목록이며 목록 존재만으로 실제 AI 통과를 뜻하지 않습니다. 실제 실행 결과는 검증 기록에서 별도로 확인합니다. 훅은 stdin 내용을 실행·저장하지 않고 읽어 비운 뒤 고정 지침을 출력합니다.

node build-docs.mjs는 Pandoc이 필요합니다. 설치 방법은 Pandoc 공식 안내를 따르세요. Markdown을 편집한 뒤 이 명령으로 HTML을 만들며 HTML 본문을 따로 고치지 않습니다. 테스트 실패를 해결하지 못하면 성공으로 보고하거나 검사를 생략하지 말고 배포를 중단합니다.

5단계 — GitHub 배포와 로컬 반영을 구분하기

  1. git status --short, git diff, git ls-files로 수정·추적 파일을 확인하고 비밀정보·개인 파일·대용량·캐시를 점검합니다. CHECKPOINT.md는 포함하지 않습니다.
  2. 현재 브랜치와 원격 주소를 확인합니다. 원본 SoDam-Persona와 배포 대상 SoDam-Persona-Codex는 다른 저장소이므로 원격 별칭만 믿지 않습니다.
  3. 검증한 변경만 작업 브랜치에 의미 있는 commit으로 묶고 push합니다. 기본 브랜치에 직접 push하는 대신 Pull Request를 만들고 충돌·CI·보호 규칙을 확인해 병합합니다.
  4. 기본 브랜치의 한국어 README·영어 README·HTML·LICENSE·NOTICE가 최종 파일과 일치하는지 확인합니다. About·Topics에는 실제 기능과 공개 가능한 정보만 적습니다.
  5. Release는 별도 결정입니다. 플러그인 설치와 GitHub 파일 반영은 서로 다른 작업이며, 배포 후에도 설치 출처에 맞춰 업데이트하고 새 대화로 확인해야 합니다.

최종 점검의 실제 범위

항목2026-10-09 확인 결과
소스 정합성·구문·자동 시험53/53 통과; Windows / Node.js 26.7.0
MD와 HTML언어별 본문 일치, 한·영 제목·토글 구조 일치, 격리 빌드 해시 일치
문서 화면Edge 375/768/1280px × 한·영 6개 흐름에서 가로 넘침·내부 앵커 오류·콘솔 오류 없음; 첫 토글 확인
후보 지침 실제 AI 실행전체 272개 재시험 중 270개 최초 통과, CLI 실패 2개 별도 재실행 통과; 최초 실패 원인 미확인
마지막 문구 수정 후마케팅 관련 6개 행동 사례와 전체 자동 시험 재검증; 마지막 수정 이후 전체 272개 재실행은 하지 않음
공개 후보 보안95개 현존 파일 및 도달 가능한 84개 Git 커밋 텍스트의 대표 비밀정보 패턴 발견 0건; 모든 개인정보·바이너리 이력은 보장하지 않음
설치 진단격리 후보 일치·직접 훅·설치 수명주기 통과; 기존 전역 설치본은 후보와 다름
미확인Desktop 자동 훅·모든 답변 전문 품질·실물 모바일·다른 브라우저/OS·긴 대화·장시간 부하·원격 CI
자체 로그인·API 서버·DB프로젝트에는 없음; Codex 인증·통신·외부 도구는 별도

전체 시험은 후보 지침을 직접 제공한 CLI 대화입니다. 실제 설치 훅의 자동 선택 시험이나 도면·미디어 실무 수행을 대신하지 않습니다. 공개 배포 판단은 미확인 항목의 추가 확인이 필요하며 문서 검사 통과를 공개 배포·전역 설치 완료로 확대하지 않습니다. GitHub 반영 상태는 원격 기본 브랜치에서 별도로 확인하며 Release와 설치 업데이트는 별도 단계입니다.

v6 검증 범위

1.11.2 · 45개 역할 · 39개 스킬 · 훅 2개. 파일·훅 검사는 답변 전문 정확성·실제 도면·영상 검수의 증거가 아닙니다. node validate.mjs, 전체 6개 테스트 파일, node build-docs.mjs, node check-docs.mjs로 소스와 문서를 확인하고 실제 행동은 별도 새 대화로 시험합니다.

현재 자동 시험은 53개이며 실제 전체 행동 시험 결과와 실패·재실행을 위 표 및 VERIFICATION.md에 구분했습니다. 이 결과를 Desktop 자동 적용이나 모든 미래 요청의 성공으로 확대하지 않습니다.

법률 근거와 적용 범위

현재 작업 트리 권리 점검: 공개 후보 95개·JS 2개·MJS 13개를 확인했고 LICENSE 1~9조를 공식 원문과 대조했습니다. 외부 npm 의존성·배포용 미디어는 발견하지 못했습니다. 실제 설치 묶음·납품물에 LICENSE/NOTICE가 포함되는지와 수정 파일별 변경 표시 준수는 납품 전에 별도로 확인해야 합니다. 상세 범위·미확인은 권리 점검 기록을 따릅니다.

최상위 LICENSE·NOTICE 원문이 기준입니다. Apache-2.0의 사용·재배포 허용에는 조건이 있으며 제3자 자료·상표·고객 데이터·AI 서비스 결과물의 모든 권리를 허락하지 않습니다. 수정 파일을 배포할 때는 저작권/NOTICE와 라이선스를 보존하고 수정 사실을 명시해야 합니다. 특허 조건·상표·보증 없음·책임 제한·추가 의무는 각각 원문 제3·6·7·8·9조도 확인하세요. 이 안내는 법률 자문이나 모든 생성물의 적법성·소유권 보장이 아닙니다.

↑↓ navigate openesc close