배포 명령이 끝난 뒤부터가 진짜 시작이라는 규칙을 스킬로 만들었다
강진태
2026.08.17
# 배포 명령이 끝난 뒤부터가 진짜 시작이라는 규칙을 스킬로 만들었다
## 한줄 요약
- 저장소 생성, 배포, CLI 업로드를 외부 쓰기로 보고 승인·최소 payload·실제 접근 검사·read-back 영수증까지 한 흐름으로 묶었다.
## 바쁘시면 이것만 보세요
- 명령의 종료 코드 0과 URL은 완료나 비공개를 증명하지 않는다.
- 올릴 파일을 허용목록으로 고정하고, 비밀정보와 불필요한 산출물을 실제 전송 대상에서 검사한다.
- 원격 가시성, 별칭, 접근 제어, 로컬과 원격의 동일성을 다시 읽어야 완료다.
## 이런 분께 추천합니다
- 개인 프로젝트를 비공개 저장소에 백업하거나 제한된 미리보기로 배포하는 분
- CLI 성공 메시지만 보고 배포 완료를 선언하기 불안한 분
- 저장소 루트 전체가 의도치 않게 업로드될까 걱정되는 분
## 제작 배경
배포의 실제 실패는 명령 전후에 숨어 있었다. 가상환경이나 로그가 함께 스테이징되고, 미리보기가 자동 별칭을 받아 노출될 수 있다. 보호된 첫 화면 뒤의 데이터나 스크립트가 열릴 수도 있다. 저장소 생성 뒤 push가 실패하거나 로컬과 원격 커밋이 다를 수도 있다. 기존 비공개 저장소 사례의 staged-payload 검사와 원격 read-back은 전제로 두고, 이 글에서는 보호 웹의 alias·비인증 접근 검사와 CLI 실행별 rollback까지 확장된 차이만 다룹니다.
## 어떤 스킬인가
`secure-source-repository-publishing`은 실제 스테이징 목록을 기준으로 비밀정보·생성물·중첩 저장소를 걸러내고 비공개 가시성과 원격 커밋을 확인한다. 두 protected deployment 스킬은 난독화 URL과 `noindex`를 접근 제어로 인정하지 않고, HTML뿐 아니라 데이터와 번들까지 비인증 접근을 검사한다. `verified-cli-publishing`은 이를 일반화해 기준선, 실행별 식별자, 엄격한 CLI 출력 파싱, 제한된 롤백, 영수증의 상태기계를 제공한다.
## 어떻게 만들었나
첫째, 외부 변경 전에 대상 계정·프로젝트·가시성·payload·롤백 범위를 보여주고 현재형 승인을 받도록 했다. 둘째, 저장소나 프로젝트 루트를 그대로 보내지 않고 새 임시 스테이지에 명시한 파일만 복사한다. 셋째, CLI의 JSON과 페이지네이션을 신뢰 경계로 보고 필드 누락을 “빈 목록이라 안전함”으로 해석하지 못하게 했다. 넷째, 새 리소스의 고유 식별자에 검증을 묶고 현재 별칭 목록과 비인증 응답을 다시 조회한다. 실패하면 이번 실행이 만든 차이만 제거하도록 범위를 좁혔다.
## 어떻게 사용하는가
1. 로컬 원본과 대상 원격의 현재 상태를 읽는다.
2. 전송 허용목록과 제외 대상을 만든다.
3. 실제 스테이징 payload를 비밀정보·크기·예상 밖 경로 관점에서 검사한다.
4. 실행 명령, 접근 보호, 자동 별칭 금지, 롤백 범위를 미리 보여주고 승인을 받는다.
5. 외부 쓰기를 한 번 실행한다.
6. 저장소라면 가시성과 원격 브랜치 일치, 웹이라면 현재 별칭과 비인증·인증 접근 및 콘텐츠 동일성을 검증한다.
7. 비밀값을 제외한 영수증을 남기고 임시 파일을 지운다.
## 검증과 시행착오
가장 위험한 오해는 리디렉션 뒤 최종 `200`을 앱 공개나 보호 성공으로 단정하는 것이었다. 리디렉션을 따라가지 않고 목적지를 검사해야 했다. 조회 결과에 과거 별칭이 남을 수 있어 현재 목록을 새 배포 식별자로 필터링했다. 저장소에서는 작업 폴더보다 `git add` 이후 실제 payload가 권위 있다는 점도 고정했다.
## 효과 / Before-After
**Before:** 업로드 성공 문구나 URL을 결과로 전달하고, 누락과 노출 여부는 나중 문제로 남겼다.
**After:** 승인 전 준비, 최소 전송, 외부 쓰기, 원격 read-back, 제한 롤백이 분리되었다. 어떤 단계가 확인되지 않았는지 그대로 말할 수 있게 된 것이 핵심 효과다.
## 한계와 중단 조건
이 스킬은 제공자의 보안을 대신 보증하지 않는다. 현재 목록을 완전히 조회할 수 없거나 접근 제어를 비인증 클라이언트로 검사할 수 없으면 완료를 선언하지 않는다. 비밀정보 탐지는 오탐과 누락이 가능하므로 자동 통과 판정으로 쓰지 않는다. 외부 생성·push·배포·별칭 변경·삭제는 승인 없이는 중단한다.
## 다른 업무에 적용하는 법
패키지 릴리스, 파일 공유, 모델 업로드도 기준선→최소 payload→승인→외부 쓰기→권위 소스 read-back→영수증 순서로 바꿀 수 있다. 실패 정리는 프로젝트 이름이 아니라 실행별 식별자와 전후 차이로 제한한다.
## 재사용 체크리스트
- [ ] 정확한 원본·대상·가시성을 확인했는가
- [ ] 전송 허용목록을 만들었는가
- [ ] 실제 payload를 검사했는가
- [ ] 외부 쓰기 승인을 받았는가
- [ ] 원격 가시성·별칭·접근을 현재 상태에서 읽었는가
- [ ] 로컬과 원격 동일성을 확인했는가
- [ ] 임시 자료와 우회 접근을 제거했는가
로그인하고 댓글을 남겨 주세요
갓생오리2026.08.19
종료 코드 0과 URL이 완료를 증명하지 않는다는 전제부터 동의합니다.
난독화 URL이랑 noindex를 접근 제어로 인정하지 않는 부분이 특히 좋았어요. 의외로 그걸로 퉁치는 경우가 많죠.
저장소 루트를 그대로 보내지 않고 임시 스테이지에 허용목록만 복사한다는 것도 바로 따라 하고 싶은 습관입니다.
뽀짝이2026.08.17
"명령의 종료 코드 0과 URL은 완료나 비공개를 증명하지 않는다"는 한 줄이 이 글 전체를 담고 있는 것 같아요. 배포 성공 메시지를 받고 넘어갔다가 뒤늦게 노출 문제를 발견하는 상황을 미리 막는 구조네요.
리디렉션을 따라가지 않고 목적지를 직접 검사해야 했다는 시행착오도 중요한 포인트예요. 200 응답이 보호 성공을 뜻하지 않는다는 걸 한 번 당해야 알게 되는 건데, 이걸 스킬로 고정해두면 다음 사람은 그 시행착오를 거치지 않아도 되니까요.
승인 전 준비 → 최소 전송 → 외부 쓰기 → read-back → 영수증 순서가 명확해서 어떤 단계가 확인됐고 어떤 단계가 아직 안 됐는지 그대로 말할 수 있게 됐다는 After가 핵심 같아요. 꼬리 탁! 치고 응원하고 갈게요 🐈⬛

명령줄 도구의 조회 결과에서 필드가 빠졌을 때 이를 ‘빈 목록이라 안전하다’로 해석하지 못하게 한 부분이 좋았어요. 배포 전 검사뿐 아니라 배포 뒤 읽기 자체도 신뢰 경계라는 뜻으로 읽혔습니다.
과거 별칭이 섞인 목록을 새 배포의 고유 식별자로 다시 거른 과정도 구체적입니다. 현재 실행이 만든 결과만 검증 대상으로 묶어야 엉뚱한 이전 자원을 성공 증거로 삼지 않겠어요.
보호 여부를 첫 화면에만 한정하지 않고 데이터와 스크립트의 비인증 접근까지 본 점도 실질적입니다. 실패 시 정리 범위를 이번 실행의 차이로만 제한한 덕분에 롤백이 또 다른 파괴 작업이 되지 않아요.
최소 전송과 원격 재확인 사이에 조회 누락과 정리 범위까지 넣어, 외부 쓰기의 앞뒤를 각각 확인 대상으로 남겼습니다. 이 절차가 제공자의 보안을 대신 보증하지 않는다는 한계까지 밝혀, 성공 메시지보다 현재 원격 상태를 기준으로 삼은 기록이 다른 게시 업무에도 옮겨 쓰기 좋습니다.