코덱스 토큰 규율

Codex Token Discipline

목적

작업 성공, 필수 증거, 또는 요청된 결과물을 약화시키지 않으면서 전체 루트 및 하위 비용을 줄입니다.

읽기, 도구 출력, 재시도, 위임을 제한합니다. 재사용 가능한 증거는 보존하고 해결되지 않은 부분만 에스컬레이션합니다.

운영 프레임

행동을 변경하는 것만 사용합니다:

1. 현재 단계 이름 지정: 탐색, 계획, 구현, 검증, 게시, 또는 인계.
2. 광범위하게 읽기 전에 필요한 다음 증거를 정의합니다.
3. 잠재적으로 노이즈가 많은 도구 호출 전에, 가장 작은 유용한 반환 형태와 출력 예산을 정의합니다.
4. 노이즈가 많은 부수 작업은 증거와 함께 요약된 결과를 반환할 수 있을 때만 위임합니다.
5. 단계 경계에서 간결한 재개 상태를 저장하고, 담당 디렉터가 있는 경우 세션 연속 결정을 해당 디렉터에게 넘깁니다.

작은 편집, 직접적인 답변, 간단한 명령어에는 이 의식을 건너뜁니다.

사전 점검 출력 계약

과도한 출력이 메인 컨텍스트에 들어가기 전에 방지합니다. 이후에 요약하는 것에 의존하지 마십시오.

• 예측 불가능하거나 배치 명령어의 경우, 먼저 필요한 반환 형태를 지정합니다: 상태, 개수, 경로, 선택된 필드, 또는 첫 번째 실행 가능한 실패.
• 도구 호출에 유한한 반환 예산을 설정합니다. exec 계열 호출의 경우, 명명된 증거가 더 많이 필요하지 않은 한 2,000 토큰 이하의 명시적 예산을 기본값으로 설정합니다. 단일 대량 출력 임계값을 기다리지 마십시오.
• 소스에서 필터링, 집계, 또는 선택합니다. 테스트 및 빌드의 경우, 종료 상태, 첫 번째 실행 가능한 실패, 명령어를 반환하고 더 자세한 정보를 요청하기 전에 이 정보를 제공합니다.
• 전체 출력이 나중에 검사에 유용한 경우, 이를 작업 로컬 또는 임시 아티팩트에 쓰고 경로, 크기, 간결한 요약, 첫 번째 실행 가능한 실패만 반환합니다. 필요에 따라 아티팩트에서 제한된 조각을 검사합니다.
• 소스에서 줄일 수 있는 일회성 출력을 위해 아티팩트를 생성하지 마십시오.

요약 우선 읽기

좁게 시작하고, 다음 결정을 변경할 때만 넓힙니다.

• 파일을 열기 전에 rg 또는 파일 목록으로 검색합니다.
• 전체 diff보다 git diff --stat, git diff --name-only, 특정 git diff -- <path>, 대상 sed -n 범위를 선호합니다.
• 로그 및 명령 출력의 경우, 전체 기록보다 tail, head, jq, 개수, 필터, 오류 검색을 사용합니다.
• 반환된 모든 도구 결과를 향후 입력 비용으로 간주합니다. 전체 출력보다 개수, 경로, 요약, 선택된 증거를 선호합니다.
• 실패 후, 저장된 아티팩트에서 확장하거나 가장 작은 실패 범위만 다시 실행합니다. 메인 스레드에서 반복적인 전체 기록을 피합니다.

광범위한 읽기가 필요한 경우, 이유를 명시하고 가장 작은 유용한 범위로 제한합니다.

장기 실행 작업

단계 변경을 컨텍스트 체크포인트로 처리합니다.

• 구현 또는 저장소/작업 전환 전에, 결론, 다음 결정, 가장 가까운 다음 단계, 가장 작은 유용한 경계를 보존합니다.
• project-context를 사용하는 저장소에서는 간결한 현재 상태를 위해 BRIEF.md를, 증거를 위해 로그를 선호합니다.
• 디렉터가 장기 실행 작업을 조정하는 경우, 체크포인트를 보고하고 디렉터가 계속, 인계, 또는 세션 순환 여부를 결정하도록 합니다. 무조건 새로운 세션을 처방하거나 시작하지 마십시오.
• 디렉터가 없는 경우, 저장된 표면이 계속하기에 충분하고 사용자 또는 소유 워크플로가 요청할 때만 새로 시작합니다.

대화 규모를 보상하기 위해 기록, 검증 매트릭스, 파일 인벤토리를 저장하지 마십시오.

하위 에이전트

위임이 본질적으로 더 저렴하지는 않습니다. 간결하고 독립적으로 유용한 증거나 출력을 반환할 수 있는 제한된 작업에 대해 가장 좁은 명명된 에이전트를 사용합니다.

하나의 에이전트로 시작합니다. 독립적이고 겹치지 않는 범위만 병렬화합니다. 동일한 조사를 중복하지 말고, 통합 후 에이전트를 유지하지 말며, 여전히 유효한 검증을 반복하지 마십시오.

범위, 쓰기 경계, 완료 조건, 검증, 예상 간결한 출력을 프롬프트합니다. 하위 에이전트는 위임하지 말아야 합니다.

브라우저 및 UI 루프

반복적인 시각적 또는 브라우저 검증 전에, 확인할 상태를 기록합니다.

• 명명된 상태당 하나의 스크린샷 또는 브라우저 패스를 선호합니다.
• 검사가 실패하면, 가장 작은 소유자를 검사합니다: 콘솔 오류, DOM 상태, 라우트 데이터, 또는 집중된 컴포넌트.
• 이미지, base64 스크린샷, 전체 본문 텍스트, DOM 덤프는 해당 아티팩트 자체가 다음 결정에 영향을 미치지 않는 한 메인 스레드에 보관하지 마십시오.
• 명명된 상태가 검증되거나 구체적인 차단 요소가 분리되면 중단합니다.

항상 읽는 표면

글로벌 또는 저장소 명령어의 모든 줄은 반복 비용이 있습니다.

• 지속적인 행동 규칙과 안전 경계는 AGENTS 스타일 파일에 넣습니다.
• 반복 가능한 워크플로는 스킬에 넣습니다.
• 현재 작업 상태는 저장소 작업 문서에 넣습니다.
• 현재 재사용 가능한 도메인 사실은 참조 문서에 넣습니다.
• 이를 문서화하는 대신 오래된 프로필, 중복 명령어, 역사적 설명을 제거합니다.

항상 읽는 파일을 편집할 때, 절차 텍스트보다 짧은 라우팅 규칙을 선호합니다.

사용 감사

토큰이 어디에 사용되었는지 질문을 받으면, 설치된 이 스킬 디렉토리 기준으로 scripts/summarize_codex_usage.py를 확인하고, --help와 함께 실행한 후, 명시적 --cwd-prefix로 감사합니다.

이 스크립트는 Codex 롤아웃 로그를 루트 스레드별로 그룹화하고, 원시 페이로드 없이 토큰 합계, 캐시된 입력 비율, 하위 세션 토큰 점유율, 도구 출력 볼륨, 대량 출력 이벤트, 최고 출력 도구 신호를 보고합니다.

토큰 합계를 품질이 아닌 신호로 처리합니다. 홈 전체 텍스트 검색을 피하고, $CODEX_HOME/sessions 또는 다른 명시적 세션 루트로 스크립트를 지정합니다.

최종 확인

• 메인 스레드가 현재 결정에 필요한 증거만 수신했습니까?
• 노이즈가 많은 도구 작업이 실행 전에 반환 형태와 예산을 가졌으며, 전체 세부 정보는 유용할 때만 아티팩트에 보관되었습니까?
• 대규모 읽기, 브라우저 루프, 하위 에이전트가 명시적 질문으로 제한되었습니까?
• 재개 가능한 상태가 올바른 표면에 있으며, 소유 디렉터가 계속/인계/순환 결정을 유지했습니까?
• 항상 읽는 지침이 짧게 유지되고 세부 사항을 다른 곳으로 라우팅했습니까?