marin-community/marin

scrub-experiment-issue-tldrs

Scheduled scrub: TL;DR blocks on experiment issues.

Idioma do texto original: inglês

manage-hero-run

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

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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"…

Idioma do texto original: inglês

writing-style

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

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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…

Idioma do texto original: inglês

add-pallas-kernel

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

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

fix-issue

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

Idioma do texto original: inglês

run-ferries

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

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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…

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

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…

Idioma do texto original: inglês

debug

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

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

archive-experiments

Retire legacy experiment scripts behind a dated archive tag.

Idioma do texto original: inglês

fix-docs

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

Idioma do texto original: inglês

organize-experiments

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

Idioma do texto original: inglês

profile-training

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

Idioma do texto original: inglês

run-research

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

Idioma do texto original: inglês

task-snapshot

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

Idioma do texto original: inglês

file-issue

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

Idioma do texto original: inglês

review-pr

Multi-agent correctness review of a pull request.

Idioma do texto original: inglês

babysit-job

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

Idioma do texto original: inglês

triage-canary

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

Idioma do texto original: inglês

lint-review

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

Idioma do texto original: inglês

add-dataset

Register or inspect a Hugging Face dataset for Marin pipelines.

Idioma do texto original: inglês

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.

Idioma do texto original: inglês

task-logbook

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

Idioma do texto original: inglês

update-docs

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

Idioma do texto original: inglês

wandb-reporting

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

Idioma do texto original: inglês

change-grug

Modify or upstream a Grug/Grugformer experiment variant.

Idioma do texto original: inglês

scrub-docs-code-parity

Scheduled scrub: docs and code parity.

Idioma do texto original: inglês

scrub-reflection-self-improvement

Scheduled scrub: repository self-improvement.

Idioma do texto original: inglês