name: build-and-fix description: Build the project and automatically fix any build errors, compilation failures, or type mismatches. Use when the project fails to build, shows "broken" states, or after making significant changes.

Build and Fix Loop

Purpose

An autonomous loop for the agent to identify, analyze, and fix build errors using pnpm build.

Loop Logic

1. Identify: Run pnpm build to identify build failures.
2. Analyze: Examine the build output to determine:
   • The failing package and file.
   • The specific compiler or build error message.
   • Refer to ../common-references/troubleshooting.md for common TS errors.
3. Fix: Apply the minimum necessary change to resolve the error (e.g., fixing TypeScript types, correcting imports, or updating configurations).
4. Verify: Re-run pnpm build.
   • If passed: Finish.
   • If failed: Analyze the new failure and repeat the loop.

Termination Criteria

• The project builds successfully (as reported by pnpm build).
• Reached max iteration limit (default: 5).
• The error persists after multiple distinct fix attempts, indicating a need for human intervention.

Examples

Scenario: Fixing a TypeScript compilation error

1. pnpm build fails because of a type mismatch in packages/common/src/index.ts.
2. Agent analyzes the error and finds an incorrect interface implementation.

Resources

• pnpm Commands for Node.js: Common commands for building and managing dependencies.
• TypeScript Documentation: Official documentation for TypeScript.