moai-alfred-agent-factory

name	moai-alfred-agent-factory
version	1.0.0
status	production
description	Agent Factory master skill for intelligent Claude Code agent generation. Includes requirement analysis, domain detection, model selection, template system, validation framework, and advanced features. Contains algorithms, workflows, and patterns.
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep"]
tags	["agent-factory","agent-generation","intelligence-engine","domain-detection","model-selection","context7","templates","validation"]

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 v4.0
    ↓
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:

1. Gate 1: YAML syntax validation
2. Gate 2: Required sections verification
3. Gate 3: Content quality checks
4. Gate 4: TRUST 5 + Claude Code v4.0 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-alfred-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 v4.0 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-alfred-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-alfred-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 v4.0 standards

---

🎓 Learning Path

New to agent-factory?

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

Integrating with your agent?

1. Load this skill with Skill("moai-alfred-agent-factory")
2. Reference specific algorithms from this overview
3. 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