manage-hero-run

Launch, monitor, resume, and seal production-critical Marin training runs above 1e22 FLOPs.

3.2k|266|Updated Mar 22, 2024
One-click install
npx skills add https://github.com/marin-community/marin --skill manage-hero-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-hero-run
Source: https://github.com/marin-community/marin/tree/main/.agents/skills/manage-hero-run
Command: npx skills add https://github.com/marin-community/marin --skill manage-hero-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing large-scale foundation model training runs involves many failure modes: wrong checkpoints, code lineage drift, silent monitor failures, and lost artifacts. This Skill provides a disciplined operational workflow for launching, babysitting, recovering, and sealing production-critical Marin training runs so nothing falls through the cracks.

Core Features & Use Cases

  • Validated Launch: Resolves launch blockers including source commit ancestry, pinned output roots, checkpoint retention policy, W&B tracker identity, and DRI assignment before submitting a run.
  • Babysitting & Monitoring: Checks job health, W&B progress, checkpoint completion, and loss sanity on a regular cadence, escalating to the DRI when judgment calls are needed.
  • Resume & Recovery: Handles relaunches with correct checkpoint lineage, distinguishing recoverable infrastructure failures from code bugs that require a new run identity.
  • Seal & Handoff: Verifies final checkpoints, metrics, and cleanup, then records the seal in a GitHub issue and append-only logbook.
  • Use Case: You need to launch a 500B-parameter mixture-of-experts pretraining run on TPU. This Skill walks you through pre-launch validation, sets up 15-minute monitoring, manages relaunches after preemption, and seals the run with verified final artifacts.

Quick Start

Ask the assistant to launch and babysit the hero training run from the reference launcher, then monitor it until completion and seal it.

Frequently Asked Questions about manage-hero-run

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

FAQPage Schema
How do I launch a large Marin training run safely?

Start from the reference launcher, confirm the source commit ancestry, pin a unique output root under a user-owned path, validate checkpoint retention and W&B tracker settings, and print the exact submit command before launching. Assign a DRI and arrange babysitting unless explicitly declined.

How do I resume a preempted or crashed training run?

Relaunch directly with the same run id, W&B identity, and output root for recoverable failures like preemption or hardware issues. Select the newest complete checkpoint with metadata.json, sorted by parsed numeric step, and never use incomplete checkpoints.

When should a relaunch use a new W&B run id?

Use a new run id and W&B identity when the old lineage is unsafe or semantically different, such as W&B corruption or nontrivial code changes to the model, training loop, optimizer, or data pipeline. Document old and new identities in the issue and logbook.

What is the difference between a production run and a bounded diagnostic?

A production run is long-lived, has a durable output contract, or exceeds roughly 1e22 FLOPs, requiring a full run record with issue and logbook. A bounded diagnostic has fixed step limits and lifecycle-managed output, recorded only in the originating conversation.

Why does training loss differ after resuming from a checkpoint?

Levanter resumes are generally bitwise identical on TPU, but GPU runs can differ slightly. Alert if loss differs by more than 0.002 during catch-up or more than 1% after post-resume warmup, as larger gaps indicate lineage or config problems.

What checkpoint retention policy should hero runs use?

Keep one rolling temporary resume checkpoint by default and never more than five, with rollback depth above two requiring recorded rationale. Store resume checkpoints in a lifecycle-managed temp prefix and canonical exports under a durable user-owned path.