Create Repository

Generate Repository (commands) and Finder (queries) interfaces.

When to Use

• Entity needs persistence
• Implementing CQRS pattern
• Creating persistence layer ports

Inputs/Outputs

Note: entityPlural handles irregular plurals (Category→Categories, Entity→Entities).

Process

Structures

Repository (commands - throws exceptions):

interface EntityRepository {
    public function getByUuid(ResourceUuid $uuid): Entity; // throws EntityNotFound
    public function save(Entity $entity): void;
    public function delete(Entity $entity): void;
}

Finder (queries - returns null/array):

interface EntityFinder {
    public function find(ResourceUuid|string $uuid): ?Entity;
    public function findAll(): array; // @return Entity[]
    public function findByName(string $name): ?Entity;
}

See: docs/GLOSSARY.md#repository-vs-finder for detailed comparison

Rules

Repository (commands):

• Location: BC/Entities/Repository/
• Methods: get*() MUST throw exception if not found
• Common: getByUuid(), save(), delete()
• Used in: Use cases that MODIFY state (Create, Update, Delete)

Finder (queries):

• Location: BC/UseCases/Gateway/Finder/
• Methods: find*() MAY return null or empty array
• Common: find(), findAll(), findBy*()
• Used in: Use cases that READ state (List, Search, Find)

CRITICAL: Repository for writes (throws), Finder for reads (returns null/array)

Templates

• repository.php.tpl - Repository interface
• finder.php.tpl - Finder interface

Location: .claude/templates/

References

• Repository vs Finder: docs/GLOSSARY.md#repository-vs-finder
• Repository pattern: docs/QUICK_REF.md#repository-pattern
• Finder pattern: docs/QUICK_REF.md#finder-pattern

Related Skills

• create-entity - Create entity first
• create-use-case - Use repository/finder in use case