Build Resolver

3. Track Progress

Fixed: X/Y errors | Build status: PASSING/FAILING

Common Error Patterns & Fixes

Type Inference Failure

// ERROR: Parameter 'x' implicitly has 'any' type
// FIX: Add type annotation
function add(x: number, y: number): number { ... }

Null/Undefined Errors

// ERROR: Object is possibly 'undefined'
// FIX: Optional chaining or null check
const name = user?.name?.toUpperCase() ?? ''

Missing Properties

// ERROR: Property 'age' does not exist on type
// FIX: Add property to interface (optional if not always present)
interface User { name: string; age?: number }

Import Errors

// ERROR: Cannot find module
// FIX 1: Check tsconfig/build paths
// FIX 2: Use relative import
// FIX 3: Install missing package

Type Mismatch

// ERROR: Type 'string' not assignable to type 'number'
// FIX: Parse/convert or fix the type declaration

Generic Constraints

// ERROR: Type 'T' not assignable to type 'string'
// FIX: Add constraint: <T extends { length: number }>

Async/Await Errors

// ERROR: 'await' only allowed in async functions
// FIX: Add async keyword to function

Module Not Found

// ERROR: Cannot find module or type declarations
// FIX: Install package + @types/ package

Minimal Diff Strategy (CRITICAL)

DO:

• Add type annotations where missing
• Add null checks where needed
• Fix imports/exports
• Add missing dependencies
• Update type definitions
• Fix configuration files

DON'T:

• Refactor unrelated code
• Change architecture
• Rename variables/functions (unless causing error)
• Add new features
• Change logic flow (unless fixing error)
• Optimize performance
• Improve code style

Goal: 1-line fix per error when possible. Total changes < 5% of affected file.

Build Error Report Format

# Build Error Resolution

**Build Target:** [TypeScript / Build tool / Framework]
**Initial Errors:** X → **Fixed:** Y → **Status:** PASSING/FAILING

## Fixes Applied
1. `file:line` - [Error type] → [Fix description] (N lines changed)
2. ...

## Verification
- [ ] Type check passes
- [ ] Build succeeds
- [ ] No new errors introduced
- [ ] Tests still passing

When to Use vs When NOT to Use

USE when:

• Build command fails
• Type checker shows errors
• Import/module resolution errors
• Configuration errors
• Dependency version conflicts

DON'T USE when:

• Code needs refactoring → use /clean-architecture Refactor Mode
• Architectural changes needed → use /clean-architecture Architect Mode
• New features required → use /clean-architecture Planner Mode
• Tests failing (not build) → use /tdd-guide
• Security issues → use /security-review

Quick Reference Commands

# TypeScript check
npx tsc --noEmit --pretty

# Clear cache and rebuild
rm -rf .next node_modules/.cache && npm run build

# Install missing deps
npm install

# Fix auto-fixable lint issues
npx eslint . --fix

# Verify node_modules integrity
rm -rf node_modules package-lock.json && npm install