apex-class

/apex-class

Work with Salesforce Apex classes across the full development lifecycle using --new, --review, --refine, or --bug-fix.

Usage

/apex-class --new          Create a new Apex class + test class
/apex-class --review       Review an existing class for quality, security, governor limits
/apex-class --refine       Modify an existing class (add feature, change behavior)
/apex-class --bug-fix      Diagnose and fix a bug in an existing class

---

--new: Create a New Apex Class

Gather Requirements

Ask the user:

1. What is the class name and its role? (Service, Selector, Controller, Utility, Domain, Batch — see patterns below)
2. What object(s) does it operate on?
3. What methods are needed? (brief description of each)
4. Any specific patterns? (TriggerHandler framework, Callable, Invocable, etc.)

Apex Class Patterns

Service Class — Business operations

public with sharing class AccountService {
    public static void processAccounts(List<Id> accountIds) {
        List<Account> accounts = AccountSelector.getById(accountIds);
        // business logic
        update accounts;
    }
}

Selector Class — Centralized SOQL queries (never in service/domain classes)

public inherited sharing class AccountSelector {
    public static List<Account> getById(Set<Id> accountIds) {
        return [SELECT Id, Name, Industry, OwnerId
                FROM Account
                WHERE Id IN :accountIds
                WITH USER_MODE];
    }
}

Controller (Apex for LWC) — @AuraEnabled methods only; thin layer

public with sharing class AccountController {
    @AuraEnabled(cacheable=true)
    public static List<Account> getAccounts(Id ownerId) {
        return AccountSelector.getByOwner(new Set<Id>{ownerId});
    }
}

Domain Class — Object-specific logic without DML/SOQL

public with sharing class AccountDomain {
    public static void setDefaultIndustry(List<Account> accounts) {
        for (Account acc : accounts) {
            if (String.isBlank(acc.Industry)) acc.Industry = 'Other';
        }
    }
}