---

name: create-repository description: Create Repository interface and Finder interface for domain entity persistence. Use when entity needs persistence layer with commands (save, delete) and queries (find, findAll). Generates both Repository (commands) and Finder (queries) following CQRS pattern.

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):

Copyinterface 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):

Copyinterface 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