Claude-skill-registry acc-create-use-case

Generates Application Use Cases for PHP 8.5. Creates orchestration services that coordinate domain objects, handle transactions, and dispatch events. Includes unit tests.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/acc-create-use-case" ~/.claude/skills/majiayu000-claude-skill-registry-acc-create-use-case && rm -rf "$T"
manifest: skills/data/acc-create-use-case/SKILL.md
source content

Use Case Generator

Generate Application-layer Use Cases that orchestrate domain operations.

Use Case Characteristics

  • Single responsibility: One operation per use case
  • Orchestration: Coordinates domain objects
  • Transaction boundary: Manages atomicity
  • Event dispatch: Publishes domain events
  • No business logic: Delegates to domain
  • Framework agnostic: No HTTP/CLI concerns

When to Use

ScenarioExample
Create operation
CreateOrderUseCase
State transition
ConfirmOrderUseCase
External service integration
ProcessPaymentUseCase
Multi-step workflow
CheckoutUseCase

Generation Process

Step 1: Generate Use Case

Path:

src/Application/{BoundedContext}/UseCase/

  1. {Name}UseCase.php
    — Main orchestration class

Step 2: Generate Input DTO

Path:

src/Application/{BoundedContext}/DTO/

  1. {Name}Input.php
    — Input data container

Step 3: Generate Output DTO

Path:

src/Application/{BoundedContext}/DTO/

  1. {Name}Output.php
    — Result data container

Step 4: Generate Tests

Path:

tests/Unit/Application/{BoundedContext}/UseCase/


File Placement

ComponentPath
Use Case
src/Application/{BoundedContext}/UseCase/
Input DTO
src/Application/{BoundedContext}/DTO/
Output DTO
src/Application/{BoundedContext}/DTO/
Unit Tests
tests/Unit/Application/{BoundedContext}/UseCase/

Naming Conventions

PatternExample
Use Case
{Verb}{Entity}UseCase
Input DTO
{Name}Input
Output DTO
{Name}Output
or
{Entity}{Result}Output

Quick Template Reference

Use Case

final readonly class {Name}UseCase
{
    public function __construct(
        private {Repository}Interface $repository,
        private EventDispatcherInterface $events,
        private TransactionManagerInterface $transaction
    ) {}

    public function execute({Name}Input $input): {Name}Output
    {
        return $this->transaction->transactional(function () use ($input) {
            $aggregate = $this->repository->findById($input->id);
            $aggregate->doSomething($input->data);
            $this->repository->save($aggregate);

            foreach ($aggregate->releaseEvents() as $event) {
                $this->events->dispatch($event);
            }

            return new {Name}Output(...);
        });
    }
}

Input DTO

final readonly class {Name}Input
{
    public function __construct(
        public {ValueObject} $id,
        {additionalProperties}
    ) {}
}

Output DTO

final readonly class {Name}Output
{
    public function __construct(
        public string $id,
        {resultProperties}
    ) {}

    public function toArray(): array
    {
        return ['id' => $this->id, ...];
    }
}

Anti-patterns to Avoid

Anti-patternProblemSolution
Business LogicDecisions in use caseDelegate to domain
Multiple AggregatesTransaction spans aggregatesOne aggregate per transaction
Direct Repo CallsBypassing use caseAlways use use case
Missing TransactionNo atomicityWrap in transaction
External in TransactionLong-running transactionsExternal calls outside

References

For complete PHP templates and examples, see:

  • references/templates.md
    — UseCase, Input, Output, Test templates with design principles
  • references/examples.md
    — CreateOrder, ConfirmOrder, ProcessPayment examples and tests