What is moai-foundation-claude?

The MoAI Foundation Claude skill is a comprehensive authoring kit designed to streamline the development of Claude Code skills, sub-agents, and custom commands. It provides a standardized framework for orchestration, memory management, and IAM permission rules, ensuring that AI-driven workflows are built with official compliance, security, and high-performance architectural patterns.

When should I use moai-foundation-claude?

moai-foundation-claude is useful in the following scenarios: • Standardized Skill Authoring: Rapidly create new Claude Code skills using official templates and progressive disclosure patterns to ensure maintainability and performance. • Complex Agent Orchestration: Implement sophisticated sub-agent delegation patterns, including sequential and parallel task execution, to solve multi-layered engineering problems. • Event-Driven Automation: Configure custom hooks (PreToolUse/PostToolUse) to automate validation, logging, or backup tasks whenever specific tools are triggered by the agent. • Secure IAM Configuration: Establish granular access controls and tiered permission levels (Read, Bash, Write, Admin) to ensure AI agents operate safely within enterprise environments. • Context & Memory Management: Optimize agent performance by implementing hierarchical memory structures across enterprise, project, and user levels for persistent knowledge.

moai-foundation-claude – AI Agent Skills

name	moai-foundation-claude
aliases	[moai-foundation-claude]
category	foundation
description	Canonical Claude Code skill authoring kit covering agent Skills, sub-agent templates, custom slash commands, orchestration patterns, hooks, memory, settings, and IAM permission rules aligned with official documentation.
version	2.0.0
modularized	false
Skills	`~/.claude/skills/` (personal) or `.claude/skills/` (project), ≤500 lines, progressive disclosure
Sub-agents	`Task(subagent_type="...")` delegation only, no nested spawning
Commands	`$ARGUMENTS`/`$1`/`$2` parameters, `@file` references, stored in `.claude/commands/`
Hooks	Event-driven automation in `settings.json`, PreToolUse/PostToolUse events
Memory	Enterprise → Project → User hierarchy, `@import.md` syntax
Settings	4-tier hierarchy (Enterprise → User → Project → Local)
IAM	Tiered permissions (Read→Bash→Write→Admin), tool-specific rules
Pattern 1	Skill Creation (≤500 lines)

name: skill-name description: One-line description (max 200 chars) version: 1.0.0 updated: 2025-11-26 status: active

Quick Reference (30 seconds)

Implementation Guide (5 minutes)

Advanced Implementation (10+ minutes)


Pattern 2: Sub-agent Delegation
```python
# Sequential delegation
result1 = Task(subagent_type="workflow-spec", prompt="Analyze")
result2 = Task(subagent_type="code-backend", prompt="Implement", context=result1)

# Parallel delegation
results = await Promise.all([
 Task(subagent_type="code-backend", prompt="Backend"),
 Task(subagent_type="code-frontend", prompt="Frontend")
])

Pattern 3: Custom Command with Hooks

{
 "hooks": {
 "PreToolUse": [{
 "matcher": "Write",
 "hooks": [{"type": "command", "command": "validate-write"}]
 }]
 }
}

MoAI-ADK Skills & Sub-agents Directory

Quick Access Patterns

Core Skills: Skill("moai-foundation-claude") - This comprehensive authoring kit Agent Creation: Task(subagent_type="agent-factory") - Create standardized sub-agents Skill Creation: Task(subagent_type="skill-factory") - Create compliant skills Quality Gates: Task(subagent_type="quality-gate") - TRUST 5 validation Documentation: Task(subagent_type="docs-manager") - Generate technical docs

Key Specialized Skills:

moai-lang-python - Python 3.13+ with FastAPI, async patterns
moai-lang-typescript - TypeScript 5.9+ with React 19, Next.js 16
moai-domain-backend - Modern backend architecture patterns
moai-domain-frontend - React 19, Next.js 15, Vue 3.5 frameworks
moai-quality-security - OWASP Top 10, threat modeling
moai-essentials-debug - AI-powered debugging with Context7

Essential Sub-agents:

spec-builder - EARS format specification generation
tdd-implementer - RED-GREEN-REFACTOR TDD execution
security-expert - Security analysis and validation
backend-expert - Backend architecture and API development
frontend-expert - Frontend UI implementation
performance-engineer - Performance optimization and analysis

Essential Implementation Patterns

Command→Agent→Skill Orchestration

Sequential Workflow:

# Phase 1: Analysis → spec-builder → analysis
analysis = Task(subagent_type="spec-builder", prompt="Analyze: $ARGUMENTS")
# Phase 2: Implementation → tdd-implementer → code + tests
implementation = Task(subagent_type="tdd-implementer", prompt="Implement: $analysis.spec_id")
# Phase 3: Validation → quality-gate → approval
validation = Task(subagent_type="quality-gate", prompt="Validate: $implementation")

Parallel Development:

# Execute independent tasks simultaneously
results = await Promise.all([
 Task(subagent_type="backend-expert", prompt="Backend: $1"),
 Task(subagent_type="frontend-expert", prompt="Frontend: $1"),
 Task(subagent_type="docs-manager", prompt="Docs: $1")
])
# Integrate all results
Task(subagent_type="quality-gate", prompt="Integrate", context={"results": results})

Token Session Management

Independent 200K Sessions: Each Task() creates a new 200K token context

Task(subagent_type="backend-expert", prompt="Complex task") # 200K session
Task(subagent_type="frontend-expert", prompt="UI task") # New 200K session

File Reference Patterns

Parameter Handling:

Positional: $1, $2, $3
All arguments: $ARGUMENTS
File references: @config.yaml, @path/to/file.md

Hook Integration

Pre/Post Tool Execution (see Hooks Guide):

{
 "hooks": {
 "PreToolUse": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "validate-command"}]}],
 "PostToolUse": [{"matcher": "Write", "hooks": [{"type": "command", "command": "backup-file"}]}]
 }
}

Key Reference Guides

Comprehensive Documentation:

Commands Guide - Complete command creation
Hooks System - Event-driven automation
Memory Management - Context persistence
Settings Config - Configuration hierarchy
IAM Permissions - Access control
Complete Setup - Full configuration

Works Well With

moai-core-agent-factory - For creating new sub-agents with proper standards
moai-cc-commands - For creating custom slash commands
moai-cc-hooks - For implementing Claude Code hooks
moai-cc-configuration - For managing Claude Code settings
moai-quality-gate - For validating code quality standards
moai-essentials-debug - For debugging skill loading issues

moai-foundation-claude

When & Why to Use This Skill

Use Cases