self-fix-loop

name	self-fix-loop
description	Automated CI fix cycle: detect failure, classify error, apply fix, retry. Use after push triggers CI failure for automated repair iteration.

Self-Fix Loop

Automated CI failure remediation with iterative repair attempts.

When to Use

• After a push that triggers CI failure
• When error type is known and fixable programmatically
• For repeatable, deterministic error patterns

Do NOT Use

• When error requires architectural decisions
• When fix needs user input or clarification
• When max iterations reached without resolution

Process

┌─────────────────────────────────────────────────┐
│  1. DETECT: Fetch CI logs, identify failure      │
│  2. CLASSIFY: Categorize error type             │
│  3. FIX: Apply appropriate remediation         │
│  4. RETRY: Push fix, re-run CI                  │
│  5. REPEAT until PASS or MAX_ITERATIONS (5)     │
└─────────────────────────────────────────────────┘

Error Classification & Remediation

Error Type	Detection Pattern	Fix Strategy
shellcheck	shellcheck: SC\d+	Apply suggested fix, quote variables
YAML	yaml: line \d+:	Fix indentation, syntax
lint/clippy	error\[E\d+\] or clippy::	Address specific lint warning
security	security:, vulnerability	Update dependency, patch CVE
test	test failed, assertion	Debug failing test, fix logic
build	cannot find, unresolved	Fix imports, add dependencies

Loop Parameters

Parameter	Default	Description
MAX_ITERATIONS	5	Maximum fix attempts before escalation
COOLDOWN	30s	Wait between CI check polls
TIMEOUT	10m	Max time per iteration

Step-by-Step Execution

1. Detect Failure

gh run list --limit 1 --json conclusion,status,databaseId
gh run view <run-id> --log-failed

2. Classify Error

Parse logs for known patterns. Map to fix strategy.

3. Apply Fix

Execute appropriate remediation based on classification:

• shellcheck: shellcheck -f diff script.sh | git apply
• clippy: Address specific warnings with code changes
• test: Analyze failure, modify test or code

4. Retry

git add -A
git commit -m "fix: automated remediation for <error-type>"
git push

5. Monitor

gh run watch --exit-status

Escalation Criteria

Stop the loop and escalate when:

• Iteration count exceeds MAX_ITERATIONS
• Error type is unclassifiable
• Fix requires architectural change
• Multiple unrelated failures detected

Example Usage

User: "The CI is failing, fix it automatically"

Agent: [Self-Fix Loop activated]
1. Detected: clippy error `unused_variable`
2. Classified: lint warning
3. Fixed: Prefixed with `_` to suppress
4. Retried: Push, CI passes
5. Result: PASS after 1 iteration

Safety Constraints

• Never force-push to main/master
• Never skip CI with --no-verify
• Always create new commits (never amend existing)
• Preserve commit message style from repository