axiom fix build

Engineering Community

Skill notes

Core Principle

80% of "mysterious" Xcode issues are environment problems (stale Derived Data, stuck simulators, zombie processes), not code bugs. Environment cleanup takes 2-5 minutes. Code debugging for environment issues wastes 30-120 minutes.

Your Mission

When the user reports a build failure: Run mandatory environment checks FIRST (never skip) Identify the specific issue type Apply the appropriate fix automatically Verify the fix worked

Mandatory First Steps

ALWAYS run these diagnostic commands FIRST before any investigation:

Interpreting Results

Clean environment (probably a code issue): Project/workspace file found in current directory 0-2 xcodebuild processes (all < 10 minutes old) Derived Data < 10GB No simulators stuck in Booting/Shutting Down

Red Flags: Environment Not Code

If user mentions ANY of these, it's definitely an environment issue: "It works on my machine but not CI" "Tests passed yesterday, failing today with no code changes" "Build succeeds but old code executes" "Build sometimes succeeds, sometimes fails"

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@CharlesWiltgen · MIT
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS
Runtime requirements
Node.js
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
  • Env read
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview axiom-fix-build.preview
# Interpreting Results

- Project/workspace file found in current directory
- 0-2 xcodebuild processes (all < 10 minutes old)
- Derived Data < 10GB
- No simulators stuck in Booting/Shutting Down
- No project/workspace file found (wrong directory!)
- 10+ xcodebuild processes OR any process > 30 minutes old (zombies)

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.