1. 문서에 반영할 변경 사항을 알려 주세요.

   관련 브랜치, pull request, 커밋, 이슈 또는 파일을 공유하세요. 공개 문서라면 미공개 로드맵, 고객의 비공개 정보, 내부에서만 공유하는 컨텍스트는 제외하라고 명시하세요.

2. Codex에 변경 사항을 반영해야 할 문서를 찾아 달라고 요청하세요.

   초안을 작성하기 전에 기존 문서에서 기능 이름, 설정 키, 명령어, 예시, 관련 용어를 검색하도록 하세요.

3. 변경 사항을 설명하는 데 필요한 부분만 업데이트하세요.

   Codex가 기존 페이지 구조, 용어, 문서 간 링크, 프런트매터를 유지하도록 하세요. 정확한 설명이나 예시를 추가하거나 특정 섹션을 수정하는 것만으로 충분하다면 문서를 대대적으로 다시 쓰지 않도록 하세요.

4. 변경 사항을 검증하세요.

   Codex에 레포지토리에 맞는 서식 검사와 문서 검사를 실행한 뒤, 사용자에게 안내하는 각 내용의 근거를 요약해 달라고 요청하세요.

Codex에 제공할 자료

공개 릴리스 노트 등 참고 자료를 더 제공하면 Codex가 비공개 컨텍스트나 아직 공개되지 않은 변경 사항을 문서에 포함하는 일을 피할 수 있습니다.

워크플로우 재사용하기

레포지토리 전체에서 같은 문서 작성 기준을 따르도록 AGENTS.md에 다음과 같이 지침을 추가하세요.

## Documentation

- When user-facing behavior changes, check whether docs, examples, or changelogs need updates.
- Public docs must only include public information or behavior visible in this repo.
- Preserve existing terminology and frontmatter.
- Run the docs formatting and build checks before final handoff.

절차에 단계가 더 많다면 스킬로 만들어 두세요. 이후 Codex 작업에서도 같은 절차에 따라 자료를 확인하고 초안을 작성한 뒤 검증할 수 있습니다. 자세한 내용은 워크플로우를 스킬로 저장하기를 참고하세요.

현재 채팅에서 이 워크플로우를 예약 작업으로 설정할 수도 있습니다. 예를 들어 Codex에 매주 GitHub에서 최근 pull requests를 가져와 문서를 업데이트해 달라고 요청하세요.