marin-community/marin

scrub-experiment-issue-tldrs

Scheduled scrub: TL;DR blocks on experiment issues.

Quellsprache: Englisch

manage-hero-run

Launch, monitor, hand off, resume, rollback, or babysit expensive Marin production. Typically >=1e22 model flops.

Quellsprache: Englisch

commit

Lint, run the pre-PR checks, commit, push, and author or update the branch's pull request in the required plain-text format. Use when committing, pushing, or creating/updating a PR.

Quellsprache: Englisch

refresh-fork

Rebase one Marin fork onto newer upstream per its config/external/migration.toml descriptor, run the fork's e2e, and open the Marin PR or file a blocker issue.

Quellsprache: Englisch

noslop

Clean a branch with strict gates for low-value tests and agentic prose. Use when asked to deslop, simplify, clean up, make a diff minimal, review test quality, tighten comments/docs/PR text, or remove AI-writing patterns such as rhetorical "X, not Y"…

Quellsprache: Englisch

writing-style

Marin house writing style. Use when drafting or revising Marin-authored prose, including commit messages and GitHub PR, issue, or comment text.

Quellsprache: Englisch

write-tests

Write or revise Marin tests with an emphasis on behavior, regression coverage, pytest style, and avoiding "slop tests." Use when adding tests, fixing failing tests, reviewing test quality, or deciding what test would catch a bug.

Quellsprache: Englisch

ab-test-zephyr

Run a Zephyr control and treatment on pre-normalized data and compare per-stage Finelog CPU, elapsed-time, and memory stats. Use for ad hoc comparisons and PR performance gates; add named treatments only when requested.

Quellsprache: Englisch

consult-echo

Search and cite Marin's Echo activity and wiki, then capture incident records or reusable shared knowledge. Use when looking for prior discussions, decisions, workflows, incident patterns, exact errors, tags, or identifiers; when prior context could shorten…

Quellsprache: Englisch

add-pallas-kernel

Add, modify, or autotune a TPU/GPU Pallas kernel.

Quellsprache: Englisch

write-ops-log

Publish a tagged postmortem incident record to Echo. Use after an infrastructure or durable debugging session, then link the canonical Echo URL from the associated PR or issue.

Quellsprache: Englisch

write-design-doc

Produce a 1-page design proposal for an explicit design task or a design-level change identified by another change workflow. Do not use to answer or evaluate an idea inline.

Quellsprache: Englisch

fix-issue

End-to-end workflow to fix a GitHub issue in marin-community/marin.

Quellsprache: Englisch

run-ferries

Launch, monitor, and seal Marin canary and daily ferry runs.

Quellsprache: Englisch

deploy-iris-controllers

Deploy the Iris controller to one cluster or across the fleet, with automatic progress through passed gates. Use when restarting, rolling out, or rolling back a controller.

Quellsprache: Englisch

add-grant

Add a GCP IAM or IAP user grant to the marin-iac Pulumi stacks, encrypting human principals. Use when someone needs access to a project role, bucket/secret/service account, or an IAP-gated web service (evaldash, grafana), whether requested locally or on a…

Quellsprache: Englisch

review-grant

Review a marin-iac user-grant PR by decrypting the changed principals into the real emails and grants, confirm with the user, then approve, merge, and drive pulumi up. Use when reviewing a PR that edits iam_data.yaml or a service's IAP viewers.

Quellsprache: Englisch

reserve-gpu

Reserve Iris-backed CoreWeave H100 or GB200 nodes with dev_gpu.py. Use for interactive GPU debugging, multi-node tests, or reconnecting to a dev GPU session.

Quellsprache: Englisch

query-inference-metrics

Investigate a vLLM serve's performance (throughput, TTFT/TPOT latency, queue depth, KV-cache usage) from durable Finelog telemetry with SQL. Use when asked how an inference or eval serve performed, or why it was slow. For kernel-level JAX profiling, use…

Quellsprache: Englisch

debug

Debug code bugs or Iris/Zephyr/TPU infrastructure faults with a structured incident record.

Quellsprache: Englisch

recover-stuck-k8s-pod

Diagnose and safely recover stuck terminating Kubernetes pods on Marin CoreWeave clusters, especially node-bound GPU pods. Use for deletion hangs, suspected uninterruptible GPU/NCCL waits, node cordoning or reboot decisions, and force-deletion requests.

Quellsprache: Englisch

archive-experiments

Retire legacy experiment scripts behind a dated archive tag.

Quellsprache: Englisch

fix-docs

De-rot markdown docs in lib/iris, lib/zephyr, and lib/fray.

Quellsprache: Englisch

organize-experiments

Curate the experiment report index at docs/reports/index.md.

Quellsprache: Englisch

profile-training

Profile JAX training and analyze hotspots. Use when profiling or optimizing training throughput.

Quellsprache: Englisch

run-research

Multi-session research workflow: compose logbooks, experiment issues, documentation updates, and snapshot discipline for long-running investigations.

Quellsprache: Englisch

task-snapshot

Create stable commit or tag snapshots for task milestones, experiment results, and reproducible artifact links.

Quellsprache: Englisch

file-issue

File a GitHub issue for a bug or improvement found this session.

Quellsprache: Englisch

review-pr

Multi-agent correctness review of a pull request.

Quellsprache: Englisch

babysit-job

Monitor an Iris job and recover it on failure. Use when asked to babysit or watch a job or run.

Quellsprache: Englisch

triage-canary

Triage a failed canary ferry run (CI-invoked).

Quellsprache: Englisch

lint-review

In CI, run the infra/lint catalog review over a PR.

Quellsprache: Englisch

add-dataset

Register or inspect a Hugging Face dataset for Marin pipelines.

Quellsprache: Englisch

background-research

Forage prior work before or during Marin research threads: search internal Marin artifacts and external literature/code; produce a cited brief with negative results and ranked experiment hypotheses.

Quellsprache: Englisch

task-logbook

Maintain append-only task/research logbooks and publish the important parts upward into coordinating GitHub issues.

Quellsprache: Englisch

update-docs

Update documentation, runbooks, and reusable task guidance when implementation work or experiments change behavior or operational practice.

Quellsprache: Englisch

wandb-reporting

Use W&B runs, reports, and artifacts consistently for experiments, benchmarks, and task results with dense numeric output.

Quellsprache: Englisch

change-grug

Modify or upstream a Grug/Grugformer experiment variant.

Quellsprache: Englisch

scrub-docs-code-parity

Scheduled scrub: docs and code parity.

Quellsprache: Englisch

scrub-reflection-self-improvement

Scheduled scrub: repository self-improvement.

Quellsprache: Englisch