배경

퍼블리싱이 끝나면 이미지를 S3에 올리고 HTML 경로를 바꿔야 합니다. Asana에서 ZIP 다운로드, 이미지 하나씩 S3 업로드, HTML 경로 수동 치환, 변환된 파일 재업로드 — 건당 5~10분이 걸렸고, 경로를 잘못 바꾸는 실수도 종종 생겼습니다.

해결 방법

Node.js와 Claude Code 슬래시 커맨드를 결합해 커맨드 한 줄로 끝나는 자동화를 만들었습니다.

커맨드 한 번이면 ZIP 다운로드부터 S3 업로드, 경로 치환, Asana 결과 첨부까지 자동으로 돌아갑니다.

시스템 아키텍처

4개의 독립 모듈로 나눠 유지보수와 재사용이 쉬운 구조를 잡았습니다.

스마트 파싱 엔진

HTML <img> 태그와 CSS background-image를 자동으로 찾아내고, 디렉토리 구조가 어떻든 알아서 처리합니다.

환경 및 보안

Staging과 Production 환경을 분리하고, 보안 토큰 관리도 갖춰 안전하게 배포할 수 있습니다.

Claude Code 인터페이스

슬래시 커맨드 한 번으로 전체 파이프라인이 실행되고, 진행 상황이 실시간으로 보입니다.

로컬 파일 경로가 UUID 기반 S3 URL로 자동으로 바뀝니다.

효과

• 5~10분이 30초가 됐습니다 — 작업 시간 90% 절감
• 경로 치환 실수가 사라졌습니다 — 수작업 오류 100% 제거
• 커맨드 한 줄이면 끝 — 4단계 수작업이 하나로 합쳐졌습니다

눈여겨볼 점

• ZIP 다운로드에서 Asana 첨부까지, 끝에서 끝까지 한 줄로 연결됩니다. Task ID 하나만 입력하면 나머지는 전부 자동. 파이프라인 설계가 깔끔합니다.
• HTML <img> 태그와 CSS background-image를 모두 자동 감지하는 파싱 엔진이 핵심입니다. 디렉토리 구조가 어떻든 알아서 처리하기 때문에 다양한 퍼블리싱 패턴에 바로 대응됩니다.
• UUID 기반 S3 URL로 파일명 충돌을 원천 방지하고, 환경 분리로 안전한 배포를 보장합니다. 5~10분이 30초가 된 것도 중요하지만, 경로 치환 실수가 완전히 사라진 것이 실무에서는 더 큰 의미입니다.