#ai-agent
글 11개
- 폐쇄망에서 에이전트가 없는 도구를 만나면 기록만 하고 멈춘다 — 재시도 대신 반입 목록
인터넷이 없는 PC 에서 AI 코딩 에이전트가 설치 재시도에 빠지지 않게 했다. 없는 명령은 셸이, 없는 패키지는 에이전트가 한 줄로 기록하고, 그 기록을 모아 필요한 도구만 반입한다. 효과는 아직 재지 못했다.
- 지침은 코드보다 먼저 낡는다 — 도구 개수가 네 곳에 세 가지로 적혀 있었다
에이전트가 읽는 AGENTS.md 와 스킬 문서의 숫자가 4주 만에 어긋났다. 어긋난 곳을 직접 세고, 숫자를 적지 않거나 원본에서 세어 대조하는 검사로 막는 방법을 정리했다.
- 윈도우에서는 WSL2, AI 개발은 맥 아니면 리눅스 — 도구는 돌아도 생태계는 리눅스다
Claude Code 와 Codex 는 이제 윈도우에서도 그대로 실행된다. 그런데도 윈도우에서는 WSL2 를 쓰라고 말하는 이유를 한글 깨짐·셸·샌드박스·모델 서빙·쿠버네티스(k3s, kubeadm)로 정리했다.
- 에이전트 세 종류에 같은 '작업자 확인 문'을 달았다 — 판정은 하나, 사고는 출력 형식에서 났다
여러 사람이 한 레포를 쓰면 에이전트는 누구의 지침으로 일하나. Claude Code·Codex·Antigravity 세 런타임에 같은 훅을 달아 세션마다 작업자를 묻게 한 방법과, 런타임마다 다른 입출력 형식에서 겪은 함정을 정리했다.
- 세 사람과 에이전트가 한 main 을 쓰면 생기는 일 — git 사고 세 건과 막는 장치
브랜치 없이 main 하나에 세 사람과 에이전트가 바로 커밋한 레포에서 난 사고 세 건을 git log 로 다시 셌다. 서명만 빠진 채 바뀐 원격 이력, LFS 체크아웃 실패 뒤 853개 파일이 삭제로 기록된 커밋, 9종으로 흩어진 저자 이름이다.
- 설계서는 md·yaml·svg 만 고치고 docx·html 은 빌드한다 — 숫자는 한 곳에, 그림은 생성기로
문서 여섯 종류를 원본 세 가지에서 빌드하는 문서 키트를 정리했다. 숫자를 한 곳에 두는 자리표시와 엔진을 옮길 때의 바이트 비교를 다룬다. yaml 로 흐름도를 그리는 생성기와 그 한계도 적었다.
- Go 와 Rust 를 쓰면 좋은 점 — 직접 잰 숫자로 본 두 언어의 자리
에이전트가 코드를 쓰는 지금 왜 Go 와 Rust 인가. 이 사이트 서버와 문서 변환 엔진을 직접 빌드해 잰 시간·크기·의존성으로 두 언어를 어디에 쓰는지 정리했다.
- SonarQube 는 이슈를 고쳐도 리팩토링은 하지 않는다 — 근거와 추측 구분하기
정적분석 도구는 문제를 찾고 머지를 막는다. 지금의 SonarQube 유료 판에는 수정을 제안하고 PR 을 여는 기능이 붙었지만 단위는 규칙 위반 한 건이다. 내 저장소의 Sonar 이슈 322건을 에이전트로 정리한 기록과, 출처를 확인한 리팩토링 방법론을 정리했다.
- AI 코딩 에이전트가 규칙을 못 어기게 하려면 커밋에서 막는다 — 그 게이트도 시험해야 한다
문서에 적은 규칙은 에이전트가 지나칩니다. 규칙을 git pre-commit 게이트로 옮긴 agents-scaffold 를 빈 저장소에 새로 깔아 다시 시험했습니다. 막는 것, 못 막는 것, 게이트 스스로 틀렸던 곳을 정리했습니다.
- 100만 줄 넘는 코드베이스에서 에이전트는 모듈 경계 안에 가둔다 — 600만 줄 저장소에서 다시 본 원칙
100만 줄부터는 에이전트에게 전체 맥락을 줄 수 없습니다. 모듈 경계로 읽을 범위를 가두고, 검색으로 조각을 주고, 검사로 안전을 확인합니다. 약 600만 줄 저장소와 에이전트 작업 저장소에서 맞은 것과 틀린 것을 정리했습니다.
- Orca 사용법 — worktree 워크플로 중심으로
AI 에이전트 여러 개를 한 레포에서 충돌 없이 굴리는 방법. Orca 의 worktree 워크플로를 실제 사용 흐름대로 정리했다.