debug-generated-project
Installation
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 generateagainst 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.swiftandTuist.swiftcontent (or relevant excerpts) - Their Tuist version (
tuist version)