setup-deploy

setup-deploy 개요

setup-deploy는 gstack용 배포 설정 스킬로, 프로젝트의 배포 메타데이터를 정리해 이후의 land-and-deploy 실행이 자동으로 동작하도록 돕습니다. 아직 대상 플랫폼이 확정되지 않은 상태에서, “이걸 어떻게 배포하지?”라는 대충의 요청을 반복 가능한 배포 설정으로 바꿔야 하는 에이전트나 개발자에게 특히 잘 맞습니다.

setup-deploy skill의 핵심 역할은 실무형 탐색입니다. 배포 제공자, 프로덕션 URL, 헬스 체크 엔드포인트, 배포 상태 확인 명령을 식별한 뒤 그 설정을 CLAUDE.md에 기록합니다. 그래서 매번 같은 질문을 다시 던지지 않고 결정 사항을 남긴다는 점에서, 단순한 프롬프트보다 훨씬 유용합니다.

배포 설정 작업에 가장 잘 맞는 경우

앱은 배포 가능해야 한다는 점은 분명하지만, 어떤 경로로 배포할지와 그 내용을 어디에 기록할지가 아직 정리되지 않았을 때 setup-deploy를 사용하세요. Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions 또는 커스텀 배포 흐름에도 잘 맞습니다.

무엇이 다른가

이 스킬은 단순한 조언이 아니라 설정 내용을 포착하는 데 초점이 맞춰져 있습니다. 배포 선택지를 프로젝트 메모리에 반영해 두면, 이후 자동화가 올바른 맥락을 사용할 수 있다는 점이 가치입니다. 특히 저장소에 여러 환경이 있거나, 상태 확인 방식이 모호하거나, 기존 파일들을 보고 배포 대상을 추론해야 하는 경우에 중요합니다.

사용하지 않는 편이 나은 경우

샘플 앱을 한 번만 배포하는 방법이 궁금한 정도라면 일반 프롬프트만으로도 충분할 수 있습니다. 이미 안정적인 배포 명세가 완전히 갖춰져 있고, 그 내용을 다시 기록할 필요가 없다면 setup-deploy는 구조화된 탐색 외에는 큰 이점을 주지 못할 수 있습니다.

setup-deploy 스킬 사용 방법

올바른 프로젝트 컨텍스트에 스킬 설치하기

저장소의 스킬 명령으로 설치한 다음, 배포 설정이 기록되어야 하는 프로젝트에서 실행하세요. 일반적인 setup-deploy install 흐름은 다음과 같습니다.

npx skills add garrytan/gstack --skill setup-deploy

설치 후에는 에이전트가 스킬 저장소 자체가 아니라, 업데이트 대상인 앱 저장소에서 동작하고 있는지 확인하세요. CLAUDE.md를 수정해야 하는 위치가 바로 그 앱 저장소입니다.

목표만 말하지 말고 배포 사실을 함께 주기

setup-deploy usage 패턴은 앱 종류, 현재 호스팅 대상, 그리고 릴리스 및 헬스 체크에 대해 이미 알고 있는 정보를 함께 넣을 때 가장 잘 작동합니다. 좋은 입력 예시는 다음과 같습니다.

• “Render에서 Node API 배포를 설정해 줘. 프로덕션 URL은 https://api.example.com이고, 헬스 엔드포인트는 /health, 상태 확인 명령은 curl -f야.”
• “Vercel에 Next.js 앱 배포를 설정해 줘. main 브랜치를 사용하고, CI에서 이미 쓰고 있는 배포 확인 명령도 문서화해 줘.”

반대로 “배포 좀 도와줘”처럼 정보가 부족한 요청은 스킬이 너무 많은 것을 추론하게 만들어 설정 속도를 떨어뜨립니다.

이 순서로 스킬 파일 읽기

먼저 SKILL.md를 읽어 동작 흐름을 이해한 뒤, 생성되는 스킬이 어떻게 조립되는지 확인해야 할 때는 SKILL.md.tmpl을 살펴보세요. 이 저장소에는 참고할 만한 rules/, references/, resources/ 폴더가 없으므로, 핵심 스킬 파일이 사실상 단일 기준 문서입니다.

스킬이 설계된 워크플로를 그대로 따르기

setup-deploy guide는 간단한 흐름을 따라야 합니다. 플랫폼을 감지하고, 프로덕션 엔드포인트를 확인하고, 배포 상태를 어떻게 검사하는지 확인한 다음, 그 결과를 영구 저장하는 방식입니다. 저장소에 배포 대상이 여러 개 있을 가능성이 있으면, 에이전트가 추측하지 않도록 그 점을 명시적으로 답하세요. 확인 단계가 잘될수록 CLAUDE.md에 잘못된 플랫폼이나 상태 명령이 기록될 가능성은 줄어듭니다.

setup-deploy 스킬 FAQ

setup-deploy는 완전한 배포 자동화용인가요?

아닙니다. setup-deploy for Deployment 사용 사례는 자동화만을 뜻하지 않습니다. 이후 실행에 신뢰할 수 있는 맥락을 남기기 위해 필요한 최소한의 배포 사실을 수집하는 용도도 포함합니다.

호스팅 플랫폼을 먼저 알아야 하나요?

반드시 그렇지는 않습니다. 사람들이 setup-deploy를 설치하는 이유 중 하나는 프로젝트가 Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions, 또는 커스텀 경로 중 어디에 해당하는지 식별하는 데 도움을 받기 위해서입니다. 이미 플랫폼을 알고 있다면 스킬은 더 빠르고 더 정확해집니다.

일반 프롬프트보다 나은가요?

대개는 그렇습니다. 목표가 저장소에 배포 설정을 기록하고 이후 배포 작업을 반복 가능하게 만드는 것이라면 특히 그렇습니다. 일반 프롬프트도 배포 방법을 설명할 수는 있지만, setup-deploy skill은 올바른 입력을 모아 프로젝트 메모리에 쓰도록 설계되어 있습니다.

설치 전에 무엇을 확인해야 하나요?

프로젝트에 이미 배포 관행이 있는지, CI 상태 확인이 있는지, 반드시 유지해야 할 환경 가정이 있는지를 확인하세요. 그런 요소가 없다면 이 스킬이 시간을 아껴줄 가능성이 높습니다. 반대로 이미 완전히 표준화되어 있다면, setup-deploy는 중복일 수 있습니다.

setup-deploy 스킬 개선 방법

구체적인 배포 증거를 스킬에 주기

품질을 가장 크게 끌어올리는 방법은 정확한 사실을 주는 것입니다. 플랫폼 이름, 프로덕션 URL, 헬스 엔드포인트, 브랜치 이름, 현재 사용 중인 배포 또는 상태 확인 명령을 함께 제공하세요. 모르는 항목이 있으면, 아는 것만 먼저 말하고 나머지는 저장소에서 확인해 달라고 요청하면 됩니다.

CLAUDE.md에 쓰기 전에 모호함 해소하기

가장 흔한 실패 원인은 불완전한 단서만 보고 잘못된 대상을 선택하는 것입니다. 저장소가 여러 방식으로 배포될 수 있다면, vercel.json, render.yaml, GitHub Actions workflows, 기존 package.json 스크립트처럼 어떤 신호를 우선할지 스킬에 분명히 알려 주세요.

첫 실행 후에는 다시 다듬기

첫 번째 setup-deploy 실행이 끝나면, 작성된 CLAUDE.md 항목에서 플랫폼 이름이 맞는지, URL이 오래되지 않았는지, 상태 확인이 너무 일반적으로 적히지 않았는지 검토하세요. 설정이 너무 넓게 잡혔다면, 정확한 서비스, 환경, 보존해야 할 검증 명령을 지정하는 두 번째 패스로 더 좁혀 주세요.