Main orchestration loop for autonomous coding. Use when running autonomous sessions, orchestrating feature completion, managing continuous loops, or coordinating agent lifecycle.
57
66%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/autonomous-loop/SKILL.mdMain orchestration loop that runs continuously until all features are complete.
from scripts.autonomous_loop import AutonomousLoop
loop = AutonomousLoop(project_dir)
result = await loop.run()
print(f"Completed: {result.features_completed}")
print(f"Sessions: {result.sessions_used}")from scripts.loop_config import LoopConfig
config = LoopConfig(
max_sessions=10,
token_budget=500000,
auto_checkpoint=True
)
result = await loop.run(config)┌─────────────────────────────────────────────────────────────┐
│ AUTONOMOUS LOOP │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ INITIALIZE │ │
│ │ ├─ Detect session type (INIT vs CONTINUE) │ │
│ │ ├─ Load or create feature list │ │
│ │ └─ Initialize state tracker │ │
│ └────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ FEATURE LOOP │ │
│ │ while (incomplete_features > 0): │ │
│ │ ├─ Select next feature │ │
│ │ ├─ Create checkpoint │ │
│ │ ├─ Implement with TDD │ │
│ │ ├─ Run E2E tests │ │
│ │ ├─ If pass: mark complete │ │
│ │ ├─ If fail: recover or rollback │ │
│ │ └─ Check context limits │ │
│ └────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ CONTEXT CHECK │ │
│ │ if (approaching_limit): │ │
│ │ ├─ Compact context │ │
│ │ ├─ Prepare handoff │ │
│ │ └─ Request continuation │ │
│ └────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ COMPLETION │ │
│ │ ├─ Generate final report │ │
│ │ ├─ Store session memory │ │
│ │ └─ Signal completion │ │
│ └────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘@dataclass
class LoopResult:
success: bool
features_completed: int
features_total: int
sessions_used: int
total_tokens: int
errors_recovered: int
duration_minutes: float
handoff_reason: Optional[str]| Mode | Description | Trigger |
|---|---|---|
| Auto | Loop continues automatically | Context limit |
| Manual | User confirms continuation | Session end |
| Scheduled | Runs at scheduled times | Cron trigger |
| Event | Triggered by events | Git push, CI |
references/LOOP-LIFECYCLE.md - Loop detailsreferences/CONTINUATION-PROTOCOL.md - Continuationscripts/autonomous_loop.py - Main loopscripts/loop_config.py - Configurationscripts/feature_orchestrator.py - Feature flowscripts/continuation_handler.py - Continuations93ed392
Also appears in
since Sep 12, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.