name: build-fix
description: Fix build and TypeScript errors with minimal changes

Build Fix Skill

Fix build and TypeScript errors quickly with minimal code changes. Get the build green without refactoring.

When to Use

This skill activates when:
- User says "fix the build", "build is broken"
- TypeScript compilation fails
- npm run build or tsc reports errors
- User requests "minimal fixes" for errors

What It Does

Delegates to the build-fixer agent (Sonnet model) to:

1. Collect Errors
2. Run npx tsc --noEmit to get all TypeScript errors
3. Or run npm run build to get build failures

4. Categorize errors by type and severity

5. Fix Strategically

6. Add type annotations where missing
7. Add null checks where needed
8. Fix import/export statements
9. Resolve module resolution issues

10. Fix linter errors blocking build

11. Minimal Diff Strategy

12. NO refactoring of unrelated code
13. NO architectural changes
14. NO performance optimizations

15. ONLY what's needed to make build pass

16. Verify

17. Run npx tsc --noEmit after each fix
18. Ensure no new errors introduced
19. Stop when build passes

Agent Delegation

Task(
  subagent_type="oh-my-claudecode:build-fixer",
  model="sonnet",
  prompt="BUILD FIX TASK

Fix all build and TypeScript errors with minimal changes.

Requirements:
- Run tsc/build to collect errors
- Fix errors one at a time
- Verify each fix doesn't introduce new errors
- NO refactoring, NO architectural changes
- Stop when build passes

Output: Build error resolution report with:
- List of errors fixed
- Lines changed per fix
- Final build status"
)

Stop Conditions

The build-fixer agent stops when:
- npx tsc --noEmit exits with code 0
- npm run build completes successfully
- No new errors introduced

Output Format

BUILD FIX REPORT
================

Errors Fixed: 12
Files Modified: 8
Lines Changed: 47

Fixes Applied:
1. src/utils/validation.ts:15 - Added return type annotation
2. src/components/Header.tsx:42 - Added null check for props.user
3. src/api/client.ts:89 - Fixed import path for axios
...

Final Build Status: ✓ PASSING
Verification: npx tsc --noEmit (exit code 0)

Best Practices

• One fix at a time - Easier to verify and debug
• Minimal changes - Don't refactor while fixing
• Document why - Comment non-obvious fixes
• Test after - Ensure tests still pass

Use with Other Skills

Combine with other skills for comprehensive fixing:

With Ultrawork:

/ultrawork fix all build errors

Spawns multiple build-fixer agents in parallel for different files.

With Ralph:

/ralph fix the build

Keeps trying until build passes, even if it takes multiple iterations.

With Pipeline:

/pipeline debug "build is failing"

Uses: explore → architect → build-fixer workflow.