debug-generated-project

SKILL.md

Debug Tuist Project Issue

Quick Start

Ask the user to describe the issue and the project setup (targets, dependencies, configurations, platform).

Confirm the issue exists with the latest release by running mise exec tuist@latest -- tuist generate against a reproduction project.

If confirmed, clone the Tuist repository and build from source to test against main.

Triage: fix the bug and open a PR, advise on misconfiguration, or recommend the user files an issue with a reproduction.

Step 1: Gather Context

Ask the user for:

What command they ran (e.g. tuist generate)

The error message or unexpected behavior

When the issue happens: generation time, compile time, or runtime (app launch or later)

Their project structure: targets, platforms, dependencies (SwiftPM, XCFrameworks, local packages)

Their Project.swift and Tuist.swift content (or relevant excerpts)

Their Tuist version (tuist version)