스프쌤
스레드

[딸깍 시리즈 대방출]

✍ @changil.k⏱ 7분 소요2026-09-15👁
← 목록으로 돌아가기

화면 캡처에 화살표 그리고 설명 붙이던 매뉴얼 작업, 클릭만 하면 기록이 되는 방식으로 바꿀 수 있다면 어떨까.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: 브라우저 클릭을 자동 기록해 업무 매뉴얼을 만드는 크롬 확장 ClickGuide Local

✦ KR 핵심 요약: ClickGuide Local은 웹사이트에서 클릭한 과정을 자동으로 기록하고 클릭 위치에 빨간 번호 마커가 들어간 스크린샷을 남겨, 단계별 PDF 가이드 제작을 돕는 Chrome 확장 프로그램이다. 한국학중앙연구원 인사팀이 ERP 사용 안내와 업무 절차 안내 매뉴얼에 활용 중이며, 저장소에 설치 문서와 보안 정책이 함께 공개되어 있다.

🌐 Global Takeaway: ClickGuide Local is a Chrome extension that records clicks on a website and turns them into screenshot-based, step-by-step PDF guides, replacing manual screen captures and annotation. It is already used by an HR team for ERP and workflow manuals, with installation docs and the release build available in its public GitHub repository.

업무 매뉴얼을 만들 때 가장 번거로운 부분은 기록이 아니라 재구성이다. 화면을 캡처하고, 캡처본 위에 화살표를 그리고, "여기를 클릭하세요" 같은 설명을 붙이고, 순서가 뒤섞이지 않았는지 다시 확인한다. 클릭 몇 번이면 끝날 일이 문서 한 편 분량의 노동이 된다. 딸깍 시리즈에서 소개한 ClickGuide Local은 이 과정을 "기록 자체가 초안이 되게" 바꾸려는 시도다.

ClickGuide Local은 무엇을 하는 도구인가

ClickGuide Local은 웹사이트에서 클릭한 과정을 자동으로 기록하고, 스크린샷이 들어간 단계별 PDF 가이드를 만들어 주는 Chrome 확장 프로그램이다. 공개된 저장소 설명에 따르면 개발 지식이 없어도 README만 보고 설치할 수 있도록 안내가 정리되어 있고, 설치 문서(INSTALL_KO.md, INSTALL_EASY_KO.md)와 기여·보안 정책 문서가 함께 올라와 있다.

핵심 동작은 단순하다. 녹화를 시작한 뒤 평소처럼 업무를 진행하면, 클릭할 때마다 화면이 스크린샷으로 저장되고 클릭 위치에 빨간 번호 마커가 찍힌다. 즉 사용자는 매뉴얼을 "작성"하는 대신, 일을 하면서 지나간 경로를 그대로 남기게 된다.

누가, 어떤 목적으로 만들었나

원문에 따르면 이 도구는 실제 한국학중앙연구원 인사팀에서 ERP 사용 안내, 업무 절차 안내 등 여러 매뉴얼을 만드는 데 활용되고 있다. 화면 캡처와 화살표, 설명 붙이기를 자동화해보자는 생각에서 출발했다는 동기까지 함께 밝히고 있다. 사내 시스템처럼 화면이 복잡하고 사용자 층이 넓은 업무일수록 같은 안내를 반복해서 만들어야 하므로, 현업 부서가 직접 도구를 만들었다는 점이 이 사례의 특징이다.

설치 전에 확인해야 할 것

저장소에는 일반 사용자용 배포 파일과 개발자용 소스가 함께 있다. README가 강조하는 주의 사항은 GitHub의 초록색 Code 버튼으로 받는 ZIP은 개발자용 소스 코드라는 점이다. 일반 사용자는 릴리스 페이지에서 배포하는 ClickGuideLocal.zip을 받아야 한다.

구분 내용
대상 클릭 흐름을 문서로 남겨야 하는 실무자
설치 방식 배포 ZIP 압축 해제 후 Chrome 개발자 모드에서 압축해제된 확장 프로그램 로드
선택할 폴더 manifest.json이 바로 보이는 폴더
흔한 실수 ZIP 파일 자체, assets 폴더, manifest.json의 상위 폴더를 선택
산출물 스크린샷과 번호 마커가 포함된 단계별 가이드(PDF)

설치 절차 자체는 어렵지 않지만 폴더 선택 단계에서 많이 미끄러진다. Chrome 확장 프로그램 화면(chrome://extensions)에서 개발자 모드를 켜고 압축해제된 확장 프로그램 로드를 누른 뒤, manifest.json이 바로 들어 있는 폴더를 지정해야 한다. 설치 후에는 퍼즐 아이콘에서 확장 프로그램을 고정해 두면 녹화 시작과 종료가 빨라진다.

실제 사용 흐름

  1. 문서화할 웹사이트를 연다.
  2. ClickGuide Local 아이콘을 눌러 녹화를 시작한다.
  3. 평소처럼 클릭하며 업무를 진행한다. 클릭마다 스크린샷과 빨간 번호 마커가 남는다.
  4. 팝업에서 녹화를 종료한다.
  5. 가이드 확인·편집 단계에서 단계 순서와 캡처를 점검한다.

여기서 중요한 건 3번이다. 매뉴얼 작성 시간을 줄이려면 "예쁘게 찍는" 기술보다 "업무를 실제 순서대로 한 번 수행하는" 습관이 더 중요하다. 녹화 중에 불필요한 클릭이 섞이면 그대로 단계가 되기 때문에, 첫 시도는 연습 삼아 돌려보고 두 번째 시도에서 실제 배포용을 만드는 편이 안전하다.

좋은 매뉴얼은 잘 쓰는 사람이 아니라, 같은 일을 한 번 더 반복한 사람의 기록에서 나온다.

핵심 정리

  • ClickGuide Local은 브라우저 클릭 흐름을 자동 기록해 스크린샷 포함 단계별 PDF 가이드를 만드는 Chrome 확장 프로그램이다.
  • 클릭 시점마다 스크린샷과 빨간 번호 마커가 남아, 캡처·화살표·설명 작업이 기록 단계로 흡수된다.
  • 한국학중앙연구원 인사팀에서 ERP 사용 안내와 업무 절차 안내 매뉴얼 제작에 실제로 활용 중이라고 원문에서 밝히고 있다.
  • 저장소(github.com/koul777/clickguide-local-private)에 설치 문서와 배포 파일 안내가 함께 공개되어 있다.
  • 일반 사용자는 Code 버튼 ZIP이 아니라 릴리스의 ClickGuideLocal.zip을 받아야 한다.

실무 적용 포인트

도입 전에 정할 것

매뉴얼의 대상 독자와 범위를 먼저 정해야 한다. ERP처럼 메뉴가 많은 시스템은 한 편에 다 담으면 단계가 지나치게 길어진다. "로그인부터 첫 화면까지", "결재 상신만"처럼 업무 단위로 쪼개서 녹화하면 결과물의 재사용성이 올라간다. 또한 자동 생성된 초안은 어디까지나 초안이므로, 실제로 그 화면을 처음 보는 사람에게 한 번 따라 하게 해보는 검증이 필요하다.

검수와 보안

자동 기록은 편하지만 화면에 고객 정보나 내부 수치가 그대로 찍힐 수 있다. 녹화 전에는 테스트 계정이나 더미 데이터를 쓰고, 배포 전에는 편집 화면에서 민감 정보가 담긴 스크린샷을 반드시 확인해야 한다. 저장 위치나 외부 전송 여부 같은 세부 동작은 저장소의 보안 문서(SECURITY.md)와 설치 문서에서 직접 확인하는 것이 안전하다.

운영 방식

도구를 한 번 도입하면 담당자 개인 PC에만 두지 말고, 배포 파일과 설치 절차를 팀 단위로 공유하는 편이 좋다. 저장소는 확인되는 범위에서 커밋 12개 규모의 초기 MVP이므로, 릴리스와 문서 변경을 주기적으로 확인하는 습관이 필요하다.

자주 묻는 질문

Q. 개발을 몰라도 설치할 수 있나? README는 개발 지식이 필요하지 않다고 안내하고, 쉬운 설치 문서를 별도로 제공한다.

Q. 어떤 매뉴얼에 적합한가? 브라우저에서 이루어지는 클릭 기반 업무에 적합하다. ERP 사용 안내, 사내 절차 안내처럼 화면 순서를 따라가며 설명해야 하는 문서가 대표적이다.

Q. 결과물을 그대로 배포해도 되나? 스크린샷에 민감 정보가 남을 수 있으므로 편집과 검수 단계를 거치는 것이 좋다.

마무리

원문 작성자는 GitHub에 공개했으니 직접 실행해보고 의견을 남겨달라고 요청하고 있다. 매뉴얼 담당자라면 이미 만들어 둔 문서 한 편을 이 방식으로 다시 녹화해보는 것부터 시작해보면 좋겠다. 캡처와 화살표에 쓰던 시간이 실제 업무 검증으로 옮겨가는지, 그 차이가 도입 여부를 판단하는 가장 현실적인 기준이 될 것이다.

자주 묻는 질문

Q. ClickGuide Local은 어떤 도구인가요?
A. 웹사이트에서 클릭한 과정을 자동으로 기록하고, 클릭 위치에 빨간 번호 마커가 표시된 스크린샷을 포함한 단계별 PDF 가이드를 만들어 주는 Chrome 확장 프로그램입니다.

Q. 설치할 때 가장 흔한 실수는 무엇인가요?
A. 압축을 푼 뒤 manifest.json이 바로 보이는 폴더를 선택해야 합니다. ZIP 파일 자체나 assets 폴더, manifest.json의 상위 폴더를 선택하면 정상적으로 로드되지 않습니다. GitHub의 Code 버튼으로 받는 ZIP은 개발자용 소스이므로 릴리스의 ClickGuideLocal.zip을 사용해야 합니다.

Q. 자동 생성된 가이드를 그대로 배포해도 되나요?
A. 화면에 고객 정보나 내부 수치가 그대로 캡처될 수 있으므로, 녹화 전 테스트 계정이나 더미 데이터를 사용하고 배포 전 편집 화면에서 민감 정보가 담긴 스크린샷을 확인하는 검수 단계를 거치는 것이 좋습니다.

원본

https://www.threads.com/@changil.k/post/DaM3XPQDHCI

https://github.com/koul777/clickguide-local-private

함께 보면 좋은 글

댓글 0개