Default Jobs
Instar ships with fourteen default jobs that run automatically on schedule. Each gives your agent a different rhythm: short-period health and commitment checks, mid-range reflection and evolution, daily identity reviews, and continuous oversight across development, learning, infrastructure, maintenance, and guardian responsibilities.
Job schedule
Section titled “Job schedule”| Job | Cron | Model | Purpose |
|---|---|---|---|
health-check | */5 * * * * (every 5 min) | Haiku | Verify infrastructure health |
commitment-detection | */5 * * * * (every 5 min) | Haiku | Detect new commitments in the recent conversation flow |
reflection-trigger | 0 */4 * * * (every 4h) | Opus | Reflect on recent work and surface insights |
evolution-overdue-check | 0 */4 * * * (every 4h) | Haiku | Surface overdue commitments and stalled action items |
evolution-proposal-evaluate | 0 */6 * * * (every 6h) | Sonnet | Evaluate evolution proposals against current goals |
evolution-proposal-implement | 0 1,7,13,19 * * * (4× daily) | Opus | Implement evolution proposals that passed evaluation |
overseer-guardian | 0 */6 * * * (every 6h) | Sonnet | Guardian oversight — safety, alignment, value drift |
insight-harvest | 0 */8 * * * (every 8h) | Opus | Synthesize learnings into evolution proposals |
overseer-infrastructure | 0 6 * * * (daily 6am) | Haiku | Infrastructure oversight — quotas, health, scheduled work |
overseer-development | 0 8 * * * (daily 8am) | Haiku | Development oversight — open work, blockers, follow-through |
relationship-maintenance | 0 9 * * * (daily 9am) | Haiku | Review stale relationships, refresh significance scoring |
overseer-maintenance | 0 2 * * * (daily 2am) | Sonnet | Maintenance oversight — log rotation, cleanup, hygiene |
identity-review | 0 3 * * * (daily 3am) | Opus | Identity review — AGENT.md drift, value alignment |
overseer-learning | 0 3 */2 * * (every other day 3am) | Sonnet | Learning oversight — knowledge consolidation, gap detection |
docs-coverage-audit | 0 10 * * 1 (Mondays 10am) | Haiku | Weekly walk of the instar source tree against the docs surface, surfaces newly-undocumented capabilities. Ships enabled: false by default; only useful on machines with the instar source repo locally |
org-intent-drift-audit | (configurable) | Sonnet | Periodic drift detection for organizational intent — compares recent decisions and outputs against the constraints and goals declared in ORG-INTENT.md, surfaces drift via the degradation channel |
mentor-onboarding | */15 * * * * (every 15m) | Haiku | Framework-Onboarding Mentor heartbeat — a thin timer that pokes POST /mentor/tick; the in-process tick runs a leak-detector canary, a fail-closed budget gate, a safe-window check, a constrained Stage-A spawn, the leakage detector, Stage-B forensics, and ledger capture. Ships enabled: false and mentor.mode: 'off'; dormant until promoted off → dry-run → live |
failure-analyzer | 0 9 * * 3 (Wednesdays 9am) | Haiku | Failure-Learning Loop analyzer — weekly scan of the failure ledger for dev-process patterns. Surfaces support-and-diversity-thresholded insights, opens human-approved tracked improvements (never auto-implements), and runs the verify step on past fixes. Tier-1 supervised (wraps the deterministic /failures/analyze endpoint, validating each insight against its evidence). Ships enabled: false; turns on with monitoring.failureLearning.enabled |
initiative-digest-review | 0 11 * * 1,4 (Mon & Thu 11am) | Sonnet | The self-driving half of the InitiativeTracker — twice-weekly review of the initiative board. Surfaces initiatives that need a decision and, for ships-staged features in rollout (dry-run → live → default-on), gathers promotion evidence and posts an explicit, evidence-gated recommendation. Near-silent (posts only when a genuinely-new decision is waiting); operator-gated — it recommends, it never flips a config flag |
All jobs ship inside src/scaffold/templates/jobs/instar/ and are installed on instar init plus refreshed on every update via PostUpdateMigrator.
Supervision tiers
Section titled “Supervision tiers”Jobs declare a supervision field that controls how each step is validated:
tier0— Raw programmatic. No LLM validation. Fast, cheap, silent failures.tier1— LLM-supervised. A lightweight model (typically Haiku) validates each step. Observed failures.tier2— Full intelligent. A capable model (Sonnet or Opus) handles reasoning end-to-end. Handled failures.
The supervision tier is independent of the execution model — tier1 may use Haiku while the job runs on Sonnet, for instance. See docs/LLM-SUPERVISED-EXECUTION.md for the full design.
Quota-aware backpressure
Section titled “Quota-aware backpressure”The scheduler reads from a shared QuotaTracker and shedds load as quota tightens. Threshold buckets in scheduler.quotaThresholds:
- normal — full scheduling
- elevated — defer Opus-tier jobs
- critical — defer Sonnet-tier jobs as well
- shutdown — pause everything except
health-check
Tier-aware shedding lets you keep critical safety jobs alive even when you’re hammering against your daily cap.
Wake-time reaper
Section titled “Wake-time reaper”When the host wakes from sleep, the scheduler reaps any pending runs older than wakeReaper.thresholdMultiplier × expectedDurationMinutes. This prevents a stampede of overdue jobs from firing all at once after a long suspend.
Gate retries
Section titled “Gate retries”Job gates (preconditions evaluated before the job body runs) can fail transiently. The scheduler retries gates up to gateRetries times (default 3) with gateRetryDelayMs between attempts (default 5 s). Persistent gate failures surface as a degradation rather than a stuck job.
Customization
Section titled “Customization”Edit .instar/jobs.json (or the per-job .md files under .instar/jobs/instar/ if your agent uses the newer agentmd execution type) to:
- Change schedules
- Adjust models
- Add new jobs
- Disable jobs you don’t need
The agent can also modify its own jobs through the evolution system.
The agentmd execution type
Section titled “The agentmd execution type”A newer execution type, agentmd, lets the job body live in the markdown frontmatter of .instar/jobs/<origin>/<slug>.md rather than inline in jobs.json. The fourteen built-in jobs ship as agentmd files under src/scaffold/templates/jobs/instar/, which is why you’ll find them as markdown files rather than JSON entries.
Superseded jobs
Section titled “Superseded jobs”These older jobs still exist in some agent installations for backward compatibility but are disabled by default:
| Job | Replaced by |
|---|---|
update-check | AutoUpdater (built-in server component — no session needed) |
dispatch-check | AutoDispatcher (built-in server component — no session needed) |
Both replacements are server-side components that don’t spawn Claude sessions, saving quota.