BUILD AND RUNTIME DIAGNOSTICS / Affaan Mustafa
Swift build error resolver
Diagnoses Swift/Xcode compilation, package resolution and concurrency errors, with explicit stops for signing or ownership redesign.
“Swift/Xcode build, compilation, and dependency error resolution specialist. Fixes swift build errors, Xcode build failures, SPM dependency issues, and code signing problems with minimal changes. Use when Swift builds fail.”
01 / THE REASONING
Why this made the selection.
- It distinguishes SPM resolution, protocol/type failures, actor isolation and Sendable issues.
- It forbids using unchecked Sendable or force unwraps merely to silence errors and requires rechecking each change.
- It targets swift build, SPM, and xcodebuild failures, and it forbids silencing an optional with a force unwrap or a concurrency error with @unchecked Sendable unless thread safety was verified.
- It stops for a missing provisioning profile or certificate and says that case needs the user, rather than inventing a signing identity.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- agents/swift-build-resolver.md (complete definition)
- LICENSE (applicable redistribution terms)
- Host custom-agent documentation; repository installation guidance where applicable
Our findings
- It distinguishes SPM resolution, protocol/type failures, actor isolation and Sendable issues.
- It forbids using unchecked Sendable or force unwraps merely to silence errors and requires rechecking each change.
- Tools are Read, Write, Edit, Bash, Grep, and Glob, with model sonnet.
- Key principles forbid force unwrap as a silence, @unchecked Sendable without a thread-safety check, and swiftlint:disable without approval.
- Stop conditions add actor-isolation redesign and a missing provisioning profile or certificate, which the file says requires user action.
- The definition is Markdown with frontmatter. Host docs say that becomes a subagent when the file lives in ~/.claude/agents/, which this repository path is not.
Not established by this review
- No agent was installed or invoked. Host/model compatibility, task accuracy and runtime behaviour were not tested.
- The resource was not executed and its tools were not called.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
- Read the pinned definition and MIT licence; review the host permissions before use.
- Inspect the complete upstream context, place the agent in .claude/agents/ and limit edits/commands to a disposable checkout and the failing target.
- Provide a failing Swift package or Xcode scheme, complete error output, toolchain version and intended destination.
Before you start
- Claude Code and a supported model
- The project-specific Swift toolchain, dependencies and a reproducible failure
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/agents/swift-build-resolver.md
Supports: Workflow, inputs and outputs, Declared tools and constraints, Selection and limitations
https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/LICENSE
Supports: Licence and attribution requirements
https://code.claude.com/docs/en/sub-agents.md
Supports: Host setup and permission defaults