moai-harness-cli-template

name	moai-harness-cli-template
description	CLI/Template domain knowledge for moai-adk-go covering cobra commands, go:embed template system, YAML config, and template rendering pipeline.
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read, Grep, Glob, Bash
user-invocable	false
metadata	{"version":"1.0.0","category":"domain","status":"active","updated":"2026-05-14","modularized":"false","tags":"cli, template, cobra, go:embed, config, yaml, moai-cli"}
progressive_disclosure	{"enabled":true,"level1_tokens":100,"level2_tokens":5000}
triggers	{"keywords":["cobra","command","template","embed","config","yaml","moai init","moai update","moai build","rendering","internal/cli","internal/template"],"agents":["moai-harness-cli-template-specialist","expert-backend"],"phases":["run"],"languages":["go"]}

CLI/Template Domain Knowledge

Domain-specific knowledge for moai-adk-go's CLI and template system. Supplements expert-backend with project-specific patterns.

Quick Reference

Architecture Overview

moai binary (Go)
  ├── internal/cli/          ~50 cobra command files
  ├── internal/template/
  │   ├── templates/         Source of truth for all templates
  │   ├── embedded.go        Auto-generated (go:embed)
  │   ├── context.go         TemplateContext with GoBinPath, HomeDir
  │   └── renderer.go        Template rendering engine
  └── internal/config/       Configuration loading and defaults

Key Patterns

1. Template-First Rule: New files under .claude/ or .moai/ must be added to internal/template/templates/ first, then make build
2. Embedded System: //go:embed templates/* in embedded.go -- auto-generated, never edit
3. Template Variables: {{.GoBinPath}} (init-time absolute), {{.HomeDir}} (init-time absolute)
4. Fallback Paths: Use $HOME (not .HomeDir) in .sh.tmpl files for runtime flexibility
5. 16-Language Neutrality: Templates treat all 16 supported languages equally -- no "PRIMARY" language

Build Cycle

# 1. Edit templates
vim internal/template/templates/.claude/skills/...

# 2. Regenerate embedded files
make build

# 3. Run tests
go test ./internal/template/...

# 4. Verify
ls -la internal/template/embedded.go

Command Structure

Each cobra command lives in internal/cli/<command>.go with corresponding tests in <command>_test.go. Commands follow the pattern:

• rootCmd in root.go with subcommands registered via init()
• Each command file: var <cmd>Cmd = &cobra.Command{...} + func init() { rootCmd.AddCommand(...) }

Configuration System