Take the current plan all the way to a ready-to-merge pull request — review the plan (scaled to risk), implement it test-first, code-review and fix, security-review, verify the acceptance criteria, open the PR, and watch it green. Use after you have an approved plan (e.g. from plan mode) and want the rest of the feature pipeline run end-to-end. Invoking it is itself plan approval — it then runs autonomously to a single hard stop: ready-to-merge.

2026-07-101

test-single

adamayoung/popcorn

Run a specific test target or test class

Run all unit tests

Run snapshot tests

name	create-domain-model
description	Create a new domain model from TMDb

Create Domain Model

Guide for creating a new domain model from TMDb SDK types. See references/domain-model-patterns.md for code patterns, file locations, and common pitfalls.

Required Information

Ask the user for:

Context name (e.g., PopcornMovies, PopcornTVSeries)
TMDb type to map from (e.g., TMDb.Movie, TMDb.Person)
Domain model name (e.g., Movie, Person)
Properties to include (or "all" for every TMDb property)

TMDb Documentation

DocC documentation: https://adamayoung.github.io/TMDb/documentation/tmdb/

Source code (in Xcode DerivedData after build):

.../SourcePackages/checkouts/TMDb/Sources/TMDb/Domain/Models/

Steps

1. Create Domain Entity

File: Contexts/Popcorn<X>/Sources/<X>Domain/Entities/<Name>.swift
Conforms to: Identifiable, Equatable, Sendable

2. Create Adapter Mapper (TDD)

Test: Adapters/.../Tests/.../Mappers/<Name>MapperTests.swift
Source: Adapters/.../Sources/.../Mappers/<Name>Mapper.swift

3. Create SwiftData Entity

File: Contexts/Popcorn<X>/Sources/<X>Infrastructure/DataSources/Local/Models/<Context><Name>Entity.swift
Conforms to: Equatable, ModelExpirable

4. Create Infrastructure Mapper (TDD)

Test: Contexts/.../Tests/<X>InfrastructureTests/Mappers/<Name>MapperTests.swift
Source: Contexts/.../Sources/<X>Infrastructure/DataSources/Local/Mappers/<Name>Mapper.swift
Implement all 3 methods: entity->domain, domain->entity, update-in-place

5. Create Application Model

File: Contexts/Popcorn<X>/Sources/<X>Application/Models/<Name>Details.swift
Replace URL? paths with ImageURLSet?

6. Create Application Mapper (TDD)

Test: Contexts/.../Tests/<X>ApplicationTests/Mappers/<Name>DetailsMapperTests.swift
Source: Contexts/.../Sources/<X>Application/Mappers/<Name>DetailsMapper.swift

7. Create Test Helpers

<Name>+Mocks.swift in each test target that needs it

8. Wire into Data Sources, Repositories, Use Cases

Follow the /add-use-case skill for wiring into the architecture.

9. Verify

Run the full pre-PR checklist: make lint, /build, /test (formatting is applied automatically by the PostToolUse hook)

$ARGUMENTS