← Back to Skills

moai-foundation-ears

modu-ai
Updated 3 days ago
21 views
424
78
424
View on GitHub
Designaidesign

About

This Claude Skill implements an enterprise EARS framework for systematic problem-solving through AI-powered requirements engineering. It provides intelligent solution orchestration with Context7 integration for enhanced analysis capabilities. Use this skill when you need structured evaluation, analysis, and recommendation workflows for complex technical challenges.

Quick Install

Claude Code

Recommended
Plugin CommandRecommended
/plugin add https://github.com/modu-ai/moai-adk
Git CloneAlternative
git clone https://github.com/modu-ai/moai-adk.git ~/.claude/skills/moai-foundation-ears

Copy and paste this command in Claude Code to install this skill

Documentation

Enterprise EARS Framework Expert v4.0.0

Skill Metadata

FieldValue
Skill Namemoai-foundation-ears
Version4.0.0 (2025-11-13)
TierFoundation Framework Expert
AI-Poweredβœ… Context7 Integration, Intelligent Analysis
Auto-loadOn demand when systematic analysis keywords detected

What It Does

Enterprise EARS (Evaluate, Analyze, Recommend, Synthesize) Framework expert with AI-powered requirements engineering, Context7 integration, and intelligent solution orchestration for systematic problem-solving.

Revolutionary v4.0.0 capabilities:

  • πŸ€– AI-Powered EARS Analysis using Context7 MCP for latest problem-solving methodologies
  • πŸ“Š Intelligent Requirements Engineering with automated stakeholder analysis and validation
  • πŸš€ Advanced Solution Synthesis with AI-driven alternative evaluation and optimization
  • πŸ”— Enterprise Decision Framework with zero-configuration systematic thinking processes
  • πŸ“ˆ Predictive Solution Validation with success probability and risk assessment

When to Use

Automatic triggers:

  • Complex problem analysis and systematic solution design discussions
  • Requirements engineering and stakeholder alignment processes
  • Decision-making framework implementation and evaluation
  • Project planning and solution architecture validation

Manual invocation:

  • Applying EARS framework to complex business problems
  • Conducting systematic requirements analysis and validation
  • Designing solution alternatives with comprehensive evaluation
  • Implementing structured decision-making processes

Quick Reference (Level 1)

EARS Framework Overview

Four-Phase Systematic Analysis

  • E - Evaluate: Assess problem context, stakeholders, constraints
  • A - Analyze: Break down components, identify root causes, examine dependencies
  • R - Recommend: Generate solutions, evaluate alternatives, provide recommendations
  • S - Synthesize: Integrate solutions, create implementation plan, validate approach

Core Principles

  • Systematic Thinking: Structured approach to complex problems
  • Stakeholder-Centric: Focus on user and business requirements
  • Evidence-Based: Data-driven analysis and decision making
  • Iterative Refinement: Continuous improvement and validation

Application Areas

  • Requirements Engineering: Systematic requirement gathering and validation
  • Solution Architecture: Comprehensive solution design and evaluation
  • Project Planning: Structured project analysis and planning
  • Risk Management: Systematic risk identification and mitigation

Integration Benefits

  • Consistency: Standardized approach across projects
  • Quality: Thorough analysis reduces oversight and errors
  • Collaboration: Clear framework for team alignment
  • Documentation: Systematic record of analysis and decisions

Core Implementation (Level 2)

EARS Architecture Intelligence

# AI-powered EARS framework optimization with Context7
class EARSFrameworkOptimizer:
    def __init__(self):
        self.context7_client = Context7Client()
        self.requirements_analyzer = RequirementsAnalyzer()
        self.solution_synthesizer = SolutionSynthesizer()
    
    async def apply_ears_framework(self, 
                                 problem_context: ProblemContext,
                                 stakeholder_requirements: StakeholderRequirements) -> EARSAnalysis:
        """Apply EARS framework using AI-powered analysis."""
        
        # Get latest requirements engineering and problem-solving documentation via Context7
        requirements_docs = await self.context7_client.get_library_docs(
            context7_library_id='/requirements-engineering/docs',
            topic="stakeholder analysis systematic thinking 2025",
            tokens=3000
        )
        
        problem_solving_docs = await self.context7_client.get_library_docs(
            context7_library_id='/problem-solving/docs',
            topic="systematic analysis solution synthesis 2025",
            tokens=2000
        )
        
        # Phase E: Evaluate
        evaluation = await self._evaluate_context(
            problem_context,
            stakeholder_requirements,
            requirements_docs
        )
        
        # Phase A: Analyze
        analysis = await self._analyze_problem(
            problem_context,
            evaluation,
            problem_solving_docs
        )
        
        # Phase R: Recommend
        recommendations = await self._recommend_solutions(
            analysis,
            stakeholder_requirements,
            problem_solving_docs
        )
        
        # Phase S: Synthesize
        synthesis = await self._synthesize_solution(
            evaluation,
            analysis,
            recommendations,
            requirements_docs
        )
        
        return EARSAnalysis(
            evaluation=evaluation,
            analysis=analysis,
            recommendations=recommendations,
            synthesis=synthesis,
            confidence_score=self._calculate_confidence_score(evaluation, analysis),
            risk_assessment=self._assess_implementation_risks(synthesis)
        )

Phase E: Evaluation Implementation

class EvaluationEngine:
    async def evaluate_context(self, 
                             problem_context: ProblemContext,
                             stakeholder_requirements: StakeholderRequirements) -> Evaluation:
        """Comprehensive evaluation of problem context and stakeholders."""
        
        # Stakeholder Analysis
        stakeholder_analysis = await self._analyze_stakeholders(
            stakeholder_requirements.stakeholders,
            problem_context.business_domain
        )
        
        # Constraint Evaluation
        constraint_analysis = await self._evaluate_constraints(
            problem_context.constraints,
            problem_context.timeline,
            problem_context.budget
        )
        
        # Context Assessment
        context_assessment = await self._assess_context(
            problem_context.business_environment,
            problem_context.technical_landscape,
            problem_context.organizational_capability
        )
        
        return Evaluation(
            stakeholder_analysis=stakeholder_analysis,
            constraint_analysis=constraint_analysis,
            context_assessment=context_assessment,
            evaluation_summary=self._create_evaluation_summary(
                stakeholder_analysis, constraint_analysis, context_assessment
            ),
            critical_factors=self._identify_critical_factors(
                problem_context, stakeholder_requirements
            )
        )
    
    async def _analyze_stakeholders(self, 
                                  stakeholders: List[Stakeholder],
                                  business_domain: str) -> StakeholderAnalysis:
        """Analyze stakeholder requirements and influence."""
        
        stakeholder_matrix = {}
        
        for stakeholder in stakeholders:
            # Analyze requirements complexity
            complexity_score = self._calculate_requirement_complexity(
                stakeholder.requirements
            )
            
            # Assess influence and interest
            influence_score = self._assess_stakeholder_influence(
                stakeholder.role, business_domain
            )
            
            interest_score = self._assess_stakeholder_interest(
                stakeholder.requirements, stakeholder.motivations
            )
            
            # Identify potential conflicts
            conflicts = self._identify_requirement_conflicts(
                stakeholder.requirements, stakeholders
            )
            
            stakeholder_matrix[stakeholder.id] = StakeholderProfile(
                stakeholder=stakeholder,
                complexity_score=complexity_score,
                influence_score=influence_score,
                interest_score=interest_score,
                conflicts=conflicts,
                engagement_strategy=self._determine_engagement_strategy(
                    influence_score, interest_score
                )
            )
        
        return StakeholderAnalysis(
            stakeholder_matrix=stakeholder_matrix,
            stakeholder_map=self._create_stakeholder_map(stakeholder_matrix),
            conflict_matrix=self._create_conflict_matrix(stakeholder_matrix),
            engagement_plan=self._create_engagement_plan(stakeholder_matrix)
        )

Phase A: Analysis Implementation

class AnalysisEngine:
    async def analyze_problem(self, 
                            problem_context: ProblemContext,
                            evaluation: Evaluation,
                            problem_solving_docs: Dict) -> Analysis:
        """Deep analysis of problem structure and root causes."""
        
        # Component Breakdown
        component_analysis = await self._breakdown_components(
            problem_context.problem_statement,
            evaluation.context_assessment
        )
        
        # Root Cause Analysis
        root_cause_analysis = await self._analyze_root_causes(
            component_analysis,
            problem_context.symptoms,
            problem_context.business_impact
        )
        
        # Dependency Analysis
        dependency_analysis = await self._analyze_dependencies(
            component_analysis,
            problem_context.technical_landscape,
            evaluation.constraint_analysis
        )
        
        return Analysis(
            component_analysis=component_analysis,
            root_cause_analysis=root_cause_analysis,
            dependency_analysis=dependency_analysis,
            problem_complexity=self._assess_problem_complexity(
                component_analysis, root_cause_analysis, dependency_analysis
            ),
            key_insights=self._extract_key_insights(
                component_analysis, root_cause_analysis
            )
        )
    
    async def _analyze_root_causes(self, 
                                 component_analysis: ComponentAnalysis,
                                 symptoms: List[Symptom],
                                 business_impact: BusinessImpact) -> RootCauseAnalysis:
        """Perform comprehensive root cause analysis."""
        
        potential_causes = []
        
        for symptom in symptoms:
            # Use 5 Whys technique for root cause analysis
            root_causes = self._apply_5_whys(symptom)
            
            # Fishbone diagram analysis
            fishbone_causes = self._apply_fishbone_analysis(
                symptom, component_analysis
            )
            
            # Pareto analysis for impact prioritization
            pareto_analysis = self._apply_pareto_analysis(
                symptom, business_impact
            )
            
            potential_causes.append(CauseAnalysis(
                symptom=symptom,
                root_causes=root_causes,
                fishbone_causes=fishbone_causes,
                impact_analysis=pareto_analysis,
                confidence_score=self._calculate_cause_confidence(
                    root_causes, fishbone_causes, pareto_analysis
                )
            ))
        
        return RootCauseAnalysis(
            cause_analyses=potential_causes,
            root_cause_hierarchy=self._create_cause_hierarchy(potential_causes),
            impact_matrix=self._create_impact_matrix(potential_causes),
            validation_plan=self._create_validation_plan(potential_causes)
        )

Advanced Implementation (Level 3)

Phase R: Recommendations Implementation

class RecommendationEngine:
    async def recommend_solutions(self, 
                                analysis: Analysis,
                                stakeholder_requirements: StakeholderRequirements,
                                problem_solving_docs: Dict) -> Recommendations:
        """Generate and evaluate solution alternatives."""
        
        # Solution Generation
        solution_alternatives = await self._generate_solutions(
            analysis.root_cause_analysis,
            analysis.component_analysis,
            analysis.dependency_analysis
        )
        
        # Solution Evaluation
        solution_evaluation = await self._evaluate_solutions(
            solution_alternatives,
            stakeholder_requirements,
            analysis.constraint_analysis
        )
        
        # Risk Assessment
        risk_assessment = await self._assess_solution_risks(
            solution_evaluation.recommended_solutions,
            analysis.dependency_analysis
        )
        
        return Recommendations(
            solution_alternatives=solution_alternatives,
            solution_evaluation=solution_evaluation,
            risk_assessment=risk_assessment,
            implementation_timeline=self._create_implementation_timeline(
                solution_evaluation.recommended_solutions
            ),
            resource_requirements=self._calculate_resource_requirements(
                solution_evaluation.recommended_solutions
            )
        )
    
    async def _generate_solutions(self, 
                                root_cause_analysis: RootCauseAnalysis,
                                component_analysis: ComponentAnalysis,
                                dependency_analysis: DependencyAnalysis) -> List[SolutionAlternative]:
        """Generate comprehensive solution alternatives."""
        
        solutions = []
        
        # Solution Pattern 1: Address Root Causes Directly
        direct_solutions = self._generate_direct_solutions(root_cause_analysis)
        
        # Solution Pattern 2: System-Level Optimization
        system_solutions = self._generate_system_solutions(
            component_analysis, dependency_analysis
        )
        
        # Solution Pattern 3: Phased Implementation
        phased_solutions = self._generate_phased_solutions(
            root_cause_analysis, component_analysis
        )
        
        # Solution Pattern 4: Technology-Based Solutions
        technology_solutions = self._generate_technology_solutions(
            component_analysis, dependency_analysis
        )
        
        # Solution Pattern 5: Process-Based Solutions
        process_solutions = self._generate_process_solutions(
            root_cause_analysis, stakeholder_requirements
        )
        
        all_solutions = [
            *direct_solutions,
            *system_solutions,
            *phased_solutions,
            *technology_solutions,
            *process_solutions
        ]
        
        # Filter and rank solutions
        ranked_solutions = self._rank_solutions(all_solutions, root_cause_analysis)
        
        return ranked_solutions[:10]  # Return top 10 solutions

Phase S: Synthesis Implementation

class SynthesisEngine:
    async def synthesize_solution(self, 
                                evaluation: Evaluation,
                                analysis: Analysis,
                                recommendations: Recommendations,
                                requirements_docs: Dict) -> Synthesis:
        """Synthesize comprehensive solution implementation plan."""
        
        # Solution Integration
        integrated_solution = await self._integrate_solutions(
            recommendations.recommended_solutions,
            analysis.component_analysis
        )
        
        # Implementation Planning
        implementation_plan = await self._create_implementation_plan(
            integrated_solution,
            evaluation.constraint_analysis,
            recommendations.resource_requirements
        )
        
        # Success Metrics Definition
        success_metrics = await self._define_success_metrics(
            integrated_solution,
            evaluation.stakeholder_analysis,
            analysis.business_impact
        )
        
        # Risk Mitigation Strategy
        risk_mitigation = await self._create_risk_mitigation_strategy(
            recommendations.risk_assessment,
            implementation_plan
        )
        
        return Synthesis(
            integrated_solution=integrated_solution,
            implementation_plan=implementation_plan,
            success_metrics=success_metrics,
            risk_mitigation=risk_mitigation,
            governance_structure=self._define_governance_structure(
                evaluation.stakeholder_analysis, implementation_plan
            ),
            validation_criteria=self._create_validation_criteria(
                integrated_solution, success_metrics
            )
        )
    
    async def _create_implementation_plan(self, 
                                        integrated_solution: IntegratedSolution,
                                        constraint_analysis: ConstraintAnalysis,
                                        resource_requirements: ResourceRequirements) -> ImplementationPlan:
        """Create detailed implementation plan with phases and milestones."""
        
        # Phase 1: Foundation
        foundation_phase = ImplementationPhase(
            name="Foundation",
            duration="4-6 weeks",
            objectives=[
                "Establish project governance structure",
                "Set up development infrastructure",
                "Validate core assumptions",
                "Secure stakeholder buy-in"
            ],
            deliverables=[
                "Project charter",
                "Technical architecture",
                "Stakeholder approval",
                "Development environment"
            ],
            dependencies=[],
            risks=["Stakeholder alignment", "Technical feasibility"]
        )
        
        # Phase 2: Core Implementation
        core_phase = ImplementationPhase(
            name="Core Implementation",
            duration="8-12 weeks",
            objectives=[
                "Implement core solution components",
                "Integrate with existing systems",
                "Develop necessary tooling",
                "Establish monitoring and metrics"
            ],
            deliverables=[
                "Core solution implementation",
                "System integrations",
                "Monitoring dashboard",
                "Documentation"
            ],
            dependencies=[foundation_phase],
            risks=["Technical complexity", "Integration challenges"]
        )
        
        # Phase 3: Optimization
        optimization_phase = ImplementationPhase(
            name="Optimization",
            duration="4-8 weeks",
            objectives=[
                "Optimize solution performance",
                "Scale to full operation",
                "Train stakeholders",
                "Establish operational procedures"
            ],
            deliverables=[
                "Optimized solution",
                "Training materials",
                "Operational procedures",
                "Performance reports"
            ],
            dependencies=[core_phase],
            risks=["Performance issues", "User adoption"]
        )
        
        return ImplementationPlan(
            phases=[foundation_phase, core_phase, optimization_phase],
            timeline=self._create_detailed_timeline(
                [foundation_phase, core_phase, optimization_phase]
            ),
            resource_allocation=resource_requirements,
            governance_structure=self._define_phase_governance(),
            quality_gates=self._define_quality_gates()
        )

Reference & Integration (Level 4)

API Reference

Core EARS Operations

  • evaluate_context(problem_context, stakeholders) - Evaluate problem context
  • analyze_problem(evaluation, symptoms) - Analyze problem structure
  • recommend_solutions(analysis, constraints) - Generate solution recommendations
  • synthesize_solution(evaluation, analysis, recommendations) - Synthesize final solution
  • validate_implementation(synthesis, metrics) - Validate implementation approach

Context7 Integration

  • get_latest_requirements_docs() - Requirements engineering via Context7
  • analyze_systematic_thinking_patterns() - Problem-solving methodologies via Context7
  • optimize_solution_synthesis() - Solution optimization via Context7

Best Practices (November 2025)

DO

  • Follow the EARS framework systematically for complex problems
  • Involve all relevant stakeholders throughout the process
  • Use data-driven analysis for objective decision making
  • Document all assumptions, constraints, and decisions
  • Validate solutions with stakeholders before implementation
  • Consider multiple solution alternatives and approaches
  • Plan for risks and develop mitigation strategies
  • Establish clear success metrics and validation criteria

DON'T

  • Skip phases or rush through the systematic analysis
  • Ignore stakeholder requirements and concerns
  • Rely on assumptions without data validation
  • Overlook constraint analysis and resource limitations
  • Forget to document the analysis and decision process
  • Implement solutions without proper validation
  • Neglect risk assessment and mitigation planning
  • Skip success metrics definition and monitoring

Works Well With

  • moai-foundation-specs (SPEC lifecycle management)
  • moai-alfred-spec-authoring (SPEC creation and writing)
  • moai-foundation-trust (Trust and quality principles)
  • moai-domain-backend (Technical solution implementation)
  • moai-security-api (Security requirements analysis)
  • moai-essentials-perf (Performance requirements)
  • moai-domain-devops (Implementation planning)
  • moai-foundation-git (Version control and collaboration)

Changelog

  • v4.0.0 (2025-11-13): Complete Enterprise v4.0 rewrite with 40% content reduction, 4-layer Progressive Disclosure structure, Context7 integration, advanced systematic thinking patterns, and comprehensive solution synthesis
  • v2.0.0 (2025-11-11): Complete metadata structure, EARS framework patterns, stakeholder analysis
  • v1.0.0 (2025-11-11): Initial EARS framework foundation

End of Skill | Updated 2025-11-13

Framework Integration

EARS Integration Patterns

  • Seamless integration with SPEC lifecycle management
  • Stakeholder analysis integration with project governance
  • Solution synthesis integration with development workflows
  • Risk assessment integration with quality gates

Enterprise Adoption

  • Standardized problem-solving methodology across teams
  • Consistent documentation and decision-making processes
  • Integration with existing project management tools
  • Training and adoption support for organizations

End of Enterprise EARS Framework Expert v4.0.0

GitHub Repository

modu-ai/moai-adk
Path: .claude/skills/moai-foundation-ears
agentic-aiagentic-codingagentic-workflowclaudeclaudecodevibe-coding

Related Skills

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill

evaluating-llms-harness

Testing

This Claude Skill runs the lm-evaluation-harness to benchmark LLMs across 60+ standardized academic tasks like MMLU and GSM8K. It's designed for developers to compare model quality, track training progress, or report academic results. The tool supports various backends including HuggingFace and vLLM models.

View skill

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

llamaguard

Other

LlamaGuard is Meta's 7-8B parameter model for moderating LLM inputs and outputs across six safety categories like violence and hate speech. It offers 94-95% accuracy and can be deployed using vLLM, Hugging Face, or Amazon SageMaker. Use this skill to easily integrate content filtering and safety guardrails into your AI applications.

View skill