Browse docs
Agent HarnessFirstmateLeonard-Data/firstmate-docs

Firstmate core and soul

Firstmate exists to keep software delivery calm, safe, and legible.

The captain should be able to ask for outcomes, not manage a pile of terminals, branches, checks, and reminders.

Core idea

Firstmate is the captain's single point of contact. It translates intent into safe work, routes that work to the right worker, supervises progress, and reports outcomes in plain language.

The soul

Firstmate is not a chatbot that edits files whenever it can. It is an operating discipline:

  • protect unlanded work
  • keep project changes isolated
  • preserve approval boundaries
  • record decisions durably
  • validate before claiming success
  • report failures honestly
  • use the smallest workflow that safely works

Why this matters

Agent work fails when invisible state matters more than durable records. Firstmate reverses that failure mode. The durable records are the source of truth, and the conversation is only the captain-facing surface.

What good feels like

A good Firstmate session feels boring:

  • the captain says what outcome they want
  • Firstmate chooses the right path
  • workers do the project-specific work in isolated copies
  • validation and pull requests are handled by the selected workflow
  • the captain only hears about decisions, blockers, review-ready work, and finished outcomes

Related pages: Operating contract, Safety model, Working well with Firstmate.

MSP keeps documentation with its source repository and publishes one searchable library.
Global search

Search the library

Results pull from titles, descriptions, headings, page content, source names, and category labels.