implement-feature

name	implement-feature
description	Guided Apple platform feature implementation across all layers of ProjectX Clean Architecture. Creates SwiftData models, domain entities, repositories, use cases, API requests, services, concurrency-first ViewModels, SwiftUI views, and navigation routes for Swift 6 and platform 26 targets.

Implement Feature — ProjectX Apple Platforms

Implementation Order

Follow this exact sequence for each new feature:

Step 1: Domain Layer

Entity — ProjectX/Domain/Entities/<Name>.swift

struct EntityName: Identifiable, Equatable {
    let id: String
    var name: String
    // business properties
}

Repository Protocol — ProjectX/Domain/Repositories/<Name>RepositoryProtocol.swift

protocol EntityRepositoryProtocol {
    func getAll() async throws -> [EntityName]
    func getById(_ id: String) async throws -> EntityName
    func create(_ entity: EntityName) async throws -> EntityName
    func delete(_ id: String) async throws
}

UseCase — ProjectX/Domain/UseCases/<Name>UseCase.swift

protocol EntityUseCaseProtocol {
    func execute() async throws -> [EntityName]
}

class EntityUseCase: EntityUseCaseProtocol {
    private let repository: EntityRepositoryProtocol
    init(repository: EntityRepositoryProtocol) { self.repository = repository }
    func execute() async throws -> [EntityName] { try await repository.getAll() }
}

Step 2: Data Layer

DTO — ProjectX/Data/Network/Models/<Name>DTO.swift

• Conform to APIResponseProtocol, Encodable, Identifiable
• Mark @MainActor if used in UI

Request — ProjectX/Data/Network/Requests/<Name>Request.swift

• Enum conforming to APITargetProtocol
• Cases for each CRUD operation
• Properties: path, method, body, authentication

Service — ProjectX/Data/Network/Services/<Name>Service.swift

• Protocol + implementation using APIClient
• async throws methods

Mapper — ProjectX/Data/Mappers/Remote/<Name>Mapper.swift

• Static toEntity(_:) and toDTO(_:) methods

Repository — ProjectX/Data/Repositories/<Name>Repository.swift

• Implements domain protocol
• Coordinates service + optional local storage

Step 3: Presentation Layer

Route — Add case to ProjectX/Presentation/Routing/Route.swift

case entityDetail  // or entityList, etc.

ViewModel — ProjectX/Presentation/Features/<Feature>/<Name>ViewModel.swift

• @MainActor @Observable class with Action/State enums or direct async methods
• Use send(_:), async helpers, Task, or AsyncStream when needed
• Inject use case via init

View — ProjectX/Presentation/Features/<Feature>/<Name>View.swift

• Use DS components: DSButton, DSText, DSTextField
• Access ViewModel via @State
• Send intents: viewModel.intent.send(.fetchData)

RouteContentView — Add case to switch in RouterView.swift

Step 4: Wiring

AppContainer — Add factory method in ProjectX/Shared /DI/ViewModelFactory.swift

Step 5: Localization

Add keys to ProjectX/Shared /Localization/Localized/Keys/

Verify-Fix Loop

After each step group, build:

xcodebuild -scheme ProjectX -destination 'generic/platform=iOS' build
xcodebuild -scheme ProjectX -destination 'generic/platform=macOS' build
# Optional when visionOS SDK is installed
xcodebuild -scheme ProjectX -destination 'generic/platform=visionOS' build

Max 3 retries per step. Fix errors before proceeding.

Self-Review

• Naming follows conventions (DS prefix, Protocol suffix)
• @Observable not ObservableObject
• Colors/fonts from DS enums
• Route case added and wired
• No Alamofire imports
• Localization keys for user-facing strings