Agent Factory Intelligence Engine

Master Skill for Intelligent Agent Generation

Complete reference for agent-factory agent to automatically generate production-ready Claude Code sub-agents through requirement analysis, research, template generation, and validation.

Version: 1.0.0 Status: Production Ready Components: 6 core systems + advanced features

🎯 Quick Start: The 6 Core Components

Component	Location	Purpose
Intelligence Engine	reference/intelligence-engine.md	Analyze requirements → domain/capabilities/complexity
Research Engine	reference/research-engine.md	Context7 MCP workflow → fetch docs → extract practices
Template System	reference/template-system.md	3-tier templates (Simple/Standard/Complex) + variables
Validation Framework	reference/validation-framework.md	4 quality gates + test cases
Advanced Features	reference/advanced-features.md	Versioning, multi-domain, optimization
Practical Examples	examples.md	3 main test cases + edge cases

🚀 Agent Generation Workflow

User Requirement
    ↓
[Stage 1-2] Intelligence Engine
  ├─ Parse requirement
  ├─ Detect domain (primary + secondary)
  ├─ Score complexity (1-10)
  ├─ Select model (Sonnet/Haiku/Inherit)
  └─ Calculate tools & skills
    ↓
[Stage 3] Research Engine (Context7 MCP)
  ├─ Resolve libraries
  ├─ Fetch documentation
  ├─ Extract best practices
  └─ Synthesize evidence
    ↓
[Stage 4-5] Template System
  ├─ Select template tier (1-3)
  ├─ Generate agent markdown
  └─ Apply variable substitution
    ↓
[Stage 6] Validation Framework
  ├─ Gate 1: YAML syntax
  ├─ Gate 2: Structure completeness
  ├─ Gate 3: Content quality
  └─ Gate 4: TRUST 5 + Claude Code  
    ↓
Production-Ready Agent ✅

📚 Understanding Each Component

Intelligence Engine

Responsible for: Requirement analysis and decision making

Key Algorithms:

Requirement Analysis: Extract domain, capabilities, complexity
Domain Detection: Primary + secondary domains with confidence
Complexity Scoring: 1-10 scale for model selection
Model Selection: Sonnet/Haiku/Inherit decision tree
Tool Calculator: Minimum necessary permissions
Skill Recommender: Match to 128+ MoAI-ADK skills

See: reference/intelligence-engine.md

Research Engine

Responsible for: Fetching official documentation and best practices

Key Workflows:

Library Resolution: Convert domain → Context7 library IDs
Documentation Fetch: Pull official docs from Context7 MCP
Best Practice Extraction: Identify actionable patterns
Pattern Identification: Architectural patterns for domain
Quality Validation: Ensure research meets 70%+ threshold
Evidence Synthesis: Consolidate into recommendations
Fallback Strategy: WebFetch if Context7 unavailable

See: reference/research-engine.md

Template System

Responsible for: Generating agent markdown with correct structure

Key Components:

Tier 1 (Simple): ~200 lines, Haiku, <5 min generation
Tier 2 (Standard): 200-500 lines, Inherit/Sonnet, <15 min
Tier 3 (Complex): 500+ lines, Sonnet, 20-30 min
Variables: 15+ categories for dynamic substitution
YAML Generation: Frontmatter with proper metadata

Template Files (in templates/ subfolder):

simple-agent.template.md – Tier 1 template for simple agents
standard-agent.template.md – Tier 2 template for standard agents
complex-agent.template.md – Tier 3 template for complex agents
VARIABLE_REFERENCE.md – Complete variable substitution guide

See: reference/template-system.md

Validation Framework

Responsible for: Ensuring agent quality meets all standards

4 Quality Gates:

Gate 1: YAML syntax validation
Gate 2: Required sections verification
Gate 3: Content quality checks
Gate 4: TRUST 5 + Claude Code compliance

Includes: 5 core test cases + 3 edge cases

See: reference/validation-framework.md

Advanced Features

Responsible for: Enterprise capabilities and optimization

Features:

Semantic Versioning: Track agent versions
Multi-Domain Support: 2-3 domain agents
Performance Analyzer: Automatic optimization suggestions
Enterprise Compliance: SOC2, GDPR, HIPAA support
Audit Logging: Activity tracking and monitoring

See: reference/advanced-features.md

🔗 Integration Points

With agent-factory Agent

---
name: agent-factory
model: sonnet
---

## Required Skills
Skill("moai-core-agent-factory")  # This master skill

# In execution:
1. Load this skill
2. Use Intelligence Engine (Stage 1-2)
3. Use Research Engine (Stage 3)
4. Use Template System (Stage 4-5)
5. Use Validation Framework (Stage 6)

With @agent-cc-manager

After generation, delegate to @agent-cc-manager for:

Claude Code compliance verification
.claude/settings.json validation
MCP server configuration check
Hook registration validation

With @agent-mcp-context7-integrator

Research Engine delegates to for:

Library ID resolution
Official documentation fetching
Best practice identification
Latest API version discovery

📊 Performance Expectations

Agent Type	Complexity	Generation Time	Result
Simple	1-3	<5 min	Tier 1 template
Standard	4-6	<15 min	Tier 2 template
Complex	7-10	20-30 min	Tier 3 template + orchestration

🧠 How to Use This Skill

For Agent-Factory Agent

# 1. Load this skill
skill = Skill("moai-core-agent-factory")

# 2. Use Intelligence Engine for analysis
domain = skill.intelligence_engine.detect_domain(user_input)
complexity = skill.intelligence_engine.complexity_score(domain, capabilities)
model = skill.intelligence_engine.select_model(complexity)

# 3. Use Research Engine for documentation
research = skill.research_engine.research_domain(domain, frameworks)
practices = research.best_practices
patterns = research.patterns

# 4. Use Template System for generation
template = skill.template_system.select_template(complexity)
agent_markdown = skill.template_system.generate_agent(
    template=template,
    variables={...}
)

# 5. Use Validation Framework for quality
validation = skill.validation_framework.validate(agent_markdown)
if validation.passed:
    return agent_markdown
else:
    return validation.issues

For Reference Lookup

Need specific information? Use the reference files:

"What model should I pick?" → See intelligence-engine.md
"How do I get best practices?" → See research-engine.md
"What variables exist?" → See template-system.md
"How are agents validated?" → See validation-framework.md

📖 Reference Files Organization

moai-core-agent-factory/
├── SKILL.md                        (this file - navigation hub)
├── reference/                      (detailed documentation)
│   ├── intelligence-engine.md      (280 lines: algorithms)
│   ├── research-engine.md          (320 lines: workflows)
│   ├── template-system.md          (280 lines: templates)
│   ├── validation-framework.md     (220 lines: testing)
│   └── advanced-features.md        (200 lines: enterprise)
├── templates/                      (reusable agent templates)
│   ├── simple-agent.template.md    (Tier 1: <200 lines, Haiku)
│   ├── standard-agent.template.md  (Tier 2: 200-500 lines)
│   ├── complex-agent.template.md   (Tier 3: 500+ lines)
│   └── VARIABLE_REFERENCE.md       (15+ variable categories)
├── examples.md                     (719 lines: use cases)
└── reference.md                    (400 lines: quick lookup)

✨ Key Highlights

✅ Comprehensive: 6 core systems with complete documentation ✅ Modular: Each system independently referenceable ✅ Practical: Includes algorithms with code examples ✅ Tested: 5 core + 3 edge case test scenarios ✅ Enterprise: Versioning, compliance, optimization ✅ Official: Follows Claude Code standards

🎓 Learning Path

New to agent-factory?

Read this overview
Review examples.md for practical cases
Dive into specific reference files as needed

Integrating with your agent?

Load this skill with Skill("moai-core-agent-factory")
Reference specific algorithms from this overview
Consult detailed docs in reference/ folder

Need specific feature? Use the component table above and jump to the corresponding reference file.

📞 Quick Reference

Question	Link
How do I analyze user requirements?	intelligence-engine.md → Requirement Analysis
How do I detect the domain?	intelligence-engine.md → Domain Detection
How do I select the right model?	intelligence-engine.md → Model Selection
How do I research best practices?	research-engine.md → Research Workflow
What templates are available?	template-system.md → Templates
How do I validate agents?	validation-framework.md → Quality Gates
Can I see examples?	examples.md
Need a quick lookup?	reference.md

Created: 2025-11-15 Version: 1.0.0 Status: Production Ready Total Content: 2,800+ lines across organized reference files