create-entity

Create Entity

Generate immutable domain entity following DDD patterns.

When to Use

• New business entity
• Domain model in BC
• Aggregate root
• Entity with domain behavior

Inputs/Outputs

Process

Structure

Entity (final, private constructor, static factory):

final class EntityName {
    private function __construct(
        private ResourceUuid $uuid,
        private NameField $name,
    ) {}

    public static function create(string $name): self {
        return new self(ResourceUuid::generate(), NameField::fromString($name));
    }

    public function uuid(): ResourceUuid { return $this->uuid; }
    public function name(): NameField { return $this->name; }

    public function rename(string $name): void {
        $this->name = NameField::fromString($name);
    }
}

See: docs/GLOSSARY.md#entity for detailed definition

Rules

Class Structure:

• final class, private constructor
• Static factory: create(), createFrom*(), reconstitute()
• No public properties, no setters

Methods:

• Getters return Value Objects: name() (not getName())
• Behaviors modify state: rename(), activate(), deactivate()
• Validate in behaviors, encapsulate business rules

Value Objects:

• Use existing VOs: Shared\Entities\VO\ (ResourceUuid, NameField, EmailField, PriceField)
• Create new VO if needed (skill: create-value-object)

Templates

• entity.php.tpl

Location: .claude/templates/

References

• Entity definition: docs/GLOSSARY.md#entity
• Entity pattern: docs/QUICK_REF.md#entity-pattern
• Architecture: docs/architecture.md#entity

Related Skills

• create-value-object - Create new Value Object
• create-use-case - Create use case using entity
• create-repository - Create repository for entity