create-use-case

name	create-use-case
description	Create a new business use case (Request + UseCase + Test) following TDD workflow. Use when user asks to implement new business logic, domain operations, or create commands/queries. Always follow Red-Green-Refactor cycle.

Create Use Case

Generate Request, UseCase, and Test following TDD workflow.

IMPORTANT: Always uses tdd-workflow skill (MANDATORY)

---

When to Use

• New business logic
• Domain operations
• Commands (Create, Update, Delete, Rename)
• Queries (Find, List, Search)

---

Inputs/Outputs

Input	Example	Output
bc	Admin	BC/UseCases/Entity/ActionEntity/
entity	Article	ActionEntity.php (UseCase)
action	Rename	ActionEntityRequest.php (Request)
fields	['name']	ActionEntityTest.php (Test)

---

Process

Follow: .claude/skills/tdd-workflow/ (MANDATORY)

Phase	File	Template
RED	Test.php	.claude/templates/test-unit.php.tpl
GREEN	Request.php + UseCase.php	.claude/templates/request.php.tpl, use-case.php.tpl
REFACTOR	-	make cs-fixer && make stan && make ta
VALIDATE	-	make qa

---

Structures

Request (interface):

interface ActionEntityRequest {
    public function uuid(): ResourceId;
    public function field(): string;
}

UseCase (readonly, single execute()):

final readonly class ActionEntity {
    public function __construct(private EntityRepository $repo) {} // OR Finder
    public function execute(ActionEntityRequest $req): ActionEntityResponse {
        // Business logic
        return new ActionEntityResponse($entity);
    }
}

See: docs/QUICK_REF.md#usecase-pattern for complete structure

Note: Project uses Request-Response pattern. Symfony Maker bin/console make:use-case:create <bc> <name> generates all 3 files (Request, UseCase, Response).

---

Rules

Repository vs Finder:

• Commands (CUD) → Repository
• Queries (R) → Finder

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

Tests:

• Use DataBuilder (NOT Foundry)
• Mock: expects()->once()

---

Templates

• test-unit.php.tpl
• request.php.tpl
• use-case.php.tpl

Location: .claude/templates/

---

References

• TDD workflow: .claude/skills/tdd-workflow/
• Quick pattern: docs/QUICK_REF.md#usecase-pattern
• Architecture: docs/architecture.md#usecase