skills.rest
modu-ai
modu-aiOFFICIAL
Explore all skills by this author →
Website𝕏@MODU_AIGitHub

hns-moaiadk-dev-reference

Provides version management, shell hook development, and build command reference for moai-adk-go.

1.2k|222|Updated Sep 16, 2025
Search Tags:#shell scripts#Makefile#version management#GO#MoAI-ADK#release process#claude code hooks
One-click install
npx skills add https://github.com/modu-ai/moai-adk --skill hns-moaiadk-dev-reference
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hns-moaiadk-dev-reference
Source: https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-moaiadk-dev-reference
Command: npx skills add https://github.com/modu-ai/moai-adk --skill hns-moaiadk-dev-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers working on the moai-adk-go repository need quick access to project-specific conventions for version management, hook development, and build commands without loading the full CLAUDE.local.md context every session.

Core Features & Use Cases

  • Version Management & Release Process: Documents git-tag-based versioning, ldflags build-time injection, and the exact files requiring version sync during releases.
  • Shell Script Hook Development: Explains the mandatory shell-script hook wrapper pattern, settings.json configuration format, and platform differences between macOS/Linux and Windows.
  • Build & Dev Commands: Lists Makefile targets (build, test, lint, fmt, install) and the standard template-editing development workflow.
  • Use Case: When cutting a new release of moai-adk, load this reference to follow the exact tag, changelog, and binary build sequence without re-reading the entire project documentation.

Quick Start

Load the moai-adk dev reference and walk me through the release process for version 1.0.0.

Frequently Asked Questions about hns-moaiadk-dev-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I release a new version of moai-adk?▼

Update CHANGELOG.md with the new version entry, create a git tag with git tag v1.0.0, push it with git push origin v1.0.0, then build release binaries using make release VERSION=1.0.0. Also sync version strings in README files and system.yaml configs.

How do I write a Claude Code hook for moai-adk?▼

Write a bash wrapper script that reads stdin JSON and pipes it to the moai binary hook subcommand, then register it in settings.json with a quoted $CLAUDE_PROJECT_DIR path. MoAI policy sets the hook timeout to 5 seconds.

Why does moai-adk use shell scripts instead of Python for hooks?▼

Shell scripts execute faster without Python startup overhead, are always available without depending on uv or python installations, and work cross-platform via bash or /bin/sh.

How is the version injected into the moai-adk Go binary?▼

Version is injected at build time using ldflags: go build -ldflags="-X github.com/modu-ai/moai-adk/pkg/version.Version=v1.0.0". The Makefile handles this automatically via make build VERSION=1.0.0, and pkg/version reads git tags.

What files need version updates during a moai-adk release?▼

Update README.md and README.ko.md version lines, CHANGELOG.md with a new entry, .moai/config/sections/system.yaml, and the template mirror internal/template/templates/.moai/config/sections/system.yaml.tmpl.

Related Skills

Explore More Software Engineering Skills→
ruifrvazruifrvaz
3

smaqit.release-git-local

Stage release files, commit, create an annotated tag, and push to remote.

Community
Intermediate
smart-swimmingpoolsmart-swimmingpool
25

release-please

Automate GitHub releases with Conventional Commits versioning and firmware binary deployment.

Official
Advanced
shenjingnanshenjingnan
333

dev-workflow-checker

Automate type checks, linting, and tests after code modifications.

Community
Intermediate
ascerra-fullsend-rehearsalascerra-fullsend-rehearsal

cutting-releases

Automate git tagging, GoReleaser binary builds, and GitHub releases.

Official
Intermediate