harness-moaiadk-patterns

Featured

moai-adk-go domain-patterns reference for the 4 harness specialists (cli-template-specialist, quality-specialist, workflow-specialist, hook-ci-specialist). Covers the CLI/template/config/hook/spec subsystem architecture, key source paths, the Pipeline specialist delegation map, the Template-First build cycle, the namespace separation contract, and common add-a-template / add-a-hook / add-an-agent / add-a-SPEC workflows. Loaded by the specialists when working on moai-adk-go's own Go codebase and templates.

AI & Automation 1,120 stars 207 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
modu-ai
Repository
modu-ai/moai-adk
Created
9 months ago
Last Updated
today
Language
Go
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category