Apply software design principles across architecture and implementation using deterministic decision workflows, SOLID checks, structural patterns, and anti-pattern detection; use when reviewing designs, refactoring modules, or resolving maintainability and coupling risks.
Does it follow best practices?
Evaluation — 99%
↑ 1.01xAgent success when using this tile
Validation for skill structure
Boundaries are expensive to create and maintain, but ignoring needed boundaries becomes very expensive later. Continuously evaluate where the cost of implementing is less than the cost of ignoring.
Incorrect (boundary everywhere - over-engineering):
// Overkill for a simple CRUD app with 3 entities
// 9 interfaces for 3 entities
interface UserRepository { }
interface UserService { }
interface UserPresenter { }
interface ProductRepository { }
interface ProductService { }
interface ProductPresenter { }
interface OrderRepository { }
interface OrderService { }
interface OrderPresenter { }
// 9 implementations
class SqlUserRepository implements UserRepository { }
class UserServiceImpl implements UserService { }
class UserPresenterImpl implements UserPresenter { }
// ... 6 more classes
// 3 factories
class UserFactory { }
class ProductFactory { }
class OrderFactory { }
// Result: 100 files for functionality that could be 20 files
// Maintenance burden exceeds benefit for small teamIncorrect (no boundaries - under-engineering):
// Dangerous for a complex domain with multiple teams
class GodService {
public void handleEverything(Request req) {
// 2000 lines mixing:
// - User authentication
// - Order processing
// - Payment handling
// - Email notifications
// - Report generation
}
}
// Result: Every change risks breaking unrelated features
// No team can work independentlyCorrect (boundaries where they matter):
// Evaluate each potential boundary:
// HIGH VALUE BOUNDARY: External payment provider
// - Changes frequently (provider updates API)
// - Risk of vendor lock-in
// - Different team might own this
interface PaymentGateway {
PaymentResult charge(Money amount, PaymentMethod method);
}
// MEDIUM VALUE BOUNDARY: Database access
// - Might migrate databases
// - Enables testing without DB
interface OrderRepository {
void save(Order order);
Order findById(OrderId id);
}
// LOW VALUE - SKIP FOR NOW: Presenter/View split
// - Single frontend, single team
// - No plans to support multiple UIs
// Just put formatting in React components for now
// Add boundary later if needed
// SKIP: Separate microservices
// - Team is 5 people
// - Deployment is monolithic anyway
// - Network boundary adds latency and complexity for no benefitDecision Framework:
| Factor | Add Boundary | Skip Boundary |
|---|---|---|
| Change frequency | High | Low |
| Team ownership | Multiple teams | Single team |
| External dependency | Yes | No |
| Testing difficulty | Hard without boundary | Easy anyway |
| Current pain | Evident | Hypothetical |
Reference: Clean Architecture - The Cost of Boundaries
Install with Tessl CLI
npx tessl i pantheon-ai/software-design-principlesevals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
references