Best Practices

Library

47 articles across 12 practice areas. Each article covers a single concept — opinionated, actionable, and designed to be embedded into AI personas as a guiding knowledge layer.

SOLID Principles

Five design principles for maintainable, extensible object-oriented code.

Single Responsibility Principle (SRP) Advisory Open/Closed Principle (OCP) Advisory Liskov Substitution Principle (LSP) Advisory Interface Segregation Principle (ISP) Advisory Dependency Inversion Principle (DIP) Advisory

Clean Code

DRY, KISS, YAGNI, meaningful names, and the craft of readable, honest code.

Don't Repeat Yourself (DRY) Soft Keep It Simple, Stupid (KISS) Advisory You Aren't Gonna Need It (YAGNI) Advisory Meaningful Names Soft Small Functions Advisory

Testing

TDD, BDD, the test pyramid, and the strategy behind confident delivery.

Test-Driven Development (TDD) Soft Behaviour-Driven Development (BDD) Advisory The Test Pyramid Soft Unit vs Integration vs E2E Testing Soft Mocking Strategy Advisory

Security

OWASP Top 10, input validation, secrets management, and least privilege.

OWASP Top 10 Hard Input Validation Hard Secrets Management Hard Principle of Least Privilege Hard

Architecture

12-Factor, separation of concerns, layered systems, and CQRS.

The Twelve-Factor App Advisory Separation of Concerns Soft Layered Architecture Advisory Command Query Responsibility Segregation (CQRS) Advisory

Delivery

CI/CD, definition of done, acceptance criteria quality, and continuous improvement.

Definition of Done (DoD) Hard Definition of Ready (DoR) Hard Acceptance Criteria Quality Hard Story Sizing Advisory CI/CD Pipelines Soft Continuous Improvement Soft

Performance

Lazy loading, caching strategy, N+1 prevention, and async patterns.

Lazy Loading Advisory Caching Strategy Advisory N+1 Query Prevention Soft Async Patterns Advisory

Observability

Structured logging, distributed tracing, SLOs/SLIs, and alerting principles.

Structured Logging Soft Distributed Tracing Advisory Alerting Principles Advisory SLOs, SLIs, and Error Budgets Advisory

Accessibility

WCAG 2.1 AA, semantic HTML, and ARIA landmarks.

WCAG 2.1 AA Compliance Soft Semantic HTML Soft ARIA Landmarks Advisory

Design

Design systems, user-centred design, and responsive layouts.

Design Systems Soft User-Centred Design Soft Responsive Design Soft

Infrastructure

Infrastructure as code and container strategy.

Infrastructure as Code Soft Container Strategy Advisory

Management

Engineering metrics, technical debt management, and continuous improvement.

Technical Debt Management Soft Engineering Metrics Soft