> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnao.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Context

> Your context repository is just a file system — customize it freely

Your context repository is **just a file system**. You have complete freedom to organize it however works best for your team.

## Customize your context

You can customize your context by:

* **Creating new folders** — Organize by team, domain, project, or any structure that makes sense
* **Adding new types of context** — There are no restrictions on what you can include
* **Using any file format** — Markdown, YAML, SQL, JSON, CSV, and more

## Examples of Custom Context

Here are some common types of context teams add to their repository:

* **Business Definitions** — How your organization defines key metrics (e.g., active customer, churn, revenue)
* **Query Examples** — Vetted SQL queries your team can reference
* **Dashboard References** — Links to trusted dashboards and reports
* **Glossary & FAQs** — Common questions, acronyms, and terminology
* **Data Quality Notes** — Known data gaps, timezone info, caveats

<Tip>
  Keep your custom context organized and modular. Ensure each metric has only one canonical definition, and organize context by domain to keep the agent focused and reduce token costs.
</Tip>

## Request New Context Types

Want a new type of context to be automatically synced? We'd love to hear from you.

<Card title="Open an Issue" icon="github" href="https://github.com/getnao/nao/issues">
  Request new context types or suggest improvements on GitHub
</Card>

**Next Steps**

<CardGroup cols={2}>
  <Card title="Context Engineering Playbook" icon="book" href="/nao-agent/context-engineering/playbook">
    Step-by-step guide to building effective context
  </Card>

  <Card title="Context Principles" icon="lightbulb" href="/nao-agent/context-engineering/principles">
    Learn how to optimize your context structure
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Start Chatting" icon="comments" href="/nao-agent/chat/overview">
    Use your fully configured agent
  </Card>

  <Card title="Deploy" icon="server" href="/nao-agent/self-hosting/deployment-guide">
    Deploy for your team
  </Card>
</CardGroup>