debug-generated-project
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)
More from tuist/agent-skills
using-tuist-generated-projects
Guides day-to-day work in Tuist-generated Xcode workspaces, including generation, build and test commands, and buildable folders. Use when working in a Tuist-generated project or when users mention `tuist generate`, `xcodebuild test`, or generated workspaces.
350migrating-to-tuist-generated-projects
Migrates existing Xcode projects to Tuist generated workspaces with build and run validation, external dependency mapping, and migration checklists. Use when adopting Tuist for an existing app or converting a hand-edited Xcode project to generated projects.
310fix-flaky-tests
Fixes flaky tests by analyzing failure patterns from Tuist test insights, identifying root causes, and applying targeted corrections. Can be invoked with a specific test case URL (e.g. `https://tuist.dev/{account}/{project}/tests/test-cases/{id}`) or without arguments to discover and fix all flaky tests in the project.
301compare-builds
Compares two Xcode build runs to identify duration regressions, cache changes, and new issues. Can be invoked with build IDs, dashboard URLs, or branch names (e.g. `tuist compare-builds --base main --head feature-branch`).
109compare-generations
Compares two `tuist generate` runs to identify cache hit rate changes and root-cause analysis of cache invalidation. Can be invoked with generation IDs, dashboard URLs, or branch names.
107analyze-selective-testing
Analyzes Xcode selective testing effectiveness for a test run, showing which test targets were skipped or ran, and diagnosing regressions in test selection. Can compare two test runs to identify what changed.
103