Browse Ship docs
Ship docs
Ship docsRoutines

Routines

What you are trying to do

You want the work to keep moving without you watching it. You also want to know, by Monday morning, what happened over the weekend, what got stuck, and what you should look at first when you sit down with coffee.

Routines are the recurring jobs Ship runs in the background to make that true. There are two of them you should know by name.

How stuck work unsticks itself

Ship no longer runs a separate hourly "self-heal" sweep. Instead, the pipeline is event-driven: a ticket only moves when its tracker state changes, and a ticket that genuinely cannot proceed freezes itself with a blocked signal label until the obstacle clears. Stalls surface in the daily digest rather than being patched by a background bot.

Daily digest — every morning, one letter in your Inbox

Once a day, the daily digest routine reads the last 24 hours of activity across every repository in the workspace and files one Inbox letter. The letter has five sections, always in the same order: a headline (green, yellow or red, with one sentence why), a throughput count (how many finishes, how many dispatches, how many things got stuck in flight), two to four lessons learned, any open pull requests or blocked tickets that have been sitting too long, and how many Inbox letters from prior digests you still have not read.

This is your morning newsletter. It is intentionally one item, not five. If you have time for nothing else, the daily digest is the thing to open.

The retro will still file on a silent day — a one-line "all green, nothing to report" letter — because silence is ambiguous. You should be able to glance at your Inbox and know that the routine actually ran.

Weekly audit — every Monday, the assurance pass

Delivery work and the work of proving delivery happened well are not the same job. The weekly audit routine runs once a week and produces a separate report covering four areas: tech-debt and architecture drift, QA coverage gaps, security findings, and process health.

It does two things at once. It files an audit report in your Inbox with the headline numbers — how many gaps, where the worst ones are, which pull requests have been sitting open the longest. And it opens tickets for the gaps worth tracking — usually fewer than ten in a week, capped on purpose so the board does not drown.

The point of the weekly audit is to keep "we should clean that up sometime" from being the most expensive sentence in your codebase. By the time Monday morning arrives, the cleanup work is already a real ticket sitting in your backlog with a body that names the file and the reason.

What this changes about your week

You stop being the clock. You stop being the one who notices on Thursday that an important pull request has been sitting unmerged since Monday.

Each morning the digest lands as a letter you can read from the console hub or pull up through your own agent — yesterday's digest plus anything an agent escalated overnight. It is a small, predictable handful, and you process it before your coffee goes cold. Routines are how Ship breathes while you are not watching — you did not hire an operations team for this, you bought one.

Routines — Ship docs — Harbor Gang