부록 B - 공식 문서와 실행으로 직접 확인하기

이 장에서 배우는 것

기능 주장 하나를 문서·버전·더미 실험·판정으로 나누고 변경 이력을 따라 재검증한다.

먼저 확인할 문장을 한 문장으로 쓴다

공식 문서를 찾아보라는 말만으로는 조사의 끝을 알기 어렵다. 이 도구는 프로젝트 규칙을 어떤 경로에서 읽는가처럼 질문을 한 문장으로 고정한다. 공식 문서의 제목, 최종 URL, 대상 제품과 실행 형태를 적는다. 문서가 다른 경로로 이동했다면 최종 주소와 이동 사실을 기록한다. 검색 결과의 짧은 요약만 보고 확인 완료로 표시하지 않는다.

문서에서 설명한 기본값과 내 환경의 실제 설정은 다를 수 있다. 조직 관리 설정이나 하위 폴더 규칙이 있는지 확인한다. 특정 기능을 찾지 못했다고 기능이 없다고 결론 내리지 않는다. 추가 확인에 필요한 질문을 적으면 다음 조사자가 같은 시행착오를 반복하지 않을 수 있다.

작은 실행 시험은 실제 자료 없이 만든다

규칙 파일이 적용되는지 확인하려면 더미 저장소에 한 줄짜리 문구 규칙을 만들 수 있다. 실제 키나 고객 자료가 있어야만 시험할 수 있는 것은 아니다. 테스트할 입력, 실행한 명령, 작업 폴더, 도구 버전, 기대 결과, 실제 결과를 남긴다. 실험에 유료 계정이나 외부 변경이 필요하면 문서 확인 상태와 실행 확인 상태를 나눈다.

예를 들어 규칙대로 출력 문자열이 바뀌었더라도 왜 바뀌었는지 하나의 실험으로 단정하기 어렵다. 요청문에 같은 규칙을 이미 썼다면 지침 파일의 효과를 따로 확인하지 못한 것이다. 실험 조건에서 바꾼 요소를 하나로 좁히고 관찰과 해석을 구분한다.

다시 검수할 때 무엇을 비교할까

분기별 검수는 날짜를 고치는 작업이 아니다. URL이 살아 있는지, 문서가 같은 기능을 가리키는지, 질문 문구와 표본이 같은지, 예제가 현재 환경에서 실행되는지 확인한다. 변경된 주장에 연결된 원고와 표를 찾고 수정한다. 내용이 달라지면 카탈로그 해시도 다시 계산해야 한다.

확인 실패도 결과로 남긴다. 페이지를 열 수 없었다는 사실은 해당 기능이 사라졌다는 증거가 아니다. 현재 사실로 단정할 근거가 부족하다는 뜻이다. 본문을 이미 공개했다면 해당 문장을 한정하거나 재검수 대상으로 표시하고, 확인하지 않은 최신값으로 채우지 않는다.

직접 해 보기

이전 장에서 사용한 지침 파일 규칙 하나를 고르고 문서 확인표를 만든다. 실행할 수 있으면 더미 저장소로 시험하고, 실행하지 못하면 그 이유와 다음에 필요한 조건을 적는다.

해설과 확인 기준

문서의 지원 설명과 내 계정에서의 실행 결과를 별도 칸에 기록하면 완료다. 페이지 접근 실패를 미지원으로 쓰거나 검색 요약을 공식 열람으로 적으면 안 된다. 다음 검수자가 원문과 시험 조건을 재현할 수 있는지가 기준이다.

근거와 기준일

제품·자료 확인일: 2026-11-08. 설명 틀·대출 도구·연습·해설은 교재의 자체 구성이다. 제품별 세부 조건은 아래 공식 문서에서 해당 실행 방식과 계정 범위를 다시 확인한다.

• Codex 프로젝트 지침
• Git worktree 공식 문서