hns-moaiadk-dev-reference

# hns-moaiadk-dev-reference > moai-adk-go 로컬 dev 레퍼런스 — `CLAUDE.local.md` §5/§7/§10 의 작업 특화 상세를 이곳으로 이관 (lazy-load). 세션마다 필요 없는 참고 자료. 항상-로드 컨텍스트 절감용. > 소유: `hns-*` 네임스페이스 (user-owned, `moai update` 보존 — CLAUDE.local.md §24). 템플릿 미러 금지. --- ## Version Management (from CLAUDE.local.md §5) ### Single Source of Truth - [HARD] `go.mod` module version + git tags are the authoritative sources - [HARD] `pkg/version/version.go` reads from git tags at build time **Version Reference:** - Authoritative Source: Git tags (e.g., `v1.0.0`) - Runtime Access: `pkg/version/version.go` via `git describe` - Config Display: `.moai/config/sections/system.yaml` (updated by release process) ### Build Version Injection Version is injected at build time using ldflags: ```bash # Build with version injection go build -ldflags="-X github.com/modu-ai/moai-adk/pkg/version.Version=v1.0.0" # Makefile handles this automatically make build VERSION=1.0.0 ``` ### Files Requiring Version Sync When releasing new version, update: **Documentation Files:** - README.md (Version line) - README.ko.md (Version line) - CHANGELOG.md (New version entry) **Configuration Files:** - .moai/config/sections/system.yaml (moai.version) - internal/template/templates/.moai/config/sections/system.yaml.tmpl (moai.version) ### Release Process 1. Update CHANGELOG.md with new version entry 2. Create git tag: `git tag v1.0.0` 3. Push tag: `git push origin v1.0.0` 4. Build release binaries: `make release VERSION=1.0.0` --- ...