카테고리

툴과 개발 환경

1인 운영을 떠받치는 머신, 에이전트 환경, 원격 접속, 알림 셋업 기록.

전체 글

저장소 루트에 빌드 스크립트 세 개와 자막·내레이션 파일이 현행 디렉터리와 섞여 있는 모습, 그리고 legacy/로 분리된 뒤의 모습

툴과 개발 환경2026-09-237 분 읽기

죽은 실험이 현행 엔진 폴더 안에서 살고 있었습니다

저장소 루트에 빌드 스크립트가 세 개 있었습니다. 진짜 문제는 그 세 개가 아니라, 현행 파이프라인 디렉터리 안에 섞여 있던 v1 테스트 파일 하나였습니다. 값싼 수정은 없었고, 결국 옮기기만 하고 판단은 미뤘습니다.

#git#repo-hygiene#legacy-code#pipeline

개념 도식: type 파라미터가 필터가 아니라 서로 다른 데이터셋을 고르는 값임을 보여주는 대조도

툴과 개발 환경2026-09-167 분 읽기

고속도로 카메라는 처음부터 한 대도 없었습니다

도로 CCTV 앱을 안드로이드로 포팅하다 알았습니다. type 파라미터는 필터가 아니라 데이터셋 선택이었고, 앱은 국도 데이터셋만 부르고 있었습니다.

#api#debugging#gotchas#verification

개념 도식: 46개 앱 중 20개가 같은 에러로 실패하고, 그중 리포에 흔적을 남겨야 하는 건 2개뿐임을 보여주는 도식

툴과 개발 환경2026-09-167 분 읽기

Xcode를 올렸더니 앱 20개가 같은 에러로 멈췄습니다

46개 앱을 실빌드로 훑었더니 20개가 컴파일에 실패했습니다. 원인은 제 코드가 아니라 SDK 안에서 컴파일러가 자동 합성한 생성자였습니다.

#ios#build#tooling#verification

개념 도식: 첫 턴이 있는 앱과 없는 앱의 발화 비율 비교가 가설을 반증하는 구조

툴과 개발 환경2026-09-157 분 읽기

원인을 확정하기 전에 수정을 출하했고, 대조군이 저를 반증했습니다

세션의 68%에 출력 토큰이 0이라 '앱이 먼저 말을 안 걸어서'라고 결론냈습니다. 그 가설을 반증한 건 이미 그 기능을 갖고 있던 형제 앱이었습니다.

#reality-check#verification#debugging#ios

개념 도식: 토큰이 session-end 에서만 기록되므로 session-end 가 없는 세션은 언제나 토큰 0이 되는 구조

툴과 개발 환경2026-09-157 분 읽기

세션의 19%가 무음이라고 읽었는데, 그 지표는 자기 자신을 볼 수 없었습니다

음성 앱 세 개의 세션 271건에서 오디오 토큰이 0인 것을 세고 오디오 결함을 팠습니다. 절반쯤 가서야 그 숫자가 관찰이 아니라 동어반복이라는 걸 알았습니다.

#analytics#verification#debugging#gotchas

개념 도식: 빌드 세팅 하나가 합성한 isolated deinit이 슬랩 할당 메모리를 free로 반납해 abort하는 경로

툴과 개발 환경2026-09-0913 분 읽기

빌드 세팅 한 줄이 테스트 61건을 부팅 중에 죽였습니다

기본 액터 격리를 메인 액터로 두는 세팅은 deinit을 직접 쓰지 않은 클래스에만 isolated deinit을 합성합니다. 아무것도 안 쓴 클래스만 위험합니다. 직관과 반대입니다.

#ios#debugging#verification#build

개념 도식: 0건 실행과 전건 통과를 구분하지 못하는 TEST SUCCEEDED 출력

툴과 개발 환경2026-09-097 분 읽기

0건을 실행하고 "테스트 성공"이라고 찍혔습니다

새 테스트 프레임워크에서는 -only-testing이 매칭에 실패해도 에러가 아닙니다. 0건을 실행하고 TEST SUCCEEDED를 냅니다. RED를 확인하려던 실행이 초록으로 끝났습니다.

#verification#tooling#ios#gotchas

개념 도식: 전체 화면 픽셀 비교에서 헤더 타이머만 변해도 통과 판정이 나오는 구조

툴과 개발 환경2026-09-0910 분 읽기

헤더의 초 단위 타이머가 무엇을 해도 테스트를 통과시켰습니다

제스처 배선은 순수 함수로 뺄 수 없어 픽셀 변화로 쟀습니다. 그 판정을 조용히 무의미하게 만드는 것이 셋 있었고, 셋 다 실제로 밟았습니다.

#verification#methodology#debugging#gotchas

두 패널 도식. 왼쪽은 파싱 검증이 31개 앱 전부를 통과시키는 모습으로, 존재하지 않는 멤버를 부르는 코드도 문법적으로는 완벽하다는 점을 보여준다. 오른쪽은 타입체크가 31개 앱 전부를 실패시키며 없는 멤버 오류를 내는 모습과, 문자열 grep이 소속을 말해주지 않는다는 점을 보여준다.

툴과 개발 환경2026-09-076 분 읽기

31개 앱이 전부 검증을 통과했고, 전부 컴파일에 실패했습니다

앱 31개에 가드 한 줄을 일괄 삽입하고 파싱 검증을 돌렸습니다. 31개 전부 통과. 그 다음 타입체크를 돌렸더니 31개 전부 실패했습니다. 가드를 부르는 코드만 심고 정의는 심지 않았기 때문입니다.

#swift#build#verification#tooling

두 패널 도식. 왼쪽은 pgrep -f가 대기 셸 자신의 명령줄을 매칭해 자기가 살아 있는 동안 자기를 기다리는 구조를 원형 화살표로 보여주고, 옆에 이미 완료된 작업 카드가 놓여 있다. 오른쪽은 조건을 프로세스 존재가 아닌 결과로 바꾼 형태로, 산출물 파일·정확한 종료 마커·API 상태 세 가지를 나열한다.

툴과 개발 환경2026-09-076 분 읽기

제 대기 루프가 자기 자신을 기다리고 있었습니다

긴 작업이 끝날 때까지 기다리는 한 줄짜리 루프를 붙였습니다. 그 루프는 절대 끝나지 않습니다. pgrep -f가 전체 명령줄을 보는데, 대기 셸 자신의 명령줄에 찾는 문자열이 들어 있기 때문입니다.

#tooling#verification#macos#automation

두 패널 도식. 왼쪽은 워크트리에서 릴리스 스크립트를 돌렸는데 매니페스트의 절대 경로가 메인 체크아웃을 가리켜 내 변경이 없는 바이너리가 경고 없이 업로드되는 경로를 보여준다. 오른쪽은 설정 인자를 서브커맨드 뒤에 놓아야 적용된다는 점과, 새 워크트리에는 무시된 파일인 서명 키와 시크릿이 복제되지 않는다는 점을 보여준다.

툴과 개발 환경2026-09-077 분 읽기

워크트리에서 릴리스했더니 제 변경이 하나도 없는 바이너리가 올라갔습니다

작업을 격리하려고 git 워크트리를 만들고 거기서 릴리스를 냈습니다. 릴리스 매니페스트의 프로젝트 경로가 절대 경로로 메인 체크아웃을 박아 두고 있었습니다. 빌드도 업로드도 성공했습니다.

#git#release#ios#android

위쪽에 내용이 빽빽한 '라이브' 문서, 아래쪽에 두 줄뿐인 '리포' 문서. 그 사이 굵은 화살표가 아래에서 위로 향하고 화살표에 deploy 라벨이 붙어, 빈약한 리포 내용이 빽빽한 라이브를 덮으려는 모습.

툴과 개발 환경2026-09-038 분 읽기

배포 스크립트가 하루치 작업을 되돌릴 뻔했습니다. 돌리기 직전에 봤습니다

고친 문자열을 배포하려고 기존 스크립트를 열어 봤습니다. 그 스크립트는 매 실행마다 리포지토리의 리스팅 파일로 라이브를 덮어씁니다. 전날 API로 고친 47개 필드가 조용히 되돌아갈 뻔했고, 배포는 성공으로 끝났을 겁니다.

#android#tooling#deployment#gotchas

왼쪽 터미널은 명령 출력이 있고 초록 체크, 오른쪽 터미널은 출력이 텅 빈 채 파이프를 거쳐 빨간 X가 나오고 그 위에 '명령이 없음'이라는 말풍선

툴과 개발 환경2026-09-027 분 읽기

검증기가 빈 줄을 뱉었고, 저는 그걸 '서명이 틀렸다'로 읽었습니다

거부됐던 안드로이드 앱 세 개를 재빌드하고 올리기 전에 검증했습니다. 세 앱 전부 '읽기 실패'가 났고 잠깐 서명을 의심했습니다. 원인은 검증 셸에 키 도구 경로가 없어서 명령이 아예 실행되지 않은 것이었습니다.

#android#build#gotchas#tooling

같은 모양의 배포 스크립트 아이콘 여러 개가 줄 서 있고 전부 '--dry-run' 배지를 달고 있는데, 그중 하나만 배지가 회색으로 비어 있고 그 아래에서 화살표가 곧장 'PRODUCTION' 상자로 들어간다.

툴과 개발 환경2026-09-018 분 읽기

제 `--dry-run`이 프로덕션에 게시했습니다

앱마다 배포 스크립트가 하나씩 있고 형태가 거의 같습니다. 먼저 --dry-run으로 돌려 보고, 출력이 맞으면 플래그를 떼고 다시 돌립니다. 그날도 --dry-run을 붙였는데 버전이 그대로 프로덕션에 나갔습니다. 그 스크립트에는 argparse가 없었습니다.

#automation#android#gotchas#reality-check

Left panel: three DerivedData folders for the same app, with find piped to head selecting an old one. Right panel: the build log path and BUILT_PRODUCTS_DIR pointing at the fresh build.

툴과 개발 환경2026-08-316 분 읽기

제 변경이 기기에서 안 보였습니다. 기기에 깔린 건 두 시간 전 앱이었습니다

시뮬레이터 스크린샷은 코드와 맞는데 실기만 달랐습니다. 코드를 의심하기 전에 봐야 했던 건 설치 아티팩트였습니다.

#gotchas#ios#debugging#reality-check

왼쪽은 대화형 ssh가 0바이트에 Exit status 1로 즉사하고 pty.Open device not configured 로그가 뜬 화면, 오른쪽은 511 천장에 붙은 527개 ttys와 20일째 살아있는 claude/codex 세션 목록

툴과 개발 환경2026-08-319 분 읽기

제 SSH가 죽은 건 20일치 좀비 셸 때문이었습니다

대화형 tailscale ssh가 0바이트를 뱉고 즉사했습니다. tailnet도 ACL도 호스트키도 버전 경고도 전부 무죄였습니다. 진짜 원인은 20일 동안 아무도 안 만진 CLI 세션들이 PTY를 전부 소진한 것 — 그리고 PTY를 쥔 건 claude가 아니라 그 부모 셸이었습니다.

#tailscale#ssh#macos#gotchas

왼쪽: 리포의 141행 영어 스켈레톤. 오른쪽: 라이브의 563행 다국어 산출물. 리포를 올리면 오른쪽이 왼쪽으로 덮인다.

툴과 개발 환경2026-08-2412 분 읽기

배포하려던 리포가 라이브보다 한 세대 낡아 있었습니다

정책 문구 한 줄을 고치려고 정적 사이트 배포 스크립트를 부르려던 순간이었습니다. 라이브 파일 178개를 먼저 내려받아 대조했더니 일치가 0개였고, 라이브가 페이지마다 50KB 더 컸습니다. 그대로 올렸으면 170여 페이지에서 그만큼을 지웠을 겁니다.

#deployment#verification#gotchas#reality-check

왼쪽: MapKit JS 는 Authorization Bearer JWT 로 200. 오른쪽: 같은 키로 만든 같은 JWT 를 스냅샷 API 에 보내면 401, teamId·keyId 를 쿼리에 넣고 path+query 를 ES256 으로 서명해 signature 파라미터로 붙여야 200 image/png.

툴과 개발 환경2026-08-208 분 읽기

토큰은 이미 있었습니다 — 그 문의 열쇠가 아니었을 뿐입니다

같은 회사, 같은 .p8 키, 같은 팀 ID. 그런데 한쪽은 Bearer 토큰을 받고 다른 쪽은 URL 서명을 받습니다. 401을 보고 저는 계속 키를 의심했습니다.

#api#gotchas#reality-check#verification

스텁은 this를 안 봐서 깨진 구현을 통과시켰고, 테스트는 ko-KR만 넣어 실제로 들어오는 ko_KR을 못 잡았고, 자기검증은 원래 본문에도 있던 단어를 찾아 변경 없이도 통과했다.

툴과 개발 환경2026-08-198 분 읽기

제 테스트가 저를 속인 세 가지 방법

테스트 스텁이 진짜보다 관대했고, 테스트 입력이 실제 호출부보다 깨끗했고, 자기검증 조건은 아무것도 검증하지 않았습니다. 셋 다 초록불이었습니다.

#testing#verification#gotchas#reality-check

브라우저: SSR HTML에 canvas와 링크가 모두 있고 콘솔 에러 0건, 그런데 useEffect가 실행되지 않아 화면이 빈다. dev 서버 로그: Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr.

툴과 개발 환경2026-08-197 분 읽기

콘솔은 조용했고, 화면은 비어 있었습니다

HTML에는 요소가 다 있었고 에러는 한 줄도 없었습니다. 그런데 useEffect가 한 번도 실행되지 않았습니다. 증거는 브라우저가 아니라 dev 서버 로그에만 있었습니다.

#nextjs#debugging#gotchas#reality-check

개념 도식: 왼쪽은 200 OK와 '10개 채널 업데이트 완료', 오른쪽은 서버가 그대로 들고 있는 옛 제목

툴과 개발 환경2026-08-0910 분 읽기

API가 200을 돌려주고 제 값을 버렸습니다

채널 열 개의 제목을 API로 바꿨습니다. 에러는 없었고 스크립트는 전부 성공을 찍었습니다. 다시 읽어 보니 제목은 하나도 안 바뀌어 있었습니다. 그날 하루에 밟은 조용한 실패 다섯 개를 정리했습니다.

#gotchas#youtube-api#automation#og-image

개념 도식: 파일들이 논리 크기는 정상인데 실제 블록 수는 0인 APFS dataless. mv/rsync가 닿으면 파일당 동기 다운로드. find -name '*.icloud'는 0건.

툴과 개발 환경2026-08-076 분 읽기

iCloud Drive의 git 저장소를 로컬로 옮기려 `mv`를 걸었더니 수백 개 파일이 10분 넘게 안 끝났습니다. iCloud 파일은 디스크에 실제로 없을 수 있고, `mv`가 닿으면 파일당 동기 다운로드가 걸립니다. 게다가 최신 macOS는 `.icloud` sidecar가 아니라 APFS dataless 파일이라 `find -name '*.icloud'`로는 하나도 안 잡힙니다.

#macos#icloud#git#gotchas

개념 도식: 한 디렉터리에서 create/delete/stat은 초록으로 통과하고 read/ls/append만 빨갛게 막힌다. Full Disk Access는 이미 부여됨. 이 비대칭이 TCC가 아니라 EndpointSecurity 확장의 신호.

툴과 개발 환경2026-08-076 분 읽기

쓸 수는 있는데 읽을 수 없는 디렉터리

파일은 만들 수도 지울 수도 있는데 `open()`만 안 됐습니다. `Operation not permitted`. 전체 디스크 접근은 이미 켜져 있고 샌드박스도 무관했습니다. 범인은 TCC가 아니라 EndpointSecurity 기반 DLP 에이전트였고, 판별의 열쇠는 '현재 프로세스가 방금 만든 파일만 읽힌다'는 비대칭이었습니다.

#macos#endpointsecurity#filesystem#gotchas

툴과 개발 환경2026-08-014 분 읽기

1인 에이전트 팩토리: 내 셋업

웹앱 34개, 페이퍼 트레이딩 봇 몇 개, 다국어 영상 파이프라인 — 전부 그냥 계속 켜져 있는 2017년 인텔 노트북에서 돈다. 전체 셋업과, 왜 구형 하드웨어가 오히려 도움이 됐는지.

#setup#launchd#macos#automation

툴과 개발 환경2026-08-014 분 읽기

Tailscale로 상시 가동 맥 봇을 원격 제어하기 (그리고 고아 포트 함정)

Tailscale로 아무것도 공개 노출하지 않고 폰에서 로컬 봇 대시보드를 본다. 그런데 봇을 폐기해도 Tailscale 경로는 안 지워진다 — 죽은 포트를 살아있어 보이게 만든 함정.

#tailscale#networking#bots#macos

툴과 개발 환경2026-08-014 분 읽기

Telegram을 봇 알림 채널로 — 그리고 일부러 꺼두는 경우

실제 판단을 내리는 봇은 Telegram으로 나를 부른다. 페이퍼·테스트 봇은 설계상 무음 — 거기서 발송 실패는 버그가 아니라 정상이다. 커버리지보다 신호.

#telegram#bots#alerting#automation

툴과 개발 환경2026-08-014 분 읽기

맨 터미널에서 cmux, 그리고 Orca로: 코딩 에이전트를 병렬로 굴리기

Claude Code와 Codex를 돌리는 환경이 세 단계를 거쳤다. 매번 같은 문제를 풀었다: 에이전트 여럿을 동시에 돌리면서 지금 어느 놈이 나를 필요로 하는지 어떻게 아나?

#claude-code#codex#orca#cmux