GAS Starter Template for Vibe Coders 🚀

A starter template for Vibe Coders to quickly bootstrap Google Apps Script projects with AI assistance.

이 프로젝트는 바이브 코더(Vibe Coder)를 위한 Google Apps Script 스타터 템플릿입니다. 깃허브에서 클론하여 바로 GAS 개발을 시작할 수 있도록 구성되어 있습니다.

---

프로젝트 구조

project-root/
├── README.md           # 본 문서
├── AGENTS.md           # AI 에이전트 개발 규칙
├── PRD.md              # 제품 요구사항 (여기에 스펙 작성)
├── LICENSE             # MIT 라이선스
└── gas/                # ⭐ GAS 소스 코드 (여기서 개발!)
    ├── .clasp.json     # Clasp 설정
    ├── appsscript.json # GAS 매니페스트
    └── Code.js         # 메인 스크립트

• 루트(/): PRD, 기획 문서, AI 에이전트 설정 등 개발 지원 파일
• gas/: 실제 GAS 코드 및 배포 설정 (모든 clasp 명령어는 여기서 실행)

---

🤖 AI와 함께 개발하기

PRD 작성 시 AGENTS.md를 참조하도록 AI에게 안내하세요.

예시 프롬프트: "AGENTS.md를 참조해서 PRD.md에 요구사항을 작성해줘"

AI 에이전트는 AGENTS.md의 규칙을 따라 개발합니다:

• 개발 중: push만 수행 (자유롭게)
• 배포: 사용자 승인 후에만 deploy

---

시작하기 (Getting Started)

1. 사전 준비

1. Google Apps Script API 활성화: Apps Script 설정 → API 켜짐(On)
2. Node.js 설치: nodejs.org (LTS 권장)
3. Clasp 설치:

   npm install -g @google/clasp

4. 구글 로그인:

   npx clasp login

   브라우저가 열리면 구글 계정으로 로그인하고 권한을 허용하세요.

2. 프로젝트 클론

git clone https://github.com/YW-Rainbow/apps-script-vibe-starter.git
cd apps-script-vibe-starter

3. Script ID 설정

Google Apps Script 프로젝트와 연결하려면 Script ID가 필요합니다.

Script ID 찾는 방법:

1. script.google.com에서 새 프로젝트를 생성하거나 기존 프로젝트를 엽니다.
2. 좌측 메뉴에서 ⚙️ 프로젝트 설정을 클릭합니다.
3. 스크립트 ID를 복사합니다.

.clasp.json 수정: gas/.clasp.json 파일을 열고 scriptId를 복사한 ID로 변경합니다.

{
  "scriptId": "여기에_복사한_스크립트_ID_붙여넣기",
  "rootDir": "."
}

---

개발 및 배포

⚠️ 중요: 모든 clasp 명령어는 gas 폴더 안에서 실행하세요!

cd gas

코드 업로드 (Push)

npx clasp push

첫 push 후 확인하기:

1. script.google.com에서 프로젝트를 엽니다.
2. Code.js 파일이 업로드되었는지 확인합니다.
3. 또는 터미널에서 npx clasp open으로 바로 열 수 있습니다.

배포 (Deploy)

# 배포 목록 확인
npx clasp deployments

# 기존 배포 업데이트
npx clasp deploy -i <DEPLOYMENT_ID>

# 새 배포 생성
npx clasp deploy --description "버전 설명"

---

Contributing

이 프로젝트에 기여하고 싶으시다면:

1. 이 저장소를 Fork 합니다.
2. 새 브랜치를 생성합니다 (git checkout -b feature/amazing-feature).
3. 변경사항을 커밋합니다 (git commit -m 'Add amazing feature').
4. 브랜치에 Push 합니다 (git push origin feature/amazing-feature).
5. Pull Request를 생성합니다.

---

라이선스

이 프로젝트는 MIT License로 배포됩니다.