yodakeisuke/ralph-wiggum-aot/convergence
Claude Code and agent skill by yodakeisuke/ralph-wiggum-aot
- community
Checking that the SKILL.md file is still in the repository.
This skill should be used when evaluating loop progress, detecting stalls, deciding whether to continue or stop iteration, or switching strategies when the DAG is not shrinking. Use it in the coordinator agent to determine next actions based on convergence metrics.
Install
npx vskill@latest install yodakeisuke/ralph-wiggum-aot/convergenceSKILL.md
The same SKILL.md was published earlier as yodakeisuke/ralph-wiggum-aot/convergence.
Convergence
Guarantee loop convergence, detect stalls, and switch strategies.
Core Principles
Halting (Base Case)
Express completion criteria as externally verifiable.
| Verification Method | Example | Machine Evaluable | |
|---|---|---|---|
| Test success | npm test exit code = 0 | Yes | |
| Artifact exists | ./dist/bundle.js exists | Yes | |
| Verification command | curl -s localhost:3000/health | Yes | |
| Agent judgment | "Auth API operates normally" | No (confirmation required) |
base_case satisfied → immediate stop
Convergence (Monotonic Decrease)
The essence of progress is that the "problem (unresolved Atoms)" gets smaller each iteration.
Progress Evaluation
Evaluation Logic
Decision Criteria and Actions
| Result | Criteria | Action | |||
|---|---|---|---|---|---|
| progress | ` | unresolved | < previous` | Continue (stall_count = 0) | |
| stall | ` | unresolved | = previous` | stall_count++, consider strategy switch | |
| expansion | ` | unresolved | > previous` | Over-decomposition → consider re-integration |
Stall Detection and Strategy Switching
stall_count Management
Stall handling:
- stall_count < max: Consider strategy switch
- stall_count >= max: Auto-stop (prevent infinite loop)
Strategy Switch Patterns
| Situation | Switch Strategy | |
|---|---|---|
| Same approach keeps failing | Try different approach | |
| Dependencies not progressing | Reconsider dependency graph | |
| Stuck at OR branch | Backtrack to alternative | |
| Over-decomposition | Re-integrate Atoms | |
| Insufficient information | Investigate with Probe Agent |
No Inertia Loops
Don't repeat the same approach out of inertia.
Stop Conditions
Priority Order
control.redirect_requested = true→ Redirect (interrupt, not stop)control.stop_requested = true→ Manual stopbase_casesatisfied → Completion stopstall_count >= max_stall_count→ Stall stopiteration >= max_iterations→ Limit stop
Recording Stop Reason
Hook Decision Logic
Continue/stop decision in SubagentStop hook:
Responsibility division:
- coordinator: Verify base_case, set status to completed
- hook: Decide continue/stop based on status/flags, manage iteration/stall_count
Convergence Metrics
Metrics to Track
| Metric | Meaning | |
|---|---|---|
iteration | Current iteration count | |
pending_count | Unresolved Atom count | |
resolved_count | Resolved Atom count | |
stall_count | Consecutive stall count | |
or_switches | OR branch switch count |
Health Check
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/convergence/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/yodakeisuke/ralph-wiggum-aot/convergence)