Hns Moaiadk Patterns

What it does

When your agent uses it

• Development work in your project

Example prompts

• “/hns-moaiadk-patterns”

Requirements

• Python 3
• Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1CLI (internal/cli/*.go, cmd/moai/) — Cobra commands: init,
2. 2Template system (internal/template/) — go:embed-based scaffolding.
3. 3Config (internal/config/) — defaults.go (single source for
4. 4Hook + CI (.claude/hooks/moai/*.sh, .github/workflows/) — bash

What it can do on your machine

Read from SKILL.md and the folder at commit 2aab5f7. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Grep
  • Glob
  • Bash

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • make
  • go

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hns Moaiadk Patterns loads about 1.8k tokens when it runs. Until then it costs about 133 tokens; SKILL.md has 566 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~133

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Grep, Glob, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from modu-ai/moai-adk at commit 2aab5f7, republished under its Apache-2.0 licence (© modu-ai). 566 words, ~1,810 tokens.

name

hns-moaiadk-patterns

description

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.

allowed-tools

Read, Grep, Glob, Bash

user-invocable

false

metadata.version

1.0.0

metadata.category

harness/domain-patterns

metadata.status

active

metadata.updated

2026-06-17

metadata.tags

moai-adk-go,cli,template,harness,patterns

progressive_disclosure.level_1_tokens

120

progressive_disclosure.level_2_tokens

4500

progressive_disclosure.level_3_optional

true

triggers.agents

cli-template-specialist, quality-specialist, workflow-specialist, hook-ci-specialist

CLI/Template ──→ quality ──→ workflow ──→ hook/CI
  │                │            │            │
  ├─ manager-develop (tdd, backend)
  ├─ Explore (read-only)
  ├─ sync-auditor (4-dim scoring)
  ├─ sync-phase-quality-gate.sh (Stop hook)
  ├─ manager-spec (plan)
  ├─ manager-develop (run)
  ├─ manager-docs (sync)
  ├─ plan-auditor (audit)
  ├─ builder-harness (artifact_type=hook|command|plugin)
  └─ Agent(general-purpose, tools: ..., prompt: "...CI specialist...")

© modu-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/hns-moaiadk-patterns of modu-ai/moai-adk.

Open the folder on GitHubat commit 2aab5f7