moai-foundation-ears
About
This Claude Skill implements the Enterprise EARS framework for systematic problem-solving through AI-powered requirements engineering. It provides intelligent evaluation, analysis, recommendation, and synthesis capabilities with Context7 integration for enhanced context awareness. Use this skill when you need structured analysis of complex problems or systematic solution orchestration in development workflows.
Quick Install
Claude Code
Recommended/plugin add https://github.com/modu-ai/moai-adkgit clone https://github.com/modu-ai/moai-adk.git ~/.claude/skills/moai-foundation-earsCopy and paste this command in Claude Code to install this skill
Documentation
Enterprise EARS Framework Expert v4.0.0
Skill Metadata
| Field | Value |
|---|---|
| Skill Name | moai-foundation-ears |
| Version | 4.0.0 (2025-11-13) |
| Tier | Foundation Framework Expert |
| AI-Powered | β Context7 Integration, Intelligent Analysis |
| Auto-load | On 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 contextanalyze_problem(evaluation, symptoms)- Analyze problem structurerecommend_solutions(analysis, constraints)- Generate solution recommendationssynthesize_solution(evaluation, analysis, recommendations)- Synthesize final solutionvalidate_implementation(synthesis, metrics)- Validate implementation approach
Context7 Integration
get_latest_requirements_docs()- Requirements engineering via Context7analyze_systematic_thinking_patterns()- Problem-solving methodologies via Context7optimize_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
Related Skills
sglang
MetaSGLang 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.
evaluating-llms-harness
TestingThis 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.
content-collections
MetaThis 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.
llamaguard
OtherLlamaGuard 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.
