project-auto-wizard 0.5.1 → 0.6.0

package/README.md

@@ -17,7 +17,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.5.0 (2026-08-23)
+## 최신 버전 : v0.5.1 (2026-08-23)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -37,17 +37,17 @@ npx project-auto-wizard --mode full --force --type spring,react   # CI에서 비
 
 | 축 | 내용 |
 |---|---|
-| ① **npx 마법사** | 마커 파일로 프로젝트 타입 자동 감지 — **9타입 + 멀티타입 + 모노레포 경로**까지. 질문은 최소한만 |
+| ① **npx 마법사** | 마커 파일로 프로젝트 타입 자동 감지 — **10타입 + 멀티타입 + 모노레포 경로**까지. 질문은 최소한만 |
 | ② **GitHub-native AI Release Automation** | 릴리스 PR을 열면: 버전 확정 → **AI가 릴리스 노트 작성** → CHANGELOG 갱신 → automerge → tag + GitHub Release. **API 키 0개** (GitHub Models) |
-| ③ **타입별 CI/CD 워크플로우** | Spring(무중단 배포 포함)·Flutter(스토어 배포)·React·Next·Python 등 타입에 맞는 GitHub Actions 자동 배치 |
+| ③ **타입별 CI/CD 워크플로우** | Spring(무중단 배포 포함)·Flutter(스토어 배포)·React·Next·Python·Go 등 타입에 맞는 GitHub Actions 자동 배치 |
 
 ### 지원 프로젝트 타입
 
-`spring` `flutter` `react` `next` `node` `python` `react-native` `react-native-expo` `basic`
+`spring` `flutter` `react` `next` `node` `python` `react-native` `react-native-expo` `basic` `go`
 
 - **멀티타입**: `--type spring,react,python` — 한 레포에 여러 타입 공존
 - **모노레포**: `--paths "flutter=app,react=client"` — 타입별 서브폴더 지정 (마커 파일 자동 감지)
-- `spring`/`flutter`/`react`/`next`/`python` 5개 타입은 아래 "타입별 워크플로우 구성"처럼 전용 CI/CD가 설치됩니다. `node`/`react-native`/`react-native-expo`/`basic`은 타입 전용 CI 없이 릴리스 자동화(버전 관리·체인지로그·AI 요약)를 담당하는 공통 워크플로우만 설치됩니다 — 빌드/배포 CI는 직접 추가해서 확장할 수 있습니다.
+- `spring`/`flutter`/`react`/`next`/`python`/`go` 6개 타입은 아래 "타입별 워크플로우 구성"처럼 전용 CI/CD가 설치됩니다. `node`/`react-native`/`react-native-expo`/`basic`은 타입 전용 CI 없이 릴리스 자동화(버전 관리·체인지로그·AI 요약)를 담당하는 공통 워크플로우만 설치됩니다 — 빌드/배포 CI는 직접 추가해서 확장할 수 있습니다.
 
 ### 질문 문구 커스터마이징
 
@@ -73,6 +73,7 @@ flutter.APP_ARTIFACT_NAME:
   - PR 프리뷰는 배포 방식과 무관한 별개 축이라 선택과 관계없이 함께 설치됩니다.
 - **react/next**: CI와 CI+CD 분리 구성
 - **python**: CI / PR 프리뷰 / SimpleCICD
+- **go**: CI(Dockerfile 불필요, go test/vet/build/lint) / PR 프리뷰 / SimpleCICD(Dockerfile 있는 프로젝트만 해당)
 
 ### 설치 기록 (`.github/.wizard/logs/`)
 
@@ -175,23 +176,17 @@ npx project-auto-wizard --mode doctor   # 환경 진단 (읽기 전용, 규칙
   [✓] GitHub 로그인 — 레포 설정 조회 권한          인증됨
   [✓] merge commit 허용 — 릴리스 PR 자동 머지 조건  허용됨
 
-  [!] WORKFLOW_PAT — 자동 태그·Release 발행
-      ✗ secret이 등록되어 있지 않습니다.
-        PR 자동 머지 뒤 태그·Release 워크플로가 이어지지 않습니다.
-        (GitHub 정책상 기본 토큰으로 만든 커밋은 다음 워크플로를 깨우지 못합니다)
-      → 개인 액세스 토큰 발급 (scopes: repo, workflow)
-      → 레포 Settings → Secrets and variables → Actions
-      → New repository secret · 이름은 WORKFLOW_PAT
-      → 자세히: https://github.com/Twin-Fang/project-auto-wizard#post-install
-
   [i] Workflow permissions — 직접 추가한 워크플로우의 기본 권한
       현재 read 입니다 — 마법사가 설치한 워크플로우는 각자 권한을 선언하므로 그대로 동작합니다.
+  [i] WORKFLOW_PAT — 자동 태그·Release 발행
+      secret이 없어도 폴백이 자동으로 이어받아 태그·Release까지 진행됩니다 — 실제 병합 후 최대 ~20초 정도 더 걸릴 뿐입니다.
+      속도를 더 원한다면 PAT을 등록할 수 있습니다 — 반드시 개인 계정이 아닌 조직 bot/machine 계정으로 발급하세요 (scopes: repo, workflow).
+      등록: 레포 Settings → Secrets and variables → Actions → New repository secret · 이름은 WORKFLOW_PAT
   [i] GitHub Models — AI 릴리스 노트 생성
       조직 정책으로 차단됐는지는 자동으로 확인할 수 없습니다 (Settings → Models).
       차단돼 있어도 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.
 
-  ! 1개 항목에서 문제를 찾았습니다.
-    설치 자체는 지금 진행할 수 있고, 위 1개는 나중에 설정해도 됩니다.
+  ✓ 문제를 찾지 못했습니다.
 ```
 
 > **드리프트 판정 기준**: `--mode status`는 설치된 워크플로우 파일이 "설치 시점 기본값 템플릿"과 바이트 단위로 일치하는지만 비교합니다 — 파일을 직접 편집했는지는 추적하지 않습니다. 대화형 설치에서 `@wizard ask` 질문(예: 배포 포트)에 기본값이 아닌 값으로 응답했다면, 파일을 전혀 수정하지 않았더라도 설치 직후부터 항상 "사용자가 수정한 워크플로우 파일"로 표시됩니다. 정상 동작이며, 파일을 직접 편집했는지 구분하려면 해당 값이 예상한 응답과 일치하는지 직접 확인하세요.
@@ -223,7 +218,7 @@ npx project-auto-wizard --no-semver-auto   # 항상 patch+1 (레거시 동작)
 
 | 항목 | 내용 |
 |---|---|
-| **`WORKFLOW_PAT` secret** (권장) | automerge 후 후속 워크플로우(tag/Release)가 이어지려면 PAT가 필요합니다 — `GITHUB_TOKEN`으로 머지하면 GitHub 정책상 후속 워크플로우가 트리거되지 않습니다. Settings → Secrets → Actions에 `WORKFLOW_PAT` (scopes: `repo`, `workflow`) 등록. 없으면 `GITHUB_TOKEN`으로 동작하되 Release 발행은 수동 재실행이 필요할 수 있습니다 |
+| **`WORKFLOW_PAT` secret** (선택 — 속도 최적화용) | 없어도 `GITHUB_TOKEN` 폴백이 automerge부터 Release 발행까지 자동으로 이어갑니다(실제 병합 후 최대 ~20초 추가). 더 빠르게 하고 싶다면 Settings → Secrets → Actions에 `WORKFLOW_PAT` (scopes: `repo`, `workflow`) 등록 — 반드시 개인 계정이 아닌 조직 bot/machine 계정으로 발급하세요 |
 | **Workflow permissions** | Settings → Actions → Workflow permissions: **Read and write** |
 | **GitHub Models** | 기본 활성 — 별도 설정 불필요. 조직 정책으로 차단된 경우 자동으로 규칙 fallback |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/changelog_manager.py

@@ -32,6 +32,8 @@ import traceback
 import urllib.error
 import urllib.request
 
+import issue_helper
+
 
 # ----------------------------- 공통 유틸 -----------------------------
 
@@ -405,6 +407,35 @@ def _ai_assisted_minor_upgrade(unclassified_lines: list[str]) -> bool:
     return False
 
 
+def filter_release_issue_numbers(commit_shas: set[str], merged_prs: list[dict]) -> list[str]:
+    seen: set[str] = set()
+    result: list[str] = []
+    for pr in merged_prs:
+        merge_commit = pr.get('mergeCommit') or {}
+        oid = merge_commit.get('oid')
+        if not oid or oid not in commit_shas:
+            continue
+        head_ref = pr.get('headRefName') or ''
+        issue_num = issue_helper.extract_issue_number_from_branch(head_ref)
+        if not issue_num or issue_num in seen:
+            continue
+        seen.add(issue_num)
+        result.append(issue_num)
+    return result
+
+
+def cmd_collect_issue_closes(commit_shas_file: str, merged_prs_file: str) -> int:
+    with open(commit_shas_file, encoding='utf-8') as f:
+        commit_shas = {line.strip() for line in f if line.strip()}
+
+    with open(merged_prs_file, encoding='utf-8') as f:
+        merged_prs = json.load(f)
+
+    issue_numbers = filter_release_issue_numbers(commit_shas, merged_prs)
+    print(','.join(issue_numbers))
+    return 0
+
+
 def cmd_classify_bump(commits_file: str) -> int:
     """커밋 목록 파일을 읽어 semver 승격 폭(major/minor/patch)을 stdout 마지막 줄에 출력.
 
@@ -811,6 +842,10 @@ def main(argv: list[str] | None = None) -> int:
     p_ai_summary.add_argument('--pr-title', help='PR 제목 (프롬프트 컨텍스트로 사용, 선택)')
     p_ai_summary.add_argument('--diff-stat-file', help='git diff --stat 출력 파일 (프롬프트 컨텍스트 확장, 선택)')
 
+    p_collect = sub.add_parser('collect-issue-closes', help='develop에 머지된 PR 중 이번 릴리스에 포함된 이슈 번호 목록 추출')
+    p_collect.add_argument('--commit-shas-file', required=True, help='이번 릴리스에 포함된 커밋 SHA 목록 파일 (한 줄당 1개)')
+    p_collect.add_argument('--merged-prs-file', required=True, help='gh pr list --json number,headRefName,mergeCommit 출력 JSON 파일')
+
     args = parser.parse_args(argv)
 
     if args.command == 'update-from-summary':
@@ -823,6 +858,8 @@ def main(argv: list[str] | None = None) -> int:
         return cmd_classify_bump(args.commits_file)
     if args.command == 'ai-summary':
         return cmd_ai_summary(args.commits_file, args.version, args.output, args.pr_title, args.diff_stat_file)
+    if args.command == 'collect-issue-closes':
+        return cmd_collect_issue_closes(args.commit_shas_file, args.merged_prs_file)
     return 2
 
 

package/payload/scripts/issue_helper.py

@@ -14,6 +14,8 @@ without a LICENSE file) — ported to remove the external Action dependency
 
 Usage:
     issue_helper.py run
+    issue_helper.py extract-branch-issue <branch_name>
+    issue_helper.py link-pr-issues --pr <number> --issue-numbers <csv> [--replace]
 
 Reads GITHUB_EVENT_PATH (issues event JSON), GITHUB_TOKEN,
 GITHUB_REPOSITORY (all auto-provided by the Actions runner except
@@ -59,6 +61,14 @@ def extract_issue_number(issue_url):
     return parts[-1] if parts and parts[-1] else ""
 
 
+_BRANCH_ISSUE_RE = re.compile(r"#(\d+)")
+
+
+def extract_issue_number_from_branch(branch_name):
+    match = _BRANCH_ISSUE_RE.search(branch_name)
+    return match.group(1) if match else None
+
+
 _TAG_RE = re.compile(r"\[.*?]")
 _VARIATION_SELECTOR = "️"
 _ZWJ = "‍"
@@ -121,6 +131,42 @@ def normalize_all(title, issue_url, issue_number, date_yyyymmdd, branch_prefix,
     return branch_name, commit_message
 
 
+# ===================================================================
+# PR 본문 이슈 연결 (Closes #N) — 마커 블록 삽입/치환
+# ===================================================================
+
+LINK_MARKER_START = "<!-- auto-issue-link:start -->"
+LINK_MARKER_END = "<!-- auto-issue-link:end -->"
+_LINK_BLOCK_RE = re.compile(re.escape(LINK_MARKER_START) + r".*?" + re.escape(LINK_MARKER_END), re.S)
+
+
+def build_issue_links_block(issue_numbers):
+    lines = "\n".join(f"Closes #{n}" for n in issue_numbers)
+    return f"{LINK_MARKER_START}\n{lines}\n{LINK_MARKER_END}"
+
+
+def upsert_issue_links_in_body(body, issue_numbers, replace_existing):
+    if not issue_numbers:
+        return body, False
+
+    # 완전한 START...END 블록이 있을 때만 "마커 있음"으로 취급한다 — START만
+    # 있고 END가 없는 손상된 상태를 마커로 오인하면 _LINK_BLOCK_RE.sub()가
+    # 아무 것도 치환하지 못한 채 changed=True만 반환해, replace_existing=True
+    # 경로(release PR)에서 새 이슈 목록이 영구히 반영되지 않는 채로 조용히
+    # "성공"처럼 보이는 버그가 생긴다.
+    has_full_block = _LINK_BLOCK_RE.search(body) is not None
+    if has_full_block and not replace_existing:
+        return body, False
+
+    block = build_issue_links_block(issue_numbers)
+    if has_full_block:
+        new_body = _LINK_BLOCK_RE.sub(block, body)
+    else:
+        separator = "\n\n" if body.strip() else ""
+        new_body = f"{body}{separator}{block}"
+    return new_body, True
+
+
 # ===================================================================
 # GitHub REST API (urllib.request + GITHUB_TOKEN, 서드파티 의존 없음)
 # ===================================================================
@@ -222,6 +268,25 @@ def create_branch_if_needed(owner, repo, branch_name, base_branch, create_branch
     log(f"브랜치 생성됨: {branch_name}")
 
 
+def link_pr_issues(owner, repo, pr_number, issue_numbers, token, replace_existing):
+    status, pr_data, _ = _api_request("GET", f"{API_BASE}/repos/{owner}/{repo}/pulls/{pr_number}", token)
+    if status >= 400:
+        raise RuntimeError(f"PR 조회 실패({status}): {pr_number}")
+    body = pr_data.get("body") or ""
+
+    new_body, changed = upsert_issue_links_in_body(body, issue_numbers, replace_existing)
+    if not changed:
+        log(f"이슈 연결 변경 없음 — 건너뜀 (PR #{pr_number})")
+        return
+
+    status, _, _ = _api_request(
+        "PATCH", f"{API_BASE}/repos/{owner}/{repo}/pulls/{pr_number}", token, {"body": new_body},
+    )
+    if status >= 400:
+        raise RuntimeError(f"PR 본문 갱신 실패({status}): {pr_number}")
+    log(f"이슈 연결 완료: {', '.join(f'#{n}' for n in issue_numbers)} (PR #{pr_number})")
+
+
 # ===================================================================
 # 이벤트 처리 / CLI
 # ===================================================================
@@ -312,21 +377,60 @@ def cmd_run():
     return 0
 
 
+def cmd_link_pr_issues(pr_number, issue_numbers_csv, replace_existing):
+    repo_full = os.environ.get("GITHUB_REPOSITORY", "")
+    if "/" not in repo_full or repo_full.count("/") != 1 or not all(repo_full.split("/")):
+        log(f"ERROR: GITHUB_REPOSITORY 형식이 올바르지 않습니다: {repo_full!r}")
+        return 1
+    owner, repo = repo_full.split("/", 1)
+
+    token = os.environ.get("GITHUB_TOKEN", "").strip()
+    if not token:
+        log("ERROR: GITHUB_TOKEN이 없습니다.")
+        return 1
+
+    issue_numbers = [n.strip() for n in issue_numbers_csv.split(",") if n.strip()]
+    if not issue_numbers:
+        log("이슈 번호가 없음 — 건너뜀")
+        return 0
+
+    link_pr_issues(owner, repo, pr_number, issue_numbers, token, replace_existing)
+    return 0
+
+
 def build_parser():
     parser = argparse.ArgumentParser(prog="issue_helper.py")
-    parser.add_argument("command", choices=["run"])
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("run")
+
+    p_extract = sub.add_parser("extract-branch-issue")
+    p_extract.add_argument("branch_name")
+
+    p_link = sub.add_parser("link-pr-issues")
+    p_link.add_argument("--pr", required=True, type=int)
+    p_link.add_argument("--issue-numbers", required=True)
+    p_link.add_argument("--replace", action="store_true")
+
     return parser
 
 
 def main(argv=None):
     parser = build_parser()
     args = parser.parse_args(argv)
-    if args.command == "run":
-        try:
+    try:
+        if args.command == "run":
             return cmd_run()
-        except Exception as e:
-            log(f"실행 실패: {e}")
-            return 1
+        if args.command == "extract-branch-issue":
+            result = extract_issue_number_from_branch(args.branch_name)
+            if result:
+                print(result)
+            return 0
+        if args.command == "link-pr-issues":
+            return cmd_link_pr_issues(args.pr, args.issue_numbers, args.replace)
+    except Exception as e:
+        log(f"실행 실패: {e}")
+        return 1
     return 2
 
 

package/payload/scripts/version_manager.py

@@ -425,6 +425,8 @@ def sync_for_type(project_type, new_version, version_code_getter):
         sync_json_version(Path(path_dir) / "app.json", new_version, ["expo", "version"])
     elif project_type == "basic":
         pass
+    elif project_type == "go":
+        pass
     else:
         log(f"WARNING: unknown project type: {project_type} — skipping")
 

package/payload/version.yml.template

@@ -8,7 +8,7 @@
 #   (then edit major/minor manually, e.g., 1.0.5 -> 1.1.0 or 2.0.0).
 # ===
 # Supported project types: spring, flutter, next, react, react-native,
-#                          react-native-expo, node, python, basic
+#                          react-native-expo, node, python, basic, go
 # Multi-type projects: list every type in the project_types array
 #   -> the first entry is the primary type (project_types is the single source of truth)
 # Monorepo paths: project_paths maps each type to its subdir relative to the repo root
@@ -21,6 +21,7 @@
 # - react-native: Info.plist + build.gradle
 # - react-native-expo: app.json
 # - python: pyproject.toml
+# - go: (none — git tag based, go.mod has no version field)
 # - basic: version.yml only
 # ===
 

package/payload/workflows/common/PROJECT-COMMON-AI-PR-SUMMARY.yaml

@@ -89,3 +89,23 @@ jobs:
                -d @comment_payload.json \
                "https://api.github.com/repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" > /dev/null \
             || echo "comment post failed — continuing (this workflow never blocks the PR)"
+
+      - name: Link related issue via branch name
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+          # 브랜치명을 run: 스크립트에 직접 ${{ }} 보간하지 않고 env로 전달한다 —
+          # git ref 이름은 $, 백틱, 세미콜론 등을 포함할 수 있어 직접 보간하면
+          # 셸 인젝션 경로가 된다(AUTO-CHANGELOG-CONTROL의 PR_TITLE과 동일한 이유).
+          HEAD_REF: ${{ github.event.pull_request.head.ref }}
+        run: |
+          ISSUE_NUM=$(python3 .github/scripts/issue_helper.py extract-branch-issue "$HEAD_REF")
+
+          if [ -z "$ISSUE_NUM" ]; then
+            echo "브랜치명에서 이슈 번호를 찾지 못함 — 건너뜀: $HEAD_REF"
+            exit 0
+          fi
+
+          python3 .github/scripts/issue_helper.py link-pr-issues \
+            --pr ${{ github.event.pull_request.number }} \
+            --issue-numbers "$ISSUE_NUM"

package/payload/workflows/common/PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml

@@ -108,6 +108,40 @@ jobs:
           rm -f _full_diff_stat.txt
           echo "commits to summarize: $(wc -l < commits.txt)"
 
+      - name: Collect issues merged into {{DEVELOP_BRANCH}}
+        continue-on-error: true
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |
+          git log --pretty=%H "origin/{{MAIN_BRANCH}}..HEAD" > commit_shas.txt
+
+          gh pr list --state merged --base {{DEVELOP_BRANCH}} \
+            --json number,headRefName,mergeCommit --limit 200 > merged_prs.json
+
+          MERGED_PR_COUNT=$(python3 -c "import json; print(len(json.load(open('merged_prs.json'))))")
+          if [ "$MERGED_PR_COUNT" -ge 200 ]; then
+            echo "::warning::gh pr list가 --limit 200에 도달했습니다 — 오래된 병합 PR이 누락됐을 수 있습니다 (조회된 PR: $MERGED_PR_COUNT)"
+          fi
+
+          ISSUE_NUMBERS=$(python3 .github/scripts/changelog_manager.py collect-issue-closes \
+            --commit-shas-file commit_shas.txt \
+            --merged-prs-file merged_prs.json)
+
+          rm -f commit_shas.txt merged_prs.json
+
+          if [ -z "$ISSUE_NUMBERS" ]; then
+            echo "이번 릴리스에 연결할 이슈 없음 — 건너뜀"
+            exit 0
+          fi
+
+          python3 .github/scripts/issue_helper.py link-pr-issues \
+            --pr ${{ github.event.pull_request.number }} \
+            --issue-numbers "$ISSUE_NUMBERS" \
+            --replace
+
+          echo "이슈 연결: $ISSUE_NUMBERS"
+
       - name: Confirm release version (bump + sync)
         id: bump
         env:
@@ -206,7 +240,7 @@ jobs:
           VERSION="${{ steps.bump.outputs.new_version }}"
 
           # Working files must not land in the repo
-          rm -f pr_body.md summary.md commits.txt diff_stat.txt comment_body.md comment_payload.json
+          rm -f pr_body.md summary.md commits.txt diff_stat.txt comment_body.md comment_payload.json commit_shas.txt merged_prs.json
 
           git add -A
 

package/payload/workflows/go/PROJECT-GO-CI.yaml

@@ -0,0 +1,82 @@
+# project-auto-wizard:managed-workflow
+# ===================================================================
+# Go 빌드 검증 워크플로우 (CI Only)
+# ===================================================================
+#
+# 설명:
+# - {{DEVELOP_BRANCH}} 브랜치에 push/PR 시 go build/vet/test/lint로 검증
+# - Dockerfile이 필요 없어 CLI 도구·라이브러리 등 배포하지 않는 Go 프로젝트도 사용 가능
+# - go.mod의 go 지시자 버전을 자동으로 사용 (버전 하드코딩 없음)
+#
+# ===================================================================
+
+name: PROJECT-GO-CI
+
+# ===================================================================
+# 트리거 설정
+# ===================================================================
+on:
+  push:
+    branches:
+      - "{{DEVELOP_BRANCH}}"  # {{DEVELOP_BRANCH}} 브랜치 push 시 빌드 검증
+  pull_request:
+    branches:
+      - "{{DEVELOP_BRANCH}}"  # {{DEVELOP_BRANCH}} 브랜치로의 PR 시 빌드 검증
+  workflow_dispatch:  # 수동 실행 허용
+
+# ===================================================================
+# 환경 변수 설정
+# ===================================================================
+env:
+  # 프로젝트 고유 식별자
+  PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
+
+jobs:
+  # ===================================================================
+  # 빌드 검증 작업
+  # ===================================================================
+  build-check:
+    name: Go 빌드 검증
+    runs-on: ubuntu-latest
+
+    steps:
+      # 1. 소스코드 체크아웃
+      - name: 코드 체크아웃
+        uses: actions/checkout@v7
+
+      # 2. Go 툴체인 설정 (go.mod의 go 지시자 버전 자동 사용)
+      - name: Go 설정
+        uses: actions/setup-go@v7
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      # 3. 빌드 검증
+      - name: go build 검증
+        run: go build ./...
+
+      # 4. 정적 분석
+      - name: go vet 검증
+        run: go vet ./...
+
+      # 5. 테스트 실행
+      - name: go test 실행
+        run: go test ./...
+
+      # 6. 린트 (v8은 golangci-lint v2 계열을 요구 — .golangci.yml이 v1 형식이면
+      #    프로젝트에서 별도 조정 필요. version: latest는 v2 최신 패치를 자동으로 받는다)
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v8
+        with:
+          version: latest
+
+      # 7. 빌드 검증 완료 메시지
+      - name: 빌드 검증 완료
+        run: |
+          echo "✅ Go 빌드 검증이 성공적으로 완료되었습니다!"
+          echo ""
+          echo "📋 빌드 정보:"
+          echo "  🎯 프로젝트: ${{ env.PROJECT_NAME }}"
+          echo "  🌿 브랜치: ${{ github.ref_name }}"
+          echo "  📝 커밋: ${{ github.sha }}"
+          echo "  ⏰ 검증 시간: $(date '+%Y-%m-%d %H:%M:%S')"