Skip to content

devlog/flow-recipes/a-new-teammates-first-ai-session-without-the-waste-501.md

A New Teammate’s First AI Session, Without the Waste

Start with a small diff, not a repository tour

When a teammate joins, the tempting first prompt is: read this repository and explain everything. I would rather give them a failing test, a narrow bug, and a spending limit. They learn the codebase by shipping something real, and we avoid paying for an agent to wander through generated files and old migrations.

Pick a task that takes an experienced maintainer about thirty minutes: tighten input validation, fix an error message, or cover a missing boundary case. Write down the acceptance criteria before opening the assistant. A clear finish line is cheaper than another round of prompting.

Set up one connection and verify one request

Keep the connection setup boring. Fluxo provides one key and one base URL, https://api.fluxorelay.com, for Claude, GPT, Gemini, DeepSeek, Kimi, GLM, Qwen, Grok, and more. It works with Claude Code, Codex, Gemini CLI, and any OpenAI SDK. That lets a new teammate keep their preferred editor and terminal workflow instead of learning a separate dashboard ritual.

If you want to try this playbook, create a Fluxo account and use a small first task to establish your baseline. Keep credentials out of version control, follow your team's secret-management policy, and verify a minimal request before connecting an agent to the repository. If you need help, leave a note on the contact page after signing in.

Give the first session a measurable budget

Fluxo has no monthly fee and bills per real token, including cache reads and writes. That makes usage worth inspecting from day one. Do not treat cached context as free, and do not assume a short answer means a cheap session: the assistant may have consumed substantial input along the way.

  • Agree on a first-session spending ceiling before running repository-wide exploration.
  • Record the selected model, task outcome, token usage, and actual charge.
  • Stop after two unsuccessful repair attempts and inspect the failure together.
  • Require approval before expanding scope or launching additional autonomous runs.

Use whatever usage reporting your setup exposes, and reconcile it with billed usage. Where hard limits are unavailable, use explicit check-ins rather than pretending a written budget enforces itself.

Hand over a context packet, not the whole tree

I keep a short onboarding note beside the code: test commands, formatting commands, relevant directories, architectural constraints, and the definition of done. For the first task, I add the failing command and the two or three files most likely involved. Check the tool's exclusion settings for secrets, build output, vendored dependencies, and large fixtures.

The first prompt should ask for a plan before edits: inspect these files, explain the likely cause, propose the smallest patch, and name the tests to run. Review that plan together. If it points at an unrelated subsystem, correct the scope before paying for implementation.

Choose models by accepted patches, not habit

Try Claude Haiku 4.5 on a bounded task, then consider Claude Sonnet 5.5 when the task needs more reasoning. These are candidates to evaluate, not a promise about relative prices or success rates. Check current rates and compare actual charges for similar work.

My useful metric is cost per accepted patch, including retries and human review time. A low-cost attempt that needs six corrections may be worse value than one stronger attempt. Conversely, escalating every formatting fix wastes budget without improving the result. Keep the task and acceptance criteria stable when comparing models.

End the pairing session with a reusable checklist

Before merging, have the teammate explain the diff without the assistant. Run tests independently, inspect changed files, and remove unrelated edits. Save the useful context packet and test commands, not the entire chat transcript.

Fluxo also lets users earn a referral share when people they invite pay. Keep that separate from engineering decisions: referrals are not savings on the task itself. The repeatable win is a teammate who knows when to ask, what context to supply, and when to stop an unproductive run.

Next in the buffer

Sign up in a minute and get credit to try every model mentioned here. Sign up →