SKILL.md

name	webman-best-practices
description	MUST be used for Webman framework projects. Covers DDD architecture with controller/service/domain/infrastructure layers, strict dependency rules, lowercase directory naming, PER Coding Style with declare(strict_types=1) and final classes. Use when building Webman applications, implementing domain-driven design, or working with service layer patterns.
license	MIT
metadata	author version webman-design 1.0.0

Webman framework best practices following DDD architecture, dependency rules, and PER Coding Style.

Architecture & Dependencies

• Controller directly depends on Model, skipping Service layer → See controller-skip-service
• Domain layer depends on framework classes (Request, DB, etc.) → See domain-framework-dependency
• Service layer has circular dependencies with another Service → See service-circular-dependency
• Infrastructure layer not implementing Contract interface → See infrastructure-without-contract
• Using Model directly in Service instead of Repository → See service-direct-model-access

Naming Conventions

• Using camelCase or PascalCase for directories → See directory-lowercase
• Interface without Interface suffix → See interface-naming
• Service not following VerbNounService pattern → See service-naming-pattern
• Repository implementation without descriptive prefix → See repository-implementation-naming
• Namespace not matching directory structure → See namespace-directory-mismatch

Code Style (PER Coding Style)

• Missing declare(strict_types=1) at file start → See strict-types-declaration
• Not using final class by default → See prefer-final-classes
• Not using readonly for immutable properties → See readonly-properties
• Missing type declarations for parameters or return types → See complete-type-declarations
• Not using constructor property promotion → See constructor-property-promotion

Domain Patterns

• Entity without unique identity → See entity-identity
• Value object that is mutable → See value-object-immutability
• Business logic in Service instead of Domain → See business-logic-in-domain
• Not using domain events for side effects → See domain-events
• Anemic domain model with only getters/setters → See rich-domain-model

Dependency Injection

• Using static methods instead of dependency injection → See avoid-static-methods
• Not using constructor injection → See constructor-injection
• Service locator pattern instead of dependency injection → See no-service-locator