simplicio-loop

Runs an evidence-gated autonomous iteration loop that re-feeds a goal until verified completion.

9|Updated May 8, 2026
One-click install
npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill simplicio-loop-simpletibr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simplicio-loop
Source: https://github.com/simpletibr/simplicio-loop-marketing/tree/main/.claude/skills/simplicio-loop
Command: npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill simplicio-loop-simpletibr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires simplicio-mapper, simplicio-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve? Autonomous coding agents often stop too early, claim false completion, or oscillate on the same failing approach. This Skill enforces a self-referential loop that re-feeds the same goal after every turn and exits only when a typed completion promise is backed by concrete in-turn evidence, a watcher-gate re-verification, or a hard iteration cap. ## Core Features & Use Cases - Evidence-gated completion: The loop refuses to exit on a self-reported "done"; every exit requires a passing gate, a file:line receipt, or an independently recomputed watcher state in the same turn. - Bound CLI operators: Surveying is delegated to simplicio-mapper and code mutation to simplicio-dev-cli, so the model decides while deterministic tools execute and verify. - Stall detection and memory: An append-only run journal fingerprints failures, detects repeated dead-ends, and forces strategy changes or escalation instead of blind retries. - Use Case: Tell the agent "/simplicio-loop finish all the open issues" and it drains the queue item by item, claiming work, applying verified changes, and stopping only when the source re-query confirms the queue is empty. ## Quick Start Ask the agent to run /simplicio-loop on your goal, for example "keep iterating until all tests pass", and it will arm the loop and start iteration 1 immediately.

Frequently Asked Questions about simplicio-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an autonomous loop until a coding task is done?

Invoke /simplicio-loop with your goal, such as "iterate until the tests pass". The skill writes a scratchpad with the goal, an exact completion promise, and a max_iterations cap, then re-feeds the goal each turn until the promise is verified with in-turn evidence.

What is a Ralph loop in AI coding agents?

A Ralph loop is a self-referential iteration pattern where the same goal is fed back after every turn so the agent sees its own prior edits and converges. This skill hardens it with an evidence-gated promise, a max-iteration cap, and a watcher that independently re-verifies results.

Does simplicio-loop work without Claude Code hooks?

Yes, the self-paced drive is a first-class path. When the host has no hook layer, a durable scheduler, OS cron, or session re-invocation ticks the loop each iteration while honoring the same promise, evidence, and cap contract.

Why does the loop stop with a BLOCKED operator message?

The loop requires two installed CLIs: simplicio-mapper for repo survey and simplicio-dev-cli for applying changes. If either is missing from PATH it stops instead of falling back to LLM hand-editing; run pip install simplicio-loop to pull both.

How does the loop avoid retrying the same failing approach?

Every attempt is recorded in an append-only journal with a normalized failure fingerprint. The stall detector returns STALLED when the last K attempts share a fingerprint, forcing a strategy switch or escalation instead of re-feeding the same dead-end.

When should I not use an autonomous iteration loop?

Do not use it for one-shot edits, which belong in the host's normal flow. It is designed for converge-until-done tasks or draining work queues where bounded, evidence-verified repetition is the goal.