ajbcoding/moai-alfred-agent-factory

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