skills/maxnorm/magento2-agent-skills/magento-feature-developer

magento-feature-developer

SKILL.md

Magento 2 Feature Developer

Expert specialist in translating business requirements into robust, scalable technical solutions within the Magento ecosystem following Adobe Commerce best practices.

When to Use

  • Implementing new business features
  • Developing custom functionality
  • Creating integrations with third-party systems
  • Building complex business logic
  • Extending existing Magento functionality

Feature Development Process

1. Discovery & Planning

  • Requirements Analysis: Break down business requirements into technical specifications
  • Stakeholder Interviews: Gather comprehensive requirements from business users
  • Technical Analysis: Assess existing system capabilities and constraints
  • Impact Assessment: Evaluate effects on performance, security, and scalability
  • Resource Planning: Estimate development timeline and requirements

2. Architecture Design

  • System Design: Create high-level architecture diagrams and component relationships
  • Database Design: Plan entity relationships, indexes, and data migration strategies
  • API Design: Define service contracts and data transfer objects
  • Integration Points: Identify touchpoints with existing modules and third-party systems
  • Performance Planning: Design for scalability and optimal response times

3. Implementation Strategy

  • Module Structure: Organize code following Magento's module conventions
  • Service Contracts: Implement clean API interfaces for feature contracts
  • Repository Pattern: Build data access layers using Magento's repository pattern
  • Configuration Management: Implement admin configuration options where appropriate
  • Error Handling: Build robust error handling and logging mechanisms

4. Quality Assurance

  • Unit Testing: Write comprehensive PHPUnit tests for business logic
  • Integration Testing: Test feature integration with core Magento functionality
  • Performance Testing: Ensure features don't degrade system performance
  • Security Review: Validate security compliance and data protection

Common Feature Types

E-commerce Features

  • Custom Product Types: Implement specialized product configurations
  • Pricing Rules: Build complex pricing and discount logic
  • Inventory Management: Create advanced inventory tracking and allocation
  • Order Processing: Implement custom order workflows and fulfillment
  • Customer Features: Build loyalty programs, wishlists, and customer dashboards

Administrative Features

  • Reporting & Analytics: Create custom reports and data visualization
  • Bulk Operations: Implement mass actions and data import/export
  • Workflow Automation: Build automated business processes
  • Content Management: Create custom content types and management interfaces
  • User Management: Implement role-based access and permission systems

Integration Features

  • Third-party APIs: Connect with external services and platforms
  • Data Synchronization: Build real-time or batch data sync processes
  • Webhook Integration: Implement event-driven integrations
  • File Processing: Handle document uploads, processing, and storage
  • Notification Systems: Build email, SMS, and push notification features

Development Patterns

Service Contracts

  • Create interfaces in Api/ directory
  • Implement clean API interfaces
  • Use data transfer objects (DTOs) for data exchange
  • Maintain backward compatibility

Repository Pattern

  • Separate data access from business logic
  • Use repositories for all data operations
  • Implement proper error handling
  • Support transactions where needed

Event/Observer Pattern

  • Dispatch events for extensibility
  • Implement observers for loose coupling
  • Use proper event naming conventions
  • Document event data structure

Plugin System

  • Use plugins to extend functionality
  • Prefer before/after plugins over around plugins
  • Document plugin execution order

Best Practices

Code Organization

  • Modular Design: Keep features self-contained within dedicated modules
  • Interface Segregation: Use small, focused interfaces
  • Dependency Injection: Leverage Magento's DI container
  • Configuration Management: Use XML configurations for flexibility
  • Namespace Organization: Follow PSR-4 autoloading standards

Performance Considerations

  • Lazy Loading: Implement lazy loading for expensive operations
  • Caching Strategy: Utilize appropriate cache types
  • Database Optimization: Use efficient queries and proper indexing
  • Frontend Optimization: Minimize JavaScript/CSS footprint
  • Resource Management: Monitor memory usage and execution time

Security

  • Input Validation: Implement comprehensive input validation
  • Output Escaping: Ensure proper output sanitization
  • CSRF Protection: Implement form key validation
  • Access Control: Enforce proper permission checking
  • Data Encryption: Handle sensitive data appropriately

Maintenance & Extensibility

  • Backward Compatibility: Ensure features work across Magento version upgrades
  • Extension Points: Provide hooks for other developers to extend features
  • Configuration Options: Allow customization without code modifications
  • Migration Scripts: Provide smooth upgrade paths
  • Documentation: Maintain comprehensive technical and user documentation

Testing Strategy

  • Unit Tests: Test individual classes and methods
  • Integration Tests: Test module integration with core
  • Functional Tests: End-to-end test scenarios
  • Performance Tests: Validate performance under load
  • Security Tests: Test authentication, authorization, and data protection

References

Focus on creating features that meet immediate business needs while providing a foundation for future growth and customization.

Weekly Installs
34
GitHub Stars
6
First Seen
Feb 17, 2026
Installed on
opencode32
codex32
gemini-cli30
github-copilot30
kimi-cli30
cursor30