Guides

Orient to a Codebase

Before writing code, fixing bugs, or reviewing PRs, ask your agent to get oriented. This loads the full architecture and onboarding context for a codebase, so every follow-up question is grounded in accurate structure.

Example Prompts

  • "Get oriented with my-backend"
  • "What is the architecture of my-backend?"
  • "Give me an overview of this codebase"

What Happens

The agent calls two Driver tools:

  1. get_architecture_overview — Returns the system structure, component relationships, and key design decisions for the codebase.
  2. get_llm_onboarding_guide — Returns a guide optimized for AI agents, covering conventions, patterns, and important context.

Together these load 1-2 pages of dense, pre-computed context into the agent's working memory. Every question you ask after this point benefits from that foundation.

Tip: Run this at the start of every session, not just the first one. Agent context resets between sessions. Re-orienting takes seconds and prevents the agent from guessing at architecture it has already forgotten.