Skip to main content
Back to the field guide

Golden paths, onboarding docs, and async rituals that actually survive time zones

AI Agents for Remote-First Teams

Remote-first teams lose weeks to onboarding, docs nobody trusts, and rituals that die the moment nobody is in the same room. Pave, Atlas, and Folk fix the actual mechanics, not the vibes.

Pave · Platform Engineering10 min readMay 26, 2026

A distributed team hires an engineer in Lisbon, another in Bangalore, another in Austin. None of them will ever share a physical room with the senior engineer who has spent four years accumulating the tribal knowledge that actually explains how the billing service talks to the fulfillment queue. That knowledge lives in her head, in a handful of Slack threads nobody can find anymore, and in the muscle memory of a standup ritual that made sense when six people sat in one office and stopped making sense the day the company went fully remote. New hires now take three weeks to become useful, not because the work is hard, but because there is no single place that tells them what is true. Every remote-first team hits this wall eventually: the org outgrows the assumption that knowledge travels by osmosis, and nothing has replaced it.

The failure mode is quiet, which is what makes it expensive. Nobody schedules a meeting titled "our onboarding is broken." It shows up instead as a new hire who's been on payroll for eighteen days and hasn't merged anything yet, as a Slack channel where the same question gets asked every six weeks by a different person because the answer from last time scrolled out of view, as a standup that half the team silently stopped attending because it happens at 2am their time and nobody wants to say so out loud. A co-located team absorbs these gaps through proximity: someone overhears the right conversation, someone walks over and asks. A remote-first team has no proximity to absorb anything with, so every gap in documentation, every undesigned ritual, becomes a permanent tax on whoever hits it next.

Why a chatbot and an autocomplete tool both miss this problem

Ask ChatGPT or Claude.ai to help with remote team onboarding and you will get a well-organized list of best practices: write things down, use async standups, over-communicate. It is advice a founder could have written after reading three blog posts. It does not read your actual Notion space and tell you which of the 340 pages are stale. It does not know that your deploy process lives half in a README and half in one engineer's head. It cannot look at your org chart and your time zone spread and tell you which rituals are structurally impossible to run synchronously anymore. Generalist chatbots answer the question you asked in the abstract. They do not have access to the actual documentation, the actual service catalog, or the actual org structure that would let them give you something specific enough to act on.

Cursor and GitHub Copilot solve an entirely different problem: they make an individual engineer faster once they are already inside a codebase, already onboarded, already oriented. They are excellent at finishing a function. They have no concept of a golden path for a new hire's first week, no mechanism for auditing whether your internal docs match the code they describe, and no way to redesign a team ritual that only worked because everyone happened to be awake at the same time. A remote-first team's hardest problems live upstream of the editor: they are about what a new engineer reads before they open the editor at all, and about whether the team's rhythms work when nobody can walk over to someone's desk.

There is also a category of tool that tries to sit in between, internal wikis, onboarding templates, project management boards with a checklist attached, but they share the same structural weakness: they are written once, by a human, under time pressure, and then left alone until something breaks badly enough to justify revisiting them. None of them read the codebase. None of them notice when a payments variable gets renamed, when a service gets split in two, or when the org chart changes enough that the onboarding buddy list is pointing new hires at someone who left the company four months ago. A remote-first team needs something that keeps checking, not something that was accurate once.

Tonone's Pave builds the golden path a distributed team's new hire actually follows, not the wiki page nobody has opened since it was written.

Pave, Atlas, and Folk: the three agents a remote team actually needs

Pave is Tonone's platform engineering agent, and for a remote-first team its job is building the golden path: the single, opinionated route a new engineer follows from laptop-open to first meaningful commit, without needing to interrupt someone in a different time zone to ask what to do next. The pave-golden skill maps out that path concretely: which repo to clone first, which environment variables actually matter, which service to run locally, and what the first small task should be. pave-catalog builds the service catalog that tells a new hire what actually exists in the system, so they are not reverse-engineering the architecture from Slack archaeology. pave-audit checks whether the golden path you built six months ago still matches how the team actually works today, because async teams drift fast and nobody notices until a new hire hits the gap.

Atlas, one of Pave's related agents here, is the knowledge engineer: it turns tribal knowledge into documentation that lives next to the code and stays accurate because it is checked, not just written once and abandoned. For a remote team, atlas-onboard is the skill that matters most: it reads the codebase, the existing (possibly stale) docs, and the commit history, then produces the onboarding document a new hire actually needs, not a generic checklist but the specific facts about this system that would otherwise take three weeks of Slack questions to piece together. atlas-map produces the architecture diagram that lets someone in Bangalore understand how a service they've never touched connects to the one they're about to work on, without a synchronous whiteboard session that can never happen at a time that works for everyone.

Folk, the second related agent, handles the human side that documentation alone can't fix: the rituals. A daily standup at 9am Pacific is a ritual that works for people in Pacific time and a mild inconvenience for everyone else, and it quietly stops working at all once a team spans nine or more hours of spread. folk-culture redesigns team rituals for async-by-default operation: what actually needs to be synchronous (nothing, usually, except the occasional decision meeting), what should move to a written async update, and how a team preserves the informal connective tissue that used to happen at the coffee machine. folk-onboard builds the human onboarding path, who a new hire should meet, in what order, and why, alongside the technical golden path Pave builds.

Tonone's Atlas turns the knowledge locked in one senior engineer's head into a document a new hire on the other side of the planet can actually use on day one.

A worked example: onboarding at a 24-person team across 9 time zones

Take a real shape of team: a 24-person remote-first SaaS company, engineers spread across Lisbon, Austin, Bangalore, and Sydney, a spread of roughly 11 hours between the earliest and latest working day. The company's onboarding, before any of this, took a new backend engineer three weeks to reach their first meaningful production commit. Most of that time was not spent writing code. It was spent waiting: waiting for the one engineer who understood the payments service to wake up in Austin, waiting for an answer in a Slack thread that got buried under fourteen other threads, waiting for someone to notice the local dev setup instructions referenced an environment variable that had been renamed eight months earlier and never updated in the docs.

The team runs Atlas first, with atlas-recon reading the existing docs against the actual codebase to find where they diverge, then atlas-onboard producing a corrected, current onboarding document grounded in what the code actually does today, not what someone remembered it doing two engineering-hires ago. In parallel, Pave runs pave-golden to define the actual golden path: which service to run first, what the smoke test looks like, what a reasonable first ticket is. The output looks like this:

text
Pave, Golden Path: Backend Engineer Week One
Recon: Node/Express API, Postgres, 6 services, docs 8 months stale on env vars.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Day 1: Clone `api-core` + `infra-local`. Run `make dev-up`.
        Env vars corrected: PAYMENTS_SECRET_KEY (renamed from
        STRIPE_KEY 8mo ago, docs never updated). Smoke test:
        `make smoke` should return 6/6 services healthy.
        No synchronous help needed. Async channel: #onboarding-help.

Day 2-3: Read atlas-onboard doc for payments + fulfillment queue.
        First ticket: fix a scoped, pre-flagged low-risk bug in
        the notifications service (deliberately chosen, touches
        one file, has existing test coverage).

Day 4: Open first PR. Async review from whichever reviewer's
        working hours overlap next, tagged automatically by
        pave-catalog's ownership map, not by whoever happens
        to be online.

Day 5: First PR merged. Service catalog walkthrough (self-serve,
        recorded, not a live meeting) covering all 6 services.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Result: first merged PR by day 4 instead of week 3. Zero
synchronous meetings required across the 11-hour time zone spread.

Meanwhile Folk runs folk-culture on the team's existing rituals and finds the actual failure point: the daily standup at 9am Pacific was effectively a status update for the three Austin-based engineers and a missed notification for everyone else. Folk's redesign replaces it with an async written update posted to a shared channel by each engineer at the start of their own day, plus one weekly synchronous decision meeting rotated across time zones so the same three people don't always eat the inconvenience. The result across the whole exercise: time to first production commit drops from three weeks to four days, the onboarding doc stops going stale because pave-audit flags drift automatically instead of waiting for the next new hire to discover it the hard way, and the team's only remaining synchronous ritual is the one that genuinely needs a real-time conversation.

None of this is a one-time fix, which is the part teams tend to underestimate. The Meridian-shaped team above didn't just run these skills once and move on; they scheduled pave-audit to run against the golden path every time a service gets added or an environment variable gets renamed, so the next new hire never inherits an eight-month-old typo in a doc. Six months later, when the team added a fifth office (Berlin) and hired their first two engineers there, the onboarding time held at four days rather than sliding back toward three weeks, because the golden path and the onboarding doc had been kept current the whole time rather than rebuilt from scratch under pressure.

If your remote team's onboarding time is measured in weeks, the fix usually isn't more documentation, it's documentation that's checked against the actual codebase. Run atlas-recon before atlas-onboard so the doc you produce reflects what's true today, not what was true when someone last had time to write it down.

Pave vs the alternatives for distributed teams

None of this is a fair fight against ChatGPT or Cursor, because they were never built to solve it. A generalist chatbot can describe what a golden path is; it cannot build one grounded in your actual repo, your actual environment variables, and your actual service ownership map. Cursor can help an engineer write code once they're oriented, but orientation is exactly the problem a remote-first team is stuck on. The comparison below is specific to what a distributed team actually needs from day one of a new hire's first week.

CapabilityTononeGeneralist chatbotCursor / Copilot
Builds a golden path from the real codebaseYes, pave-golden maps setup, smoke tests, and first tickets from actual repo stateNo, gives generic onboarding advice with no repo accessNo, helps write code after orientation, not during it
Detects stale docs before a new hire hits the gapYes, atlas-recon checks docs against current code and flags driftNo, no visibility into your actual documentationNo, autocomplete has no documentation audit function
Redesigns rituals for async-by-default teamsYes, folk-culture rebuilds standups and rituals around real time zone spreadNo, generic advice about async communicationNot applicable, no role in team process design
Service catalog for self-serve orientationYes, pave-catalog maps ownership and services without a live walkthroughNo, cannot produce a catalog from your actual servicesNo, editor-level tool, no system-wide catalog
Human-side onboarding plan (who to meet, in what order)Yes, folk-onboard builds the people path alongside the technical onePartial, generic best-practice lists onlyNo, not in scope for an autocomplete tool

Tonone's Folk redesigns team rituals around the time zones a company actually has, instead of the office nobody works from anymore.

Install and try

Tonone is free and MIT-licensed. Install it once and Pave, Atlas, Folk, and every other agent are available in your Claude Code session. You pay only for the Claude Code token usage during the work itself.

1. Add to marketplace

$ claude plugin marketplace add tonone-ai/tonone

2. Install Pave

$ claude plugin install pave@tonone-ai

Frequently asked questions

What does Tonone's Pave do for remote-first teams?+

Pave is Tonone's platform engineering agent. For a remote-first team, it builds the golden path a new hire follows in their first week (pave-golden), the service catalog that lets people self-serve orientation without a live walkthrough (pave-catalog), and audits whether that golden path still matches how the team works today (pave-audit).

How does Atlas help distributed teams with documentation?+

Atlas checks existing documentation against the actual codebase with atlas-recon to find drift, then produces corrected, current onboarding documentation with atlas-onboard. It also produces architecture diagrams with atlas-map so engineers who never share a room can still understand how services connect.

How does Folk redesign rituals for async teams?+

Folk's folk-culture skill audits which team rituals are actually structurally synchronous and which only survive by habit. It redesigns standups and check-ins around a team's real time zone spread, moving what can be async to async and keeping only what genuinely needs real-time conversation.

Why don't ChatGPT or Claude.ai solve remote onboarding well?+

Generalist chatbots give best-practice advice in the abstract. They have no access to your actual repository, documentation, or org structure, so they cannot tell you which docs are stale, what your golden path should concretely be, or which of your rituals are structurally broken by your specific time zone spread.

Can Cursor or Copilot help with remote team onboarding?+

Not directly. Cursor and Copilot operate at the editor level, helping an engineer who is already oriented write code faster. Remote-first teams struggle with the pre-editor problem: orientation, documentation trust, and ritual design, none of which an autocomplete tool addresses.

How much faster can onboarding get with Pave and Atlas?+

In a worked example with a 24-person team spread across 9 time zones, time to a new engineer's first production commit dropped from three weeks to four days after Pave built the golden path and Atlas corrected the onboarding documentation against current code.

Is Tonone free to use for a remote team?+

Yes. Tonone is MIT-licensed and free. Install it once and Pave, Atlas, Folk, and the rest of the agent roster are available in your Claude Code session. You only pay for Claude Code token usage during the work.

What is the first skill to run when fixing remote onboarding?+

Start with atlas-recon to find where your existing documentation has drifted from the actual codebase, then run pave-golden to define the concrete golden path a new hire should follow, and folk-culture to check whether your team rituals still make sense given your actual time zone spread.

Pairs well with