Writing / 기술 기록

판단의 이유를
남깁니다.

설계와 구현, 운영 과정에서 내린 판단과 선택의 근거.
무엇을 바꿨고, 어디까지 확인했는지 씁니다.

문제에서 판단까지

Agent Guidance & Verification작성일 2026.08.06

AI Commons의 턴 종료 hook은 서버와 클라이언트 전체를 자동 수정하고 검사했습니다. hook을 제거하고 코드 수정 완료에 검사를 연결하면서, 범위 선택과 결과 확인의 책임을 명시했습니다.

Files & Concurrency작성일 2026.08.02

DB 롤백은 이미 덮어쓴 이미지 바이트를 복원하지 않습니다. 실행별 산출물 경로와 자기 파일만 정리하는 범위를 만들고, 입력 리비전과 결과 저장 순서를 구분합니다.

Authorization & Data작성일 2026.07.30

여러 소유자의 라이선스를 함께 읽으면 다른 사람의 대상 항목도 섞입니다. 조회는 묶고 매칭은 사용자마다 유지해 단건과 배치가 같은 권한을 반환하도록 바꿨습니다.

Runtime Validation & Video작성일 2026.07.25

외부 JSON의 타입 단언은 누락된 QC와 해시를 막지 못했습니다. 성공·실패별 런타임 계약, 요청과 결과 바이트 대조를 연결하고, 보고값 검증과 실제 영상 품질의 차이를 살펴봅니다.

Model Compatibility & Video작성일 2026.07.21

106점 배열의 형태가 같아도 모델이 받는 정렬 얼굴은 달랐습니다. 좌우 규약과 실제 정렬 3점, 프레임 추적을 맞추고, 회귀 수정과 이전 모델 대비 품질 비교를 구분합니다.

Streaming & Data작성일 2026.07.16

메시지는 먼저 생기고 토큰 사용량은 나중에 채워집니다. 집계 시각과 체크포인트를 함께 늦추고, 윈도우 경계의 누락·중복을 보정한 사례입니다.

Providers & Prompt Cache작성일 2026.07.11

Claude의 이력과 응답을 공통 스트림 계약으로 변환하고, 최근 메시지 창이 잘리지 않은 구간에만 캐시 표시를 붙였습니다. 4턴 기록에서 처리 토큰과 환산 입력 비용을 구분합니다.

Queue & Recovery작성일 2026.07.07

DB의 오래된 작업을 복구하려면 대응 큐의 실행 예정 상태를 함께 확인해야 합니다. 조회 오류의 보류, 옛 작업 ID 대조, 조건부 상태 변경과 복구 락의 만료 경계를 정리합니다.

GPU & Video작성일 2026.07.03

GPU를 빌려 영상을 만들며 준비 시간, 모델 실행 시간, 쓸 수 있는 결과 분량을 따로 봤습니다. 한 번의 실행 비용을 제품의 판매 단가로 바로 옮길 수 없었던 이유를 정리합니다.

Jobs & Stored Options작성일 2026.06.30

재시도가 저장된 옵션을 이어받도록 바꿨지만, 실제 워커는 그 옵션을 진행 정보로 덮어쓰고 있었습니다. 후속 수정의 저장 위치 분리와 과거 행 호환, 실제 쓰기 결과를 닮은 fixture의 필요성을 설명합니다.