변경 기록

2026-06-03

• 2026-06-02 Codex Changelog와 Sites 공식 문서를 검토해 Sites preview를 단순 새 기능이 아니라 save version, production deployment, 접근 범위, runtime secret을 분리해야 하는 배포 운영 표면으로 반영.
• Amazon Bedrock 지원은 개인 API 키 편의가 아니라 AWS 관리 인증, 계정 통제, 과금 경계가 걸린 조직 운영 설정으로 분리.
• freshness 모니터 대상에 Sites와 Amazon Bedrock 공식 문서를 추가해 changelog에 새로 등장한 운영 표면을 다음 점검부터 놓치지 않게 보강.

2026-05-25

• 홈 첫 CTA를 독자 경로 선택보다 앞선 처음 10분 실습으로 바꾸고, 파일 하나를 고르는 순간부터 요청서 복사, diff (변경점) 확인, 완료 보고까지 이어지는 실습 보드를 추가.
• 처음 시작 지도, 작업 요청서, 패치 루프의 앞부분에 같은 첫 실습 흐름을 반복 배치해 입문자가 설명을 오래 읽기 전에 바로 작은 작업을 맡겨볼 수 있게 개선.
• 첫 요청과 첫 완료 보고의 성공 기준을 “완벽한 수정”이 아니라 바뀐 파일, 검증 증거, 확인하지 못한 것을 드러내는 handoff (인수인계)로 정리.

2026-05-24

• 2026-05-21 Codex Changelog를 검토해 goal mode 정식화, codex remote-control, permission profile, Appshots, browser-use 개선을 기능 뉴스가 아니라 긴 작업·원격 작업·승인선 운영 기준으로 반영.
• 홈에 바로 가져갈 산출물과 워크숍 안내 영역을 추가해 독자가 얻을 결과와 다음 실습 흐름을 더 빨리 판단하도록 구성 보강.
• 작업 요청서 문서에 7점 품질 점검표와 완료 보고 템플릿을 추가해 요청부터 리뷰 가능한 handoff (인수인계)까지 한 묶음으로 사용할 수 있게 개선.
• 처음 시작 지도에 첫 10분 선택표를 추가해 작업 상황별 실행 표면, 초반 행동, 완료 증거를 바로 고를 수 있게 개선.
• 패치 루프에 패치 품질 기준을 추가해 범위, 원인, 검증, 리뷰성, 회수 가능성, 인수인계를 merge 전 점검하도록 보강.
• 안전선과 승인에 초록/노랑/빨강 위험 등급과 승인 요청 템플릿을 추가해 사람 승인이 필요한 행동을 더 선명하게 분리.
• 병렬·클라우드 운영에 병렬 작업 보드와 자동화 승격 전 질문을 추가해 thread (작업 대화), worktree (작업 책상), automation (자동화)을 실제 운영 단위로 나눌 수 있게 개선.
• 팀 도입 문서에 30일 도입 로드맵과 승인선 매트릭스를 추가해 팀 리드가 PR 템플릿, AGENTS.md, 검증 스크립트로 바로 옮길 수 있는 운영 기준을 보강.
• 공유 미리보기 품질을 높이기 위해 og-image.png와 summary_large_image 메타 태그를 추가.
• GitHub Actions Node.js 20 런타임 경고를 줄이기 위해 checkout, setup-node, upload-artifact action을 Node.js 24 기반 최신 major로 갱신.
• hero 아래 내부 운영 신호처럼 보이던 신뢰 카드를 제거하고, 워크숍 표지 caption을 독자가 얻는 실습 결과 중심으로 수정.
• 첫 화면 hero 이미지는 축소 시 작은 글자가 흐려지지 않도록 요청 → 검증 → 인계의 큰 흐름만 남긴 단순 카드로 교체.
• 초중급자 독자 관점 점검 결과, 홈에서 읽기 경로를 산출물보다 먼저 보이게 순서를 조정하고 워크숍 안내를 독자 행동 중심 문장으로 교체.
• 모바일에서 작업 요청서와 승인 예시 코드 블록이 가로로 길게 느껴지지 않도록 작은 화면에서는 코드 줄바꿈을 허용.
• 각 문서 끝에 현재 문서의 다음 행동과 연결되는 다음 선택 추천 카드를 추가해 단순 이전/다음 이동보다 학습 흐름을 더 명확하게 개선.
• 모바일 문서 가독성을 위해 과한 단어 단위 줄바꿈을 줄이고, 정적 배포 구조를 유지한 채 CSS-only hover/focus/motion 효과를 추가.

2026-05-19

• 2026-05-23 전체 문서의 어려운 작업 용어를 전수 점검해 공식 기능명과 통용 용어는 유지하되 diff (변경점), handoff (인수인계), worktree (작업 책상), automation (자동화)처럼 쉬운 뜻을 함께 병기하는 기준을 용어집과 주요 문서에 반영.
• 2026-05-23 입문자가 패킷을 네트워크 용어로 오해하지 않도록 화면 명칭을 작업 요청서로 바꾸고, placeholder 메일 CTA를 준비 중 안내와 대기자 신청 전환 예정 문구로 교체.
• 2026-05-23 OpenAI 공식 Codex use cases 페이지를 다시 확인하고, 프론트엔드 프로토타입, 멀티파일 리팩터링, 버그 triage, 문서화, MCP 자동화를 작업 요청서와 완료 증거로 번역하는 기준 추가. 공통 내비게이션 변경으로 모든 문서가 바뀐 것처럼 보이지 않게 freshness hash를 본문 중심으로 보정.
• OpenAI 공식 Codex 문서와 현재 플레이북을 비교해 IDE extension, Codex app, CLI, Web/Cloud 실행 표면 설명을 보강.
• sandbox와 approval을 분리해 설명하고, cloud 환경의 setup 단계, agent 작업 단계, 인터넷 접근, secret 취급 기준 추가.
• 외부 문서, issue, log, MCP/browser 결과 안의 명령형 문장을 신뢰하지 않는 trust boundary 기준 추가.
• Skills, Plugins, MCP, Subagents를 반복 절차, 설치 가능한 묶음, 외부 도구 연결, 병렬 agent 운영 기준으로 나누어 설명.
• codex exec, GitHub Action, remote connection, Memories/Chronicle, auto-review를 자동화·팀 운영의 별도 판단 기준으로 추가.
• 작업 요청서, 패치 루프, 안전선과 승인, 팀 도입에 좋은 요청/나쁜 요청, 완료 보고, 승인선, PR 템플릿 예시를 추가.
• build 후 정적 HTML의 내부 링크를 확인하는 check:links 검증 게이트 추가.
• 반복 작업을 작업 요청서, 템플릿, Skill, Codex용 CLI, eval, non-interactive/CI 중 어디로 승격할지 판단하는 기준 추가.
• 팀 도입 문서에 모바일 레이아웃, 링크, AI 품질, 승인선, handoff (인수인계) 같은 반복 위험을 실행 가능한 검증 자산으로 고정하는 표 추가.
• 용어집에 goal, Codex용 CLI, eval을 추가해 긴 작업과 자동 검증을 입문자 눈높이로 설명.
• Claude Code 플레이북 운영 사이트를 기능 근거가 아니라 공개 문서 허브 운영 참고로 비교하고, robots.txt, sitemap 생성, Vercel redirect 동기화, deploy surface 검사, 홈 CTA 개선을 반영.
• 모바일 문서 폭이 지나치게 좁아지던 CSS 제한을 완화하고, 문단과 독자 칩이 화면 밖으로 밀리지 않게 조정.
• 핵심 의존성의 latest 지정을 현재 lockfile 버전으로 고정해 배포 재현성을 높임.
• OpenAI 공식 Codex 문서 변경을 감지하는 별도 freshness workflow와 Telegram 알림 경로를 추가하고, Cloudflare Pages를 주 운영면, Vercel을 mirror로 두는 배포 운영 기준을 README에 정리.
• 2026-05-18 Codex CLI 0.131.0 changelog를 확인해 codex doctor를 CLI 진단 증거로 추가하고, 공용 Telegram 알림 bot에서 프로젝트명이 드러나도록 freshness report를 보강.
• 공용 Telegram 알림 bot에서 바로 읽을 수 있도록 freshness report 제목, 요약, 검토 흐름, 변경 항목을 한국어 메시지로 전환.
• Telegram 알림은 사람이 바로 판단할 수 있는 변경 여부·문서명·상세 로그 링크만 짧게 보내고, 상세 검토 흐름은 GitHub summary로 분리.

2026-05-14

• 기존 문서형/콘솔형 홈을 버리고 Codex로 일하는 표준 플레이북 허브로 전환.
• Starlight 화면 구조를 제거하고 Astro 기반 커스텀 홈·문서 레이아웃으로 재구현.
• 독자 흐름을 처음 시작 지도 → 작업 요청서 → 패치 루프 → 안전선과 승인 → 병렬·클라우드 운영 → 팀 도입으로 재정렬.
• 공개 플레이북에서 실전 학습으로 자연스럽게 이어질 수 있도록 홈에 대상별 경로와 실전 워크숍 섹션 추가.

2026-04-21

• 이전 학습서형 구조를 제거하고 Codex 실행 표면 중심 IA로 재기획.
• /map, /control-plane, /patch-loops, /cloud-ops, /team-system, /packets, /reference 공개 URL 추가.
• 공식 Codex 제품 표면을 기능 기준으로 삼고, 참고 PDF는 운영 문제의식으로만 분리.

2026-04-26

• 홈 첫 화면을 “누가 무엇을 얻는가” 중심으로 재작성.
• 공식 문서, 제공 PDF, 플레이북 자체 해석을 자료 근거·FAQ에 분리.
• 각 핵심 문서에 난이도와 쉬운 설명을 추가.
• sidebar를 처음 보기, 실전 작업, 팀과 확장, 출처와 기준으로 재정리.

업데이트 원칙

• Codex 기능 사실은 OpenAI 공식 문서 기준으로 확인합니다.
• 참고 PDF는 문장이나 구조가 아니라 문제의식만 반영합니다.
• 운영 패턴은 “권장 운영 방식”으로 분리합니다.
• 주요 문서에는 안전선, 검증 증거, handoff (인수인계) 기준을 포함합니다.