브라우저 자동화 격리로 세션 충돌 없애고 확인 작업 속도 개선

심볼릭 링크에서 실제 파일로

agent-browser 스킬 추가하면서 같이 정리한 게 AGENTS.md 처리 방식임. 원래는 다른 문서를 참조하는 형태로 두고 있었는데, 도구가 그 참조를 따라가지 못하는 케이스가 자꾸 생겨서 그냥 실제 파일로 박아버림.

겉보기엔 똑같은데, 도구가 읽을 때 동작이 달라짐.

왜 agent-browser를 따로 뺐나

기존 브라우저 자동화 도구를 그대로 쓰면 내가 띄워놓은 작업 세션이랑 충돌이 잦았음. 새 탭 열려다가 로그인 세션 죽이거나, 프로필 잠금 걸리거나.

• 별도 Chromium 인스턴스로 격리
• 메인 세션 무관하게 동작
• 충돌 시 폴백 순서를 스킬 본문에 명시

폴백 순서를 스킬 안에 박아둔 게 핵심임. 매번 "어떻게 우회하지" 묻지 말고 정해진 순서대로 시도하게 강제.

1) 새 탭 추가 → navigate
2) 같은 탭 navigate
3) incognito context
4) agent-browser로 전환

실제 써보니

확인 작업이 눈에 띄게 빨라짐. 전에는 "브라우저 닫혀있는데 어떻게 할까요" 같은 질문이 꼭 한 번씩 끼어들었는데, 이제 그냥 시도하고 결과만 보고함.

다만 두 가지 부작용 있었음.

• 동시에 여러 작업 돌리면 격리 인스턴스가 누적돼서 메모리 점유율이 튐
• 스킬 본문이 길어지면서 컨텍스트 토큰 비용이 살짝 늘어남

전자는 작업 종료 시 정리 훅으로 막았고, 후자는 본문을 폴백 4줄로 압축해서 어느 정도 줄임.

AGENTS.md 실제 파일화의 진짜 이유

링크 방식은 이론적으로 깔끔한데, 실제 도구 체인이 그 링크를 따라가지 못하면 의미가 없음. 추적·검색·diff 전부 실제 텍스트일 때 가장 단순함. 추상화 한 단계 줄였더니 디버깅도 같이 쉬워졌음.

결국 "겉모양 깔끔함"보다 "도구가 그대로 읽을 수 있음"이 더 중요한 실용 가치였다는 결론.

다음