Problem
When a module breaks compilation, the skill currently asks the agent to "diagnose and fix before proceeding". This is a single attempt with no structure — if the fix doesn't work, the migration can get stuck or produce bad results.
Proposal
Add a structured compile-fix loop to the Execution Protocol:
COMPILE: run the compile command
If fails:
a. Analyze the error output
b. Apply a targeted fix (one file at a time)
c. Re-compile
d. Repeat up to 3 times
e. If still failing after 3 retries → mark as MANUAL_REVIEW_REQUIRED,
log the error, and ask the user whether to continue or stop
This could be implemented as a dedicated section in SKILL.md or as a separate module (modules/compile-fix.md) that gets loaded when needed.
Reference
Problem
When a module breaks compilation, the skill currently asks the agent to "diagnose and fix before proceeding". This is a single attempt with no structure — if the fix doesn't work, the migration can get stuck or produce bad results.
Proposal
Add a structured compile-fix loop to the Execution Protocol:
COMPILE: run the compile command
If fails:
a. Analyze the error output
b. Apply a targeted fix (one file at a time)
c. Re-compile
d. Repeat up to 3 times
e. If still failing after 3 retries → mark as MANUAL_REVIEW_REQUIRED,
log the error, and ask the user whether to continue or stop
This could be implemented as a dedicated section in SKILL.md or as a separate module (
modules/compile-fix.md) that gets loaded when needed.Reference
agents/10-compile-fix.prompt.md(dedicated compile-fix agent with retry logic)