CtrlK
BlogDocsLog inGet started
Tessl Logo

autonomous-loop

Main orchestration loop for autonomous coding. Use when running autonomous sessions, orchestrating feature completion, managing continuous loops, or coordinating agent lifecycle.

57

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/autonomous-loop/SKILL.md

The canonical home for this skill is autonomous-loop in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Autonomous Loop

Main orchestration loop that runs continuously until all features are complete.

Quick Start

Start Autonomous Loop

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}")

With Configuration

from scripts.loop_config import LoopConfig

config = LoopConfig(
    max_sessions=10,
    token_budget=500000,
    auto_checkpoint=True
)
result = await loop.run(config)

Autonomous Loop Workflow

┌─────────────────────────────────────────────────────────────┐
│                   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                              │    │
│  └────────────────────────────────────────────────────┘    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Loop Result

@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]

Continuation Modes

ModeDescriptionTrigger
AutoLoop continues automaticallyContext limit
ManualUser confirms continuationSession end
ScheduledRuns at scheduled timesCron trigger
EventTriggered by eventsGit push, CI

Integration Points

  • autonomous-session-manager: Session lifecycle
  • coding-agent: Feature implementation
  • browser-e2e-tester: Feature verification
  • error-recoverer: Handle failures
  • checkpoint-manager: Safe rollback
  • handoff-coordinator: Session transitions
  • progress-tracker: Track and report

References

  • references/LOOP-LIFECYCLE.md - Loop details
  • references/CONTINUATION-PROTOCOL.md - Continuation

Scripts

  • scripts/autonomous_loop.py - Main loop
  • scripts/loop_config.py - Configuration
  • scripts/feature_orchestrator.py - Feature flow
  • scripts/continuation_handler.py - Continuations
Repository
fernandezbaptiste/Skrillz
Last updated
First committed

Canonical home

fernandezbaptiste/Skrillz
In sync

since Sep 12, 2026

Is this your skill?

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.