AI 자동화 지식 블로그

이곳은 배포, Git, 자동화, 웹 성능, 데이터 처리처럼 개발·운영 과정에서 직접 확인한 문제를 정리합니다. 각 글에는 재현 절차와 적용 범위를 함께 남기며, 검증하지 못한 내용이나 일반론적 초안은 공개하지 않습니다.

처음 읽는다면

자동 발행을 검증 가능한 운영 흐름으로 만들기

• GitHub Actions·Gemini·Quartz로 검수형 블로그 파이프라인 구축하기
• AI 콘텐츠를 바로 공개하지 않는 검수 파이프라인 설계
• 자동화 실패를 운영하는 법: 로그·재시도·중복 방지 설계

개발 환경과 변경을 안전하게 다루기

• Git Worktree로 브랜치를 나란히 작업하는 방법과 주의점
• Docker Multi-stage Build를 검증하는 법: 이 저장소 Dockerfile 사례
• Docker Desktop 업데이트 버튼이 눌리지 않을 때 진단 순서
• 3-2-1 백업을 복구 테스트까지 연결하는 방법

공간정보 다루기

• 좌표계를 모르는 X, Y를 받았을 때 판별하는 법
• GIS에서 지역명 부분문자열 검색이 위험한 이유
• OpenLayers와 deck.gl을 같이 쓸 때 어긋나는 이유
• GeoServer 장애를 DB Pool과 NFS 관점에서 분리해서 보는 법
• 공간정보 API 연결 전 점검할 5가지
• 지도 타일 캐싱 설계: 키·버전·무효화·측정 기준

AI 에이전트를 검증 가능하게 다루기

• 멀티에이전트는 역할보다 ‘독립 질문’이 중요하다
• Claude Code에서 Codex를 쓰기 권한 없는 검증자로 쓰기
• MCP는 Connected인데 Tool이 안 보일 때 진단 순서
• AI 코딩 에이전트에서 파괴 명령을 실행 전에 막는 법
• LLM을 바꿔도 결과가 흔들리지 않는 tool 호출 설계
• 문서 자동화 품질은 Prompt보다 Evidence에서 결정된다
• 반려 코퍼스 없이 판별력을 재고 있었다
• Agent 자동화에서 Runtime은 얇게, Domain Skill은 두껍게

측정한 값을 믿기 전에

• 검증 결과를 믿기 전에 검증 도구부터 검증하라
• ‘호출되지 않음’과 ‘관측되지 않음’을 구분하라
• 호출자가 없는 코드가 죽은 코드는 아니다: Negative-Space Guard
• LLM 서버용 GPU를 고를 때 FLOPS보다 먼저 볼 것

이 저장소를 들여다보기

• Quartz의 Head.tsx가 페이지 메타데이터를 생성하는 구조
• CI 환경의 Git Shallow Clone으로 인한 데이터 누락 방지 설정법
• 빌드 시 같은 슬러그를 만드는 파일 충돌을 찾아내는 방법

웹 품질을 측정하고 개선하기

• Core Web Vitals 점검법: LCP·INP·CLS를 측정하고 원인 찾기
• Python Playwright로 로컬 웹 도구를 검증하는 최소 예제
• 공간정보 API 연결 전 점검할 5가지