hns-moaiadk-patterns

# moai-adk-go Domain Patterns ## Architecture Quick Reference moai-adk-go is a Go binary (`moai`) with four subsystems: 1. **CLI** (`internal/cli/*.go`, `cmd/moai/`) — Cobra commands: `init`, `update`, `hook`, `build`, `glm`, `cc`, `cg`, `version`, `doctor`, `spec`. Subcommand handlers read stdin JSON for hooks, emit structured output for the orchestrator. 2. **Template system** (`internal/template/`) — `go:embed`-based scaffolding. Source at `internal/template/templates/`, embedded into the binary via `//go:embed all:templates` in `internal/template/embed.go` (no generated `.go` file). `make build` recompiles the binary. `TemplateContext` (`{{.GoBinPath}}` / `{{.HomeDir}}`) renders at `moai init`. 3. **Config** (`internal/config/`) — `defaults.go` (single source for thresholds), `envkeys.go` (env-var constants), `TemplateContext` renderer. 4. **Hook + CI** (`.claude/hooks/moai/*.sh`, `.github/workflows/`) — bash wrapper hooks calling `moai hook <event>`; CI guard enforces template neutrality. Plus the **SPEC lifecycle** (`.moai/specs/`) governing the project's own development (plan→run→sync→Mx). ## Key Source Paths | Subsystem | Path | Notes | |-----------|------|-------| | Cobra commands | `internal/cli/*.go` | wired from `cmd/moai/` | | Template source | `internal/template/templates/**` | edit HERE first | | Embedded assets | `internal/template/embed.go` | `//go:embed all:templates` (no generated file) | | Config defaults | `internal/con...