Skill 중심 실행과 Vault 선택 조회 결정 - Codex 대화
이 기록은 2026-09-30 DanzzaN과 Codex의 정책 재검토, 승인된 Codex 적용 범위와 다른 앱이 이어받을 원천을 보존한다. MCP·GitHub 정본·AWS 초안·인증·묶음 저장 계약은 유지한다. Codex의 설치·검증과 다른 앱의 적용은 각각 실제 근거가 확인한 범위로 구분한다.
결정과 이전 정책의 관계
이전에는 최소 진입 지침과 원천 Markdown 직접 읽기를 기본으로 두고 스킬을 선택적으로 남겼다. DanzzaN은 이번에 Vault는 꼭 필요한 때만 조회하고 평소 절차는 스킬 중심으로 제공하는 방향을 제안했다. 장기 자산은 개인 경험·선호·교정·판단 이유를 설명하는 언어 기록이라는 원칙을 유지하며, 실행판의 전달 방식을 다시 선택한 것이다. 과거의 직접 조회 결정은 원격 Vault 정본과 쓰기 운영 결정 - Codex 대화에 이력으로 보존한다.
공통 작업 본문을 우선하고 모델·추론 수준이 실제 노출되며 해당 작업에 맞는 작은 보정이 있을 때만 추가한다. 값이 노출되지 않거나 맞는 보정이 없으면 공통 본문을 적용한다. 모델 업데이트는 관련 스킬 재검토의 계기이며 전체 자동 재작성이나 모델 설정 변경의 승인이 아니다. 새 방식의 비용 절감과 모든 모델의 행동 개선을 확인한 것으로 기록하지 않는다.
개인 근거가 부족할 때, 기록·지침 충돌을 해소할 때, 현행 계약이나 갱신을 확인할 때, Vault를 저장할 때 원격 원천을 조회한다. 스킬의 정상 실행을 위해 원격 문서를 매번 먼저 읽게 만들지 않는다. 현재 값·도구 스키마·권한은 실제 환경에서 확인하고 저장 직전 최신 조회와 묶음 저장 계약은 유지한다.
승인된 순서와 범위
사용자는 Codex 적용 뒤 이번 의사결정·적용 과정을 Vault에 기록하고, 다른 앱은 각 앱에서 기록을 읽고 적용하는 순서를 확인했다. 실행 승인과 구체적 범위는 [비공개 문서]의 plan_version: 2에 있다. 계획 저장 commit은 c4ca79a178c0fca8269830142edf8a87ba5f843b이며 문서 버전과 Git commit을 구분한다.
이번 범위는 Codex의 공통 에이전트 운영 스킬, writing-for-agents 재작성·활성화, session-handoff 적용, 전역 진입 지침과 호출 설정, 관련 Vault 정책·결정·실행판 기록이다. 다른 앱의 파일·설정, 비활성 스킬 전체 복원, 외부 bundled 스킬, MCP·AWS·GitHub·OAuth 변경은 포함하지 않는다.
Codex 적용 과정과 버전 대응
승인 계획을 먼저 c4ca79a178c0fca8269830142edf8a87ba5f843b에 저장하고 기존 지침·스킬·설정을 백업했다. 후보를 역할별로 작성한 뒤 메인과 별도 Codex 작업자가 원문·승인 범위·diff를 검토했다. 다른 앱의 스킬이 없는 경우 원격 실행 본문으로 도달할 경로를 보완하고 같은 리뷰어가 해소를 확인했다. 인계 프롬프트 작성 스킬과 실제 프로젝트 초기 구성·이어받기의 범위도 구분했다.
검토한 12개 스킬 파일과 전역 지침·config 2개를 실제 Codex 경로에 설치했다. 변경 전 파일 hash로 동시 변경을 확인하고 설치 후 14개 목적지 hash가 후보와 같은지 대조했다. config는 실제 TOML을 파싱해 writing-for-agents의 enabled=false → true만 의미상 달라졌음을 확인했다. 나머지 비활성 스킬·모델 설정은 그대로다.
| 대상 | 실행판 version | 실제 목적지와 대응 |
|---|---|---|
| agent-operations | 2026-09-30.1 | C:/Users/aica_/.codex/skills/agent-operations/ 에 새 설치. Paseo 참고는 해당 경로를 사용할 때만 조회 |
| writing-for-agents | 2026-09-30.1 | C:/Users/aica_/.codex/skills/writing-for-agents/ 재작성·활성화. 기존 UI 필드와 MIT 고지 보존 |
| session-handoff | 2026-09-30.1 | C:/Users/aica_/.codex/skills/session-handoff/ 에 새 설치. Claude 원본은 수정하지 않음 |
| 전역 지침·호출 설정 | 위 실행판과 대응 | C:/Users/aica_/.codex/AGENTS.md 에 스킬 선택·선택적 Vault 조회, config.toml의 writing 활성화 |
| Vault 현행 정책·전달본 | 동일 최종 적용 묶음 | 안내·작성 Map·공통 운영·Atomic과 본 Source·실행판을 같은 묶음으로 저장. 이 본문을 읽은 vault_read의 반환 commit이 실제 저장 버전 |
최종 적용 묶음 ID는 skill-vault-apply-20260930-01a0f017-v2, 기준 commit은 c4ca79a178c0fca8269830142edf8a87ba5f843b다. Git commit hash를 그 commit 내부 본문에 자기참조로 미리 넣지 않는다. 저장 확인은 APPLIED commit·diff와 정본 재조회로 수행한다.
다른 앱에서 읽을 스킬 본문·참고 파일·출처·라이선스와 Codex 전역 지침 확인본은 [비공개 문서]에 보존한다. 파일별 SHA256도 해당 전달본에 있다. 현재 값·계약은 실제 시스템과 원천에서 확인하며 파생 실행판의 자동 동기화는 전제하지 않는다.
검증과 미검증
- 실제 목적지 14개 hash 일치, 설치된 세 스킬의 공식 quick_validate.py 각각 exit 0, 로컬 참조 존재와 기존 UI·MIT LICENSE 보존을 확인했다. config TOML 파싱과 단일 활성화 변경도 확인했다.
- 설치 뒤 현재 Codex Desktop 대화에 새 전역 AGENTS 지침이 전달됐다. 이는 해당 진입문 전달의 직접 근거이며 세 스킬의 자동 발견·본문 전달까지 입증하지는 않는다.
- 새 Codex CLI 0.157.1 세션은 읽기 전용·ephemeral로 확인을 시도했으나 기존 기본 모델 gpt-6.1-sol이 ChatGPT 계정에서 지원되지 않는다는 HTTP 400으로 멈췄다(exit 1). 모델/추론 설정을 바꾸거나 다른 모델의 비교 실행으로 확대하지 않았다. 새 CLI·Desktop 세션의 세 스킬 자동 발견·본문 전달은 미검증이다.
- Codex 독립 작업자가 스킬·전역 지침·설치 범위와 Vault 정책 diff를 읽고 검토했다. 스킬 부재 fallback 지적은 작성자가 수정하고 같은 리뷰어가 해소를 확인했다. 실측을 채운 최종 Source·전달본도 같은 리뷰어가 재검토해 확정 결함이 없음을 확인했다. 전달본의 12개 본문·hash·참고 경로·닫힌 코드 블록과 설치본의 대응을 대조했다.
- Claude CLI 인증 상태는 읽기 전용으로 확인했으나 실제 교차 회사 리뷰 명령은 자동 승인 심사에서 거절돼 시작하지 않았다. 후보와 개인 Vault 정책·이력을 Claude.ai로 전달하는 별도 승인이 없다는 이유다. 이 전송은 우회·재시도하지 않았고 Codex 독립 리뷰로 이어갔다. 교차 회사 리뷰 결과는 없다.
- 설치·구조 확인만으로 토큰 절감·행동 향상·반복 누락 감소를 확정하지 않는다. 모델·추론 수준별 보정은 현재 없으며 모든 조합의 비교 실행이나 별도 대규모 eval을 만들지 않는다. 실제 요청된 작업에서 적용 여부·필요한 조회·누락·불필요한 호출·수정 부담을 순차 관찰한다.
근거 위치
로컬 확인 자료는 C:/Users/aica_/.codex/visualizations/2026/09/30/01a0f017-f87a-7033-97c3-1fea70dea835/skill-vault-transition/의 candidate-manifest.json, verification-evidence.json, fresh-codex.jsonl에 있다. 설치 전 백업은 backup/와 hashes.json에 있다. config 백업은 자격 증명을 포함할 수 있으므로 Vault나 다른 제공자에 본문을 전달하지 않는다. 다른 앱이 실행판을 옮길 때 이 로컬 검증 자료의 접근을 필수로 삼지 않으며 원격 전달본·현행 정책과 각 앱의 직접 확인 결과로 이어간다.
복구와 각 앱에서의 후속 적용
변경 전 Vault 기준은 be782d7c56de53734fba4d1e27f732d075099002다. 로컬 지침·스킬·활성화 상태와 Vault 정책의 대응을 함께 복구하며 적용 후 동시 변경을 먼저 대조한다. Vault 본문 복원은 과거 이력 덮어쓰기 대신 [비공개 문서]에 따른 새 묶음으로 수행한다. 적용 후 대응 버전은 2026-09-30.1과 해당 묶음의 실제 저장 commit이다. 복구 자료는 확보했지만 복구 실행은 하지 않았다. 설치 스크립트는 사전 hash 검사 뒤 순차 복사하므로 중간 실패 시 자동 rollback을 보장하지 않는다. 복구할 때 기존 세 스킬·지침·호출 상태와 Vault 정책을 함께 대조한다.
| 앱 | 이번 적용 상태 | 다음 작업 |
|---|---|---|
| Codex | 파일·설정·형식 적용 확인, 새 세션 스킬 발견·본문 전달과 실사용 효과는 미검증 | 실제 다음 요청에서 자동 발견·적용과 필요한 조회를 확인 |
| Claude Code | 이번 실행 뒤 2026-09-30 Claude 대화에서 적용. 범위와 확인은 Skill 실행판의 Claude Code 적용 - Claude 대화 | 해당 기록의 미검증 항목을 실제 요청에서 확인 |
| claude.ai·Cowork | 이번 실행에서 설정·스킬 미적용 | 승인 범위를 확인하고 해당 앱에서 실행판·원천을 읽어 적용·확인 |
| Antigravity | 이번 실행에서 미적용 | 해당 앱의 스킬·진입 형식과 호출 정책을 확인해 별도 적용 |
| Paseo 및 그 밖의 앱 | 이번 실행에서 미적용 | 실제 제공자·세션·원천 접근을 확인해 별도 적용 |
후속 앱은 이 기록과 [비공개 문서]를 읽고, 현재 요청·승인 범위·실제 설정 위치·참고 원천 접근을 확인한다. 앱에 맞는 형식과 호출 정책으로 적용한 뒤 등록·발견·본문 전달·실제 적용을 구분해 반환한다. 원천 접근이 부족하면 필요한 범위를 밝히며 이번 실행의 후속 범위를 자동 동기화나 새 저장소 생성으로 확대하지 않는다. 공통 Vault 기록을 읽은 것과 해당 앱의 파일·설정 적용은 다른 상태다.
비교한 외부 자료와 확인 범위
2026-09-30 정책 논의에서 아래 공식 문서를 확인했다. 과도한 절차·넓은 호출 조건·매 작업의 전체 문서 조회를 재검토할 비교 근거이며, 스킬 전부 제거나 Vault 직접 조회의 일률적인 비용 우위를 입증한 자료는 아니다.
- Claude 프롬프팅 모범 사례: 적용 이유와 명확한 조건을 전달하고, 특정 모델에서 관찰되는 과다 호출·과검증을 조정하는 설명.
- OpenAI GPT-6 프롬프팅 모범 사례: 지침 민감도·조기 중단·작업에 맞는 검증과 선택 모델·업무에서의 확인.
- Rethinking skills and prompts for GPT-6 Astra: 좁은 호출 조건·조건부 참고 자료·업무에 필요한 읽기 범위.
연결
- [비공개 문서]
- [비공개 문서]
- 에이전트 문서 작성
- 장기 자산은 스킬보다 나를 설명하는 언어 기록이다
- 외장뇌 운영
- Second Brain