用途：该参考把 CLAUDE.local.md §5/§7/§10 中偏工作流特化的细节迁移出来，按需（lazy-load）加载，避免每个会话常驻携带无用内容。归属 hns-* 用户命名空间，moai update 会保留，禁止镜像到模板。
版本管理与发布：go.mod 模块版本与 git tag 是权威来源；pkg/version/version.go 在构建期读取 git tag；运行期通过 git describe 访问；.moai/config/sections/system.yaml 由发布流程更新显示。构建期用 ldflags 注入版本，例如 go build -ldflags="-X github.com/modu-ai/moai-adk/pkg/version.Version=v1.0.0"，Makefile 自动处理：make build VERSION=1.0.0。发布需同步的文件包括 README.md、README.ko.md、CHANGELOG.md、.moai/config/sections/system.yaml 及模板 internal/template/templates/.moai/config/sections/system.yaml.tmpl 的 moai.version。发布流程：更新 CHANGELOG、git tag v1.0.0、git push origin v1.0.0、make release VERSION=1.0.0。
钩子开发：只使用 Shell 脚本（非 Python）。包装模式为读取 stdin JSON 并调用 moai binary 子命令：INPUT=$(cat); moai hook session-start <<< "$INPUT"。原因：启动更快、不依赖 uv/python、跨平台。settings.json 中需对 $CLAUDE_PROJECT_DIR 加引号、使用包装脚本全路径、设置合适 timeout，MoAI 策略默认 5 秒（平台默认 10 分钟被收紧）。Windows 路径使用 %CLAUDE_PROJECT_DIR%。
构建与开发命令：make build、make test、make test-race、make lint、make fmt、make install、make clean、make fix。开发流程：编辑模板、make build 重新生成嵌入文件、go test ./internal/template/...、./moai init test-project 本地测试、提交。
限制：仅覆盖资料所述三节内容，其他功能与最新版本差异暂未提供。