build: add Go verification workflow and refactor design docs

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: tae2089

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+
+      - name: Run go vet
+        run: make vet
+
+      - name: Capture go build JSON
+        run: make build-json
+
+      - name: Upload go build JSON artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: go-build-json
+          path: build-results.json

.gitignore

@@ -15,4 +15,5 @@
 .omc/
 
 docs/
-.ccg
+.ccg
+.claude/**

.mcp.json

@@ -1,7 +1,7 @@
 {
   "mcpServers": {
     "ccg": {
-      "command": "ccg",
+      "command": "./ccg",
       "args": ["serve", "--db-driver", "sqlite", "--db-dsn", "ccg.db"]
     }
   }

Makefile

@@ -5,7 +5,7 @@ PKG       = github.com/tae2089/code-context-graph/cmd/ccg
 BASE_LDFLAGS = -X main.version=$(VERSION) -X main.commit=$(COMMIT) -X main.date=$(DATE)
 LDFLAGS      = -s -w $(BASE_LDFLAGS)
 
-.PHONY: build release build-debug install test test-integration-helpers clean
+.PHONY: build release build-debug build-json install vet test test-integration-helpers clean
 
 build: release
 
@@ -15,9 +15,15 @@ release:
 build-debug:
 	CGO_ENABLED=1 go build -tags "fts5" -ldflags '$(BASE_LDFLAGS)' -o ccg ./cmd/ccg/
 
+build-json:
+	CGO_ENABLED=1 go build -json -tags "fts5" ./... > build-results.json
+
 install:
 	CGO_ENABLED=1 go install -tags "fts5" -ldflags '$(LDFLAGS)' ./cmd/ccg/
 
+vet:
+	go vet ./...
+
 test: test-integration-helpers
 	CGO_ENABLED=1 go test -tags "fts5" ./...
 	bash ./scripts/integration-test-helpers_test.sh

guide/ko/README.md

@@ -17,5 +17,6 @@ code-context-graph의 문서 인덱스입니다. 한국어 문서는 영어 가
 | [사후 처리 실패 정책](postprocess-failure-policy.md) | 상태 규칙, 실패 원인, 빌드 및 사후 처리 도구의 자동 성능 저하(degraded)/폐쇄형 실패(fail_closed) 정책 |
 | [아키텍처](architecture.md) | 시스템 아키텍처, 데이터 흐름, DB 스키마 |
 | [개발(Development)](development.md) | 빌드, 테스트, 통합 테스트(Gitea + PostgreSQL) |
+| [Go 리팩터링 설계](go-refactoring-design.md) | Go 1.21-1.25 기능과 best practice 기반 리팩터링 계획 |
 | [네임스페이스 마이그레이션](namespace-migration.md) | 기본 네임스페이스 변경 및 마이그레이션 가이드 |
 | [CLAUDE.md 가이드](claude-md-guide.md) | CCG를 사용하는 프로젝트를 위한 CLAUDE.md 템플릿 |