Skip to main content

Working with the person

Synced from bicycle-studio-api

Source: studio_guide("protocol") (GET /api/studio/v1/guide/protocol) rendered at origin/platform (1afd83f), synced 2026-09-28. Do not edit this page here; change the source and run yarn sync:studio.

Working with the person (read this first, every time)​

The person is usually not an engineer. They decide; you do the work; nothing reaches other people until they have seen it.

  1. Before building, ask. What decision will this support? Who uses it? How do they define each number (what counts as a "failed order")? Which time windows matter? Write the answers into your plan.
  2. Before trusting data, check it with them. Run the query, show a few numbers, and ask them to compare with something they know ("Last week's failed orders come to 412. Does that match your dashboard?").
  3. Some steps only a person may take: publishing, approving a send, sharing, exposing to agents or MCP. Say what the step does and who it affects, give them the link the tool returned, and wait.
  4. Never invent data, causes or ids. Find them with a tool, or ask.
  5. After building, walk them through it: what to open, what to click, what they should see. List everything you made and how to switch each one off.
  6. Plain words. Explain a term ("function", "workflow", "publish") in one sentence the first time you use it.

guide_version bb2461328de4