Skip to main content
Meta supervision is the mechanism that keeps SubTurtles moving without constant user prompts.
When the Meta Agent spawns a SubTurtle, it also schedules recurring cron check-ins that inspect progress and only notify on meaningful events. Core behavior is defined in:
Core implementation paths:

​
How Supervision Is Registered

ctl spawn is the high-level entrypoint. It creates workspace state, starts the worker, and auto-registers a recurring cron job with silent: true.
The cron job prompt is pre-seeded to perform supervision actions:
  • Run ctl status <name>
  • Read .superturtle/subturtles/<name>/CLAUDE.md
  • Review git log --oneline -10
  • Stay silent unless a notable event occurs
Current ctl default supervision interval is 10m (override with --cron-interval or ctl reschedule-cron).

​
Silent-First Supervision

Silent check-ins are designed to be invisible during normal progress.
1

Cron job wakes up

The bot checks due jobs every 10 seconds and executes the recurring SubTurtle job when fire_at is reached.
2

Meta Agent performs supervision work

It runs the status/state/log checks and decides whether there is meaningful news.
3

Marker-gated forwarding

For silent jobs, Telegram receives output only if the response includes a notable marker (🎉, ⚠️, ❌, 🚀, 🔔).
4

No news means no message

If no marker is present, nothing is sent to the user.
The marker filter is implemented in getSilentNotificationText(...):

​
Notification Triggers

Only these event classes should break silence:

🎉 Finished

All backlog items are complete. Stop the SubTurtle, summarize what shipped, and state what starts next.

📍 Milestone

Significant progress checkpoint reached (for example major backlog completion or first working slice).

⚠️ Stuck

No meaningful movement across multiple check-ins, repeated retries, or clear off-track behavior.

❌ Error

Crash or hard failure blocking autonomous progress.
Optional notable update:
  • 🔗 Preview when a new .tunnel-url appears for frontend work.

​
Notification Templates

Use concise, structured messages:

​
Progressing to the Next Task

When a SubTurtle finishes and the roadmap still has pending work:
1

Stop completed worker

This also removes that SubTurtle’s recurring cron supervision job.
2

Advance project state

Update root CLAUDE.md: mark completed items and move current focus to the next backlog item.
3

Seed next SubTurtle state

Write a fresh .superturtle/subturtles/&lt;name&gt;/CLAUDE.md for the next focused chunk.
4

Spawn next run

Start a new ctl spawn run; supervision is auto-registered again.
This is the autonomous conveyor belt model: spawn -> supervise silently -> notify on real news -> stop -> advance state -> respawn until roadmap completion.

​
Failure Handling

If a cron execution itself fails, the bot sends a direct failure message and does not retry that fire:
This prevents hidden supervision failures while still avoiding noisy retries.