Self-Correction

Overview

When validation detects issues in generated code, Synapse’s self-correction system automatically attempts to fix them without manual intervention.

The Self-Correction Loop

Initial Generation

GPT-5 Mini generates code based on your prompt

Validation

MCP validator checks the code and returns a score with specific issues

Correction Decision

If score is below 90, self-correction is triggered

Fix Generation

AI analyzes the issues and generates corrected code

Re-validation

Corrected code is validated again

Success or Retry

Process repeats up to 3 times until score ≥ 90 or attempts exhausted

Success Rates

Attempt	Success Rate	Avg Score
Initial	13%	87/100
Attempt 1	87%	93/100
Attempt 2	97%	96/100
Attempt 3	99%	98/100

Common Corrections

Import Path Fixes

Before
After

// ❌ Wrong import path
import { Banner, useCart } from '@shopify/ui-extensions-react';

// ✅ Corrected import path
import { Banner, useCart } from '@shopify/ui-extensions-react/checkout';

GraphQL Query Corrections

Before
After

# ❌ Wrong field name
query {
  cart {
    totalPrice
  }
}

# ✅ Correct field structure
query {
  cart {
    cost {
      totalAmount {
        amount
        currencyCode
      }
    }
  }
}

Hook Usage Fixes

Before
After

// ❌ Conditional hook call
function Component() {
  if (condition) {
    const cart = useCart();
  }
}

// ✅ Hook at top level
function Component() {
  const cart = useCart();
  
  if (!condition) return null;
  // use cart
}

How It Works

1. Issue Analysis

When validation fails, Synapse extracts specific issues:

{
  "issues": [
    {
      "type": "import_error",
      "message": "Module '@shopify/ui-extensions-react' has no exported member 'Banner'",
      "line": 1,
      "severity": "error"
    },
    {
      "type": "graphql_error", 
      "message": "Cannot query field 'totalPrice' on type 'Cart'",
      "line": 15,
      "severity": "error"
    }
  ]
}

2. Correction Prompt

Synapse creates a targeted correction prompt:

const correctionPrompt = `
The following Shopify extension code has validation errors:

ISSUES:
1. Import Error (Line 1): Module '@shopify/ui-extensions-react' has no exported member 'Banner'
   Fix: Add /checkout to the import path for checkout extensions

2. GraphQL Error (Line 15): Cannot query field 'totalPrice' on type 'Cart'
   Fix: Use cart.cost.totalAmount.amount instead

ORIGINAL CODE:
${originalCode}

INSTRUCTIONS:
- Fix ONLY the issues listed above
- Preserve all existing functionality
- Keep the same component structure
- Do not add new features
- Return the complete corrected code
`;

3. Intelligent Fixing

The AI understands context and makes precise fixes:

Pattern Recognition

Recognizes common Shopify patterns and applies standard fixes

Import paths: Adds /checkout, /admin, /pos as appropriate
GraphQL: Uses Shopify’s schema to find correct field paths
Hooks: Moves to top level and restructures conditionals
Props: Matches TypeScript definitions

Context Preservation

Maintains the original intent and structure

Keeps variable names
Preserves logic flow
Maintains comments
Retains error handling

Multi-Issue Handling

Fixes multiple issues simultaneously

Prioritizes critical errors
Groups related fixes
Avoids creating new issues
Validates dependencies between fixes

Example Self-Correction Session

Original Generation

import { Banner, useCart } from '@shopify/ui-extensions-react';

export default function FreeShippingBanner() {
  const cart = useCart();
  
  if (cart.totalPrice > 50) {
    return null;
  }
  
  return (
    <Banner status="info">
      Add ${50 - cart.totalPrice} more for free shipping!
    </Banner>
  );
}

Validation Score: 62/100 Issues Found:

Import path missing /checkout
cart.totalPrice doesn’t exist
status prop should be tone

After Attempt 1

import { Banner, useCart } from '@shopify/ui-extensions-react/checkout';

export default function FreeShippingBanner() {
  const cart = useCart();
  
  const total = parseFloat(cart.cost.totalAmount.amount);
  
  if (total > 50) {
    return null;
  }
  
  const remaining = 50 - total;
  
  return (
    <Banner tone="info">
      Add ${remaining.toFixed(2)} more for free shipping!
    </Banner>
  );
}

Validation Score: 95/100 Result: ✅ Success! Code ready to deploy.

When Self-Correction Fails

If self-correction doesn’t reach a score of 90 after 3 attempts:

User Notification: You’re informed of the persistent issues
Partial Deployment: Code can still be deployed if score ≥ 75
Manual Review: Recommended for scores < 75
Support Escalation: Complex issues are flagged for team review

Manual Intervention

You can always view and edit the generated code:

// Click "View Code" in the dashboard
// Edit directly in the code editor
// Re-run validation manually
// Deploy when satisfied

Configuration

You can adjust self-correction behavior:

{
  "selfCorrection": {
    "enabled": true,
    "maxAttempts": 3,
    "minScore": 90,
    "autoDeployThreshold": 95
  }
}

Best Practices

Write Clear Prompts

Specific prompts lead to better initial code and fewer corrections

Review Corrections

Check what was changed to learn and improve future prompts

Report Patterns

If the same issue repeats, let us know to improve the system

Use Validation

Always validate before deploying, even with high scores

Limitations

Self-correction cannot fix:

Fundamental logic errors (wrong business rules)
Missing required features
Performance issues
Security vulnerabilities beyond basic validation

These require prompt revision or manual coding.

Next Steps

Validation Details

Learn what triggers self-correction

Debugging Guide

Fix issues manually when needed

Best Practices

Write prompts that generate better code

Troubleshooting

Common issues and solutions

Get Started

Core Concepts

Building Extensions

Building Functions

Development

Deployment

Advanced

Self-Correction

Overview

The Self-Correction Loop

Success Rates

Common Corrections

Import Path Fixes

GraphQL Query Corrections

Hook Usage Fixes

How It Works

1. Issue Analysis

2. Correction Prompt

3. Intelligent Fixing

Example Self-Correction Session

Original Generation

After Attempt 1

When Self-Correction Fails

Manual Intervention

Configuration

Best Practices

Write Clear Prompts

Review Corrections

Report Patterns

Use Validation

Limitations

Next Steps

Validation Details

Debugging Guide

Best Practices

Troubleshooting

​Overview

​The Self-Correction Loop

​Success Rates

​Common Corrections

​Import Path Fixes

​GraphQL Query Corrections

​Hook Usage Fixes

​How It Works

​1. Issue Analysis

​2. Correction Prompt

​3. Intelligent Fixing

​Example Self-Correction Session

​Original Generation

​After Attempt 1

​When Self-Correction Fails

​Manual Intervention

​Configuration

​Best Practices

Write Clear Prompts

Review Corrections

Report Patterns

Use Validation

​Limitations

​Next Steps

Validation Details

Debugging Guide

Best Practices

Troubleshooting

Overview

The Self-Correction Loop

Success Rates

Common Corrections

Import Path Fixes

GraphQL Query Corrections

Hook Usage Fixes

How It Works

1. Issue Analysis

2. Correction Prompt

3. Intelligent Fixing

Example Self-Correction Session

Original Generation

After Attempt 1

When Self-Correction Fails

Manual Intervention

Configuration

Best Practices

Limitations

Next Steps