build-fix

Build Fix Mode

Recommended model tier: balanced (sonnet) - this skill performs straightforward operations

Rapidly fix all build, type, and lint errors with minimal changes.

Prerequisites

Before starting, ensure you have:

• Access to the project root directory
• Build tools installed (npm, tsc, etc.)

Workflow

Step 1: Capture All Errors

Run all checks and capture output:

# Run in sequence, capture all output
npm run build 2>&1 | head -100
npm run lint 2>&1 | head -100
npx tsc --noEmit 2>&1 | head -100

If commands fail to run:

• Check package.json for available scripts
• Try npm install if dependencies are missing
• Use npm ci for clean install if lock file exists

Step 2: Categorize Errors by Priority

Process errors in this order:

1. Type errors (highest priority) - Fix TypeScript/type issues first
2. Build errors - Compilation failures
3. Lint errors - ESLint, Prettier, etc.
4. Warnings - Address only if trivial

Group similar errors:

• Missing imports
• Type mismatches
• Unused variables
• Formatting issues

Step 3: Search for Context

Use MCP tools to find definitions and patterns:

# Find type definitions
mcp__plugin_aide_aide__code_search query="InterfaceName" kind="interface"

# Find function signatures
mcp__plugin_aide_aide__code_search query="functionName" kind="function"

# Get symbols in a file
mcp__plugin_aide_aide__code_symbols file="path/to/file.ts"

# Check project conventions
mcp__plugin_aide_aide__decision_get topic="coding-style"

Step 4: Apply Fixes Systematically

Fix in batches by category:

1. All missing imports together - Add import statements
2. All type annotations together - Add/fix type declarations
3. All unused variables together - Remove or prefix with _

Step 5: Verify After Each Batch

# Run full verification
npm run build && npm run lint && npx tsc --noEmit

Verification criteria:

• Exit code 0 for all commands
• No error output
• Warnings are acceptable if not introduced by changes