Retry Mechanism – The Resilience Layer

ConstruQtor Per-Briq Retry

The ConstruQtor agent features a configurable retry mechanism for individual briq failures. This adds a layer of resilience to the system, allowing it to recover from transient errors without halting the entire cycle.

How it works

When a briq fails (e.g., due to a syntax error in the generated code or an API error), the ConstruQtor will automatically retry the briq up to a configurable number of times. The error context from the failed attempt is appended to the prompt for the next attempt, giving the AI a chance to correct its own mistakes.

Configuration

The retry mechanism is configured in config.yaml:

# config.yaml
agents:
  construqtor:
    max_attempts: 3           # Retry failed briqs up to 3 times
    stop_on_briq_fail: true   # Stop cycle if briq fails after all retries

• max_attempts: The total number of attempts for each briq.
• stop_on_briq_fail: If set to true, the entire cycle will stop if a briq fails after all retry attempts. If false, the system will log the failure and continue to the next briq.

Output Example

The status output will show the attempt count for each briq:

construqtor ⸎ -- Processing Briq: briq005_implement_dga.md --
construqtor ⸎    Attempt 1/3...
construqtor ⸎    [FAIL] Syntax error in output
construqtor ⸎    Attempt 2/3 (with error context)...
construqtor ⸎    [✅ SUCCESS] (attempts: 2)