Skip to content
OTFotf
All posts

Atlassian Code Context: AI Agents Gain Full Codebase Visibility

D
DaveAuthor
7 min read
Atlassian Code Context: AI Agents Gain Full Codebase Visibility

The headline feature of Atlassian's new Code Context capability isn't the multi-repo search. It's that an agent can finally ask why a service was built the way it was — and get an answer drawn from Jira, Confluence, and the PR that shipped the change. That's the difference between a tool that generates code and one that understands it. Atlassian shipped it on August 12, and the early numbers suggest it's the rare feature that makes agents both more accurate AND cheaper to run.

For the past two years the biggest bottleneck on AI coding assistants hasn't been model quality. It's been context. An agent in your editor sees the file you opened, maybe the folder around it, and whatever snippet you pasted into the prompt. Across a 40-repo org with services that depend on each other and architectural decisions buried in three-year-old Jira tickets, that surface area is a rounding error.

Atlassian Code Context is the answer: a queryable index across your entire connected codebase, plus every work item and doc that shaped it.

The context gap is bigger than the file picker

A senior engineer opening a ticket about flaky auth already knows the relevant context. They remember the Q3 redesign, the on-call postmortem, the RFC doc. The agent next to them sees three files and a stack trace.

That asymmetry is the real ceiling on AI coding today. When an agent guesses at a redesign intent without seeing the ticket that explained it, the patch compiles and the bug ships anyway. When it rewrites a service without knowing the downstream consumer changed its schema, the test suite goes green in CI and red in staging. We don't see "the model was wrong." We see "AI agents aren't production-ready." They're wrong for the same reason a contractor with no blueprints is wrong: not lack of skill, lack of context.

Atlassian's framing of Code Context makes that point explicit. The capability exists inside the Teamwork Graph — the connective tissue across Atlassian's tools — and indexes connected codebases (GitHub, Bitbucket) so any agent can run exact, natural-language, or semantic searches across every repo in one call. That's the headline.

The less-obvious feature is what comes along for the ride: Jira work items, Confluence pages, Loom recordings, and 50-plus third-party integrations. An agent asking about your authentication service doesn't just see the code. It can find the Jira ticket that explains why the auth flow was redesigned, the Confluence page that documents the original architecture decision, and the PRs that shipped the change.

A central Teamwork Graph node branching outward into code repos, Jira work items, Confluen

The mechanism — semantic retrieval, not context dumping

The interesting engineering choice is the retrieval model. Code Context doesn't try to dump every repo into the prompt window. It exposes a queryable surface — exact match, natural language, semantic — and lets the agent pull precisely what it needs.

That matters because it's the opposite of how most "give the agent more context" features work. They pre-load the prompt with as much as fits, and hope the model figures out what's relevant. The result is a context window full of plausible-but-irrelevant snippets that the model has to read past to find the signal.

Semantic retrieval inverts that. The agent asks a focused question, the index returns the relevant code, the relevant Jira ticket, the relevant Confluence page. The prompt becomes narrow and high-signal instead of wide and noisy. That's why the token count goes down while the accuracy goes up.

11 production screens. Login, database, payments — all wired.

The SaaS Dashboard Kit ships everything already connected. Nothing to set up. Live demo at saas.otf-kit.dev.

See the live demo

The numbers — and what they actually mean

Atlassian published internal benchmark results alongside the announcement. Agents enriched by the Teamwork Graph delivered 44% more accurate results while using 48% fewer tokens compared to agents operating without that context.

agent with no org context vs agent wired into Code Context — 44% more accurate, 48% fewer

The token reduction is the counterintuitive part. More context should mean more tokens, not fewer. The explanation in Atlassian's write-up: when agents can retrieve precisely relevant information via semantic search, they stop burning tokens on broad, speculative context dumps. Focused retrieval beats carpet-bombing the prompt.

Those are Atlassian's internal numbers, not independent benchmarks — the thing to watch is whether outside teams reproduce them once they wire the capability into their own agent stacks. If they hold, this is one of those rare features that improves both axes at once. Cheaper AND better.

How to actually use it today

Code Context surfaces through the Teamwork Graph CLI. Installation is a one-liner via the Atlassian-published package (the source article was truncated mid-step on the exact install command — check the Atlassian docs for the current package name and follow-up commands). After install, you authenticate with your Atlassian account and add your code sources.

The realistic setup flow:

  1. Enable Code Context in the Teamwork Graph settings for your Atlassian site. The toggle controls indexing of connected codebases.
  2. Connect the repos you want indexed — GitHub and Bitbucket are first-class. The CLI walks through OAuth and per-repo scope.
  3. Authenticate the agent. Whether you're wiring this into GitHub Copilot, JetBrains AI, or a custom agent on top of an LLM API, the integration point is the same Teamwork Graph query surface.
  4. Query the graph instead of dumping files into the prompt. Ask "why was the auth flow redesigned in Q3" and let the agent assemble the Jira ticket, the Confluence page, the PRs, and the relevant code in one focused retrieval.
  5. Watch the token bill drop while the suggestions get less generic. That's the feedback loop that tells you the integration is wired correctly.

A query that previously needed a human to assemble now looks like this in the agent's tool list:

// the agent's tool definition for Code Context
{
  name: "code_context_search",
  description:
    "Search across all connected repos, Jira work items, " +
    "Confluence pages, and 50+ third-party integrations. " +
    "Prefer this over reading individual files.",
  parameters: {
    type: "object",
    properties: {
      query: {
        type: "string",
        description: "Natural-language question",
      },
      mode: {
        type: "string",
        enum: ["exact", "natural", "semantic"],
        description: "Retrieval mode",
      },
      sources: {
        type: "array",
        items: {
          type: "string",
          enum: ["code", "jira", "confluence", "loom", "integrations"],
        },
      },
    },
    required: ["query"],
  },
}

The agent decides when to call it. The cost is the focused retrieval, not a 200k-token preamble.

What this enables for builders

Three things get genuinely easier once an agent can query the org graph.

Cross-service edits. "Refactor this endpoint to match how service B handles retries" used to require a human who knew both services. Now the agent reads both repos, the Jira ticket that explained the retry policy, and the postmortem that motivated it.

Onboarding ramp. New engineers traditionally absorb context through six months of code review and hallway conversations. An agent with Code Context collapses that to a single query: "how does our auth work and why does it look like this."

Postmortem-aware fixes. When an incident produces a Jira ticket with a corrective action, the agent can now see it. So when someone opens a similar bug six months later, the fix doesn't accidentally undo the corrective change.

None of this is theoretical. The plumbing shipped.

The part that doesn't change when the agent does

Context windows change. Retrieval models change. The Teamwork Graph gets new integrations, the agents wired into it get swapped for newer models, the CLI evolves. None of that changes the fact that your product still ships the same UI to the same users.

That's the durable layer worth investing in. When AI agents get better — and they will, faster than most teams expect — the components they write into need to look and behave the same on web, iOS, and Android. One API, one design system, one source of truth. The model churns. The component contract doesn't.

Use Atlassian Code Context. Wire your agent to the Teamwork Graph. Let semantic retrieval carry the context load. And make sure whatever the agent writes into is a component layer built to outlive the model that wrote it.

Code Context is the rare release where the headline (multi-repo semantic search) is actually the less interesting part. The interesting part is that an AI agent can finally ask why a system looks the way it does — and get a real answer. For teams that have spent two years watching agents produce plausible-but-wrong patches, that answer is worth more than the 48% token savings.

Try it. The CLI is a one-liner, the integration point is the Teamwork Graph, and the worst-case outcome is your agent gets cheaper to run.

ai-toolsarchitecturebackend
OTF SaaS Dashboard Kit

Ship the product, not the setup.

  • 11 production screens — auth, billing, team, analytics, settings
  • Real database, payments, and login — all wired on day 1
  • AI configs pre-tuned so your agent extends instead of regenerates