생성된 수정이 하나의 모듈을 벗어나지 않도록 막는 페어링 매니페스트

생성된 패치는 페어링(pairing) 과정에서 특정 재작성 세트와 소유자가 지정될 때까지 노트북에 머물러야 합니다. 이 예시에서 사용된 결정은 해당 세트를 벗어난 모든 변경 경로를 거부하는 매니페스트입니다. 자유 모델(free model)은 매니페스트가 존재한 후에만 초안을 작성할 수 있으며, 자유 서버(free server)는 나중에 건조 실행(dry run)만을 받을 수 있습니다. 로컬 검사기(local checker)가 먼저 실행되므로, 너무 광범위한 수정이 공유 호스트에서 원격 실험으로 절대 변하지 않습니다.

세션이 보호했던 것들

공유 모듈은 생성된 초안이 아무도 변경할 계획이 없었던 인접 파일을 건드리면서 조용하게 실패하는 경우가 있습니다. 재시도 도우미(retry helper), 패키지 초기화기(package initializer), 샘플 설정 파일(sample config) 등은 관련 있어 보일 수 있지만, 서로 다른 롤백 비용을 가집니다. 이 예시는 도우미의 사소한 버그에서 시작하여 전체 패키지를 정리하자는 유혹적인 제안으로 확장됩니다. 선임 개발자는 어떤 원격 호스트가 계획에 들어가거나 트리를 복사받기 전에 그 확장을 거부했습니다.

메모지에 적힌 선임 개발자의 질문들

선임 개발자는 더 긴 프롬프트나 패키지 전체에 걸친 광범위한 정리 작업을 요청하지 않았습니다. 메모에는 어떤 경로가 범위 내에 있는지, 누가 롤백할 것인지, 그리고 패치가 커지지 않았음을 보여줄 증거가 무엇이었는지가 기록되었습니다. 이 세 가지 항목은 전체 세션 동안 터미널 옆에 그대로 남아 있었고 채팅 로그로 대체되지 않았습니다. 그 메모는 아무도 다시 읽지 않을 두 번째 설계 문서라기보다는 재작성 세트(rewrite set)가 되었습니다.

1. 이번 페어링에서 어떤 경로들이 변경될 수 있으며, 어떤 경로는 나중 작업을 위해 고정되어야 합니까?
2. 검사 후에 자유 서버에서 나중에 건조 실행이 실패할 경우 누가 롤백을 소유합니까?
3. 첫 번째 로컬 검사 이후에 재작성 초안(redraft)이 경로를 추가하지 않았음을 보여주는 반복된 diff는 무엇입니까?

페어는 파일 목록, 이름이 지정된 소유자(named owner), 그리고 두 번째 diff를 제시한 후, 노트에 프로세스를 추가하는 것을 중단했다. 모델이 알 것이라고 주장하는 것과 같은 모호한 답변은 세션을 아래의 막다른 길로 되돌렸다. 노트가 받아들여진 것은 각 답변이 파일, 사람 또는 명령을 가리킬 때뿐이었다.

페어가 폐기한 막다른 길

첫 번째 막다른 길은 헬퍼(helper), 패키지 초기화(package init), 그리고 샘플 설정(sample config)을 한꺼번에 재작성하는 초안이었다. 프롬프트는 일관된 변경을 요청했지만, 모델은 일관성을 방황할 수 있는 허가로 취급했다. 두 번째 막다른 길은 diff가 경계 지어지기 전에 무료 서버에서 라이브 테스트를 제안했다. 세 번째는 녹색 단위 테스트(green unit test)를 패치에 마이그레이션(migration)을 포함할 수 있는 허가로 간주했다.

폐기된 각 옵션은 세션에서 시간을 절약한다는 편리한 이야기 뒤에 다른 소유자를 숨기고 있었다. 정리 작업은 버그 수정과 다른 사람이 이미 검토하고 있을 수 있는 스타일 편집을 혼합했다. 초기 서버 실행은 이름이 지정되지 않은 소유자가 있는 경계 없는(unbounded) 작업 트리에서 공유 호스트를 사용했을 것이다. 마이그레이션 아이디어는 데이터 변경을 재시도 조정(retry tweak)에 결합했을 것이므로, 페어는 매니페스트 이전에 세 가지 모두를 포기했다.

막다른 길 이후 남은 단계들

아래의 워크플로우는 같은 종류의 페어링을 제안하는 것으로, 측정된 사례 연구로 오해받지 않도록 라벨이 지정되었다. 각 단계에는 눈에 보이는 아티팩트(artifact)가 있으며, 누락된 아티팩트는 우회 방법을 유도하기보다는 세션을 중단시킨다. 무료 모델과 무료 서버는 파일 경계가 이미 작성된 후에 의도적으로 늦게 나타난다. 소유자 이름이 누락되면 경로 목록이 충분히 좁아 보일 때조차 세션이 중단된다.

1. 허용된 경로를 한 줄에 하나씩 작성하고 롤백 소유자를 명시하는 주석을 포함하여 rewrite-set.txt 파일을 작성합니다.
2. 모델이 헬퍼나 그 테스트를 다시 작성하도록 요청하기 전에, 작업 트리(working tree)에 대해 검사기(checker)를 실행합니다.
3. 만약 검사기가 추가 경로를 출력하면, 매니페스트를 확장하는 대신 해당 경로를 복원하고 프롬프트를 축소합니다.
4. 허용된 경로 내부에서만 초안을 요청한 다음, 결과로 나온 diff에 대해 다시 검사기를 실행합니다.
5. 두 번째 검사기가 상태 코드 0으로 종료된 후에만 드라이 런(dry run)을 무료 서버에 지정합니다.
6. 소유자가 실행할 수 있는 롤백 명령 하나를 기록하고, 그 명령이 불분명하면 세션을 중지합니다.

페어링이 유지한 검사기 (The checker the pairing kept)

아래 스크립트는 저장소가 이미 이 게이트(gate)를 강제한다는 주장이 아니라, 검토용으로 작성된 미실행 예시입니다. 이는 매니페스트를 읽고 변경된 경로 목록을 나열하며, 어떤 경로라도 허용된 세트에 없으면 실패합니다. 이것은 허용된 파일이 의미적으로 정확한지, 배포하기 안전한지, 또는 비밀 정보가 없는지를 판단하지 않습니다. 단지 페어링이 이미 문서로 선택한 경계를 보존할 뿐이며 수동으로 되돌릴 수 있습니다.

#!/usr/bin/env python3
"""미실행 예시: 유지된 rewrite 세트 외부의 Git 경로 거부."""

...

이 검사기는 스테이징되지 않은 이름, 스테이징된 이름, 그리고 Git이 이미 무시하는 트래킹되지 않은 이름을 결합합니다. 매니페스트와 일치하는 경로는 여전히 이 스크립트에 의해 읽히지 않으므로, 허용된 파일 내부의 잘못된 변경은 통과할 수 있습니다. 리네임(Renames)은 이전 경로를 숨길 수 있으며, 무시되는 파일(ignored files)은 절대 나타나지 않으므로, 이러한 경우는 인간이 트리를 살펴봐야 합니다. 이 스크립트는 페어링을 위한 경계 알림일 뿐, 규제된 릴리스 트레인(regulated release train)을 위한 정책 엔진이 아닙니다.

샘플 매니페스트는 소유자 라인이 세션 중 인간 검토자에게 보이도록 짧게 유지됩니다. 체커는 주석을 무시하므로, 사람이 허용 로직을 변경하지 않고도 롤백을 기록할 수 있습니다. 경로를 추가하는 것은 새로운 페어링 결정이며, 헬퍼의 수정(redraft) 중에 이루어진 편의 편집이 아닙니다. 광범위한 매니페스트는 패키지 정리(package cleanup)가 나타났을 때 시니어(senior)가 이미 거부했던 막다른 길을 재현합니다.

# owner: platform pairing, rollback: git checkout -- src/retry.py
src/retry.py
tests/test_retry.py

로컬 명령어는 평범하며 어느 시점에서도 모델이나 원격 호스트를 호출하지 않습니다. 실패하는 실행은 누군가 초안 도구(draft tool)를 열기 전에 추가 경로를 출력하고 0이 아닌 상태 코드를 반환해야 합니다. 성공하는 실행은 단순히 이름들이 시니어가 터미널 옆에 보관했던 메모와 일치한다는 의미일 뿐입니다. 검토자들은 공유 호스트에서 어떤 건식 실행(dry run)이 예약되기 전에도 여전히 그 이름들 내부의 diff를 읽습니다.

python3 check_rewrite_set.py
git diff -- src/retry.py tests/test_retry.py

세 가지 종료 코드 연습 방법

연습은 로컬에서 이루어지며 임시 저장소(temporary repository)를 사용하므로 예제가 공유 호스트에 영향을 미칠 수 없습니다. 아래 단계들은 세 가지 종료 코드를 보고자 하는 검토자를 위한 실행되지 않은 지침입니다. 이들이 성공하는 트리가 행동적으로 올바르거나 어떤 공유 호스트에 준비되었다는 것을 증명하지는 않습니다. 단지 매니페스트가 누락되거나 초과될 때 경로 경계가 닫힘 실패(fails closed)를 보이는 것만을 보여줍니다.

1. 임시 Git 저장소를 생성하고, 두 개의 허용된 파일을 커밋한 다음, 그 옆에 샘플 매니페스트를 추가합니다.
2. 깨끗한 트리에서 체커를 실행하고 상태 0을 예상합니다. 왜냐하면 빈 변경 목록(empty change list)은 세트를 위반할 수 없기 때문입니다.
3. 세트 외부에 추적되지 않은 메모를 추가하고, 체커를 실행하며 경로가 출력되면서 상태 1을 예상합니다.
4. 매니페스트를 제거하고, 어떤 초안 도구가 열리기 전에 체커를 실행하며 상태 2를 예상합니다.

페어가 옵션을 비교한 방법

비교표는 세션 검토 보조 자료일 뿐이며, 도구나 호스트의 벤치마크가 아닙니다. 타이밍 수치, 토큰 총량 또는 하드웨어 결과는 이 세션 비교의 행에 포함되어서는 안 됩니다. 유효한 행은 페어가 단 하나의 문장으로 실패 모드를 설명할 수 있는 경우뿐입니다. 다른 행들은 나중에 읽는 독자가 습관적으로 이를 부활시키지 않도록 거절된 대안으로 남겨둡니다.

무료 모델과 무료 서버가 적합한 경우

공개: 이 문서는 MonkeyCode의 제품 홍보의 일환으로 작성되었습니다. MonkeyCode는 재작성 세트가 존재하는 후에만 방법을 적용하며, 운영자가 설명하는 무료 모델 접근 방식 내의 초안 작성 보조 자료로 작동합니다. 동일한 운영자 메모는 검사기가 깨끗하게 종료된 후의 드라이-런 단계에 적합한 무료 서버 옵션을 설명합니다. 이 초안은 모델, 할당량, 하드웨어 또는 기간을 명시하지 않는데, 이러한 용어들은 여기서 검증되지 않았으며 변경될 수 있기 때문입니다.

독자들은 어느 한쪽의 무료 옵션도 자신의 작업에 이용 가능하다는 것으로 간주하기 전에 현재 제품 약관을 확인해야 합니다. 무료 서버는 공유 편의 시설일 뿐이며, 운영 환경 대체재가 아니며, 명시된 소유자를 대신할 수 없습니다. 드라이-런은 여전히 잘못된 재시도 루프, 누락된 피처(fixture), 또는 노트북에서 절대 나가지 말았어야 할 로그 라인을 드러낼 수 있습니다. 만약 그 실행이 실패한다면, 소유자는 기록된 롤백을 사용하고 호스트를 만족시키기 위해 매니페스트를 넓히지 않습니다.

나중의 초안은 동일한 허용 경로와 터미널 옆의 동일한 소유자 메모에서 다시 시작합니다. 무료 옵션 중 어느 것도 추가 경로가 프롬프트 문제라기보다는 실패한 페어링이라는 규칙을 변경하지 않습니다. 초안 작성 도구는 요청된 수정이 좁게 유지되도록 작업 노트에 매니페스트 텍스트를 받아야 합니다. 만약 도구가 그 제약을 수용할 수 없다면, 페어링은 노트북에서 멈추고 서버를 열지 않습니다.

이 경계를 건너뛰어야 하는 사람

이 경계는 프로덕션 인시던트, 비밀 키 로테이션(secret rotation), 또는 이미 공식 통제 위원회(formal control board)를 거친 변경 사항에 사용되어서는 안 됩니다. 또한 실제 위험 요소가 허용된 단일 파일 내부에 존재하는 경우에도 적합하지 않은데, 올바른 경로 목록이라도 잘못된 권한 확인을 숨길 수 있기 때문입니다. 롤백 담당자를 지정할 수 없는 팀은 어떠한 공유 호스트(shared host)에도 패치를 전송해서는 안 됩니다. 검사기(checker)에서의 제로 종료(zero exit)는 배포를 승인하는 것이 아니라 경계 결과일 뿐입니다.

작성된 예제는 보고서가 아니며, 장애 방지나 팀의 절약 시간 등을 다루고 있지 않습니다. 어떠한 고객 성과도 주장되지 않으며, 이 스크립트는 해당 계정에서 실행된 일련의 작업으로 제시되지 않습니다. 제로 종료를 계속 진행할 수 있는 권한으로 간주하기 전에 매니페스트(manifest)를 실제 리포지토리 레이아웃에 맞게 조정해야 합니다. MonkeyCode로 초안을 작성하는 독자들은 이 매니페스트를 게이트(gate)로 유지하고, 검사기가 깨끗하게 종료된 후에만 무료 서버를 사용해야 합니다.