| name | tcl-fix |
| description | Fix issues in a Tcl file using LSP diagnostics. Runs an iterative analyse-fix-reanalyse loop until clean or stable. Use when fixing Tcl errors, resolving .tcl file warnings, auto-fixing Tcl lint issues, or cleaning up Tcl diagnostics. |
| allowed-tools | Bash, Read, Edit |
Tcl Fix
Fix diagnostics in a Tcl file iteratively using LSP analysis.
Steps
- Read the domain knowledge from
ai/prompts/tcl_system.md
- Read the Tcl file to fix
- Run diagnostics to find current issues:
uv run --no-dev python ai/claude/tcl_ai.py diagnostics $FILE
- If the tool fails (e.g. file not found), report the error clearly and suggest fixes
- If no errors or warnings, report the file is clean
- Otherwise, fix the issues using the Edit tool:
- Follow the safety and best practices from the domain knowledge
- Preserve the script's behaviour -- only fix what the diagnostics flag
- After editing, re-run diagnostics to verify:
uv run --no-dev python ai/claude/tcl_ai.py diagnostics $FILE
- If issues remain, fix them and re-run (up to 5 iterations)
- If issues persist after 5 iterations, report what was fixed and what remains unresolved
- Report the final state
Diagnostic codes reference
See docs/generated/diagnostic_codes.md for the full auto-generated table of all diagnostic codes.
Important
- Only fix issues flagged by the analyser -- do not refactor unrelated code
- Preserve the original behaviour and intent
$ARGUMENTS
