> ## 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.

# Overview

> Create the perfect context for your analytics agent

## Why a Context Builder?

The Context Builder helps you build a file-system for your agent. This way you can have a full transparent view on the context your agent has access to, and engineer the right way to:

1. **Make it reliable for users** - Ensure consistent, accurate responses
2. **Make it optimized** - Reduce costs, tokens usage, and improve speed

Context is built with nao using a CLI. The CLI will initialize your context repository and sync your context within this repo.

## How It Works

nao uses a file-system approach to organize context:

```
your-project/
├── nao_config.yaml                    # Main configuration
├── RULES.md                           # Agent behavior rules
├── agent/                             # Agent tools and integrations
│   ├── mcps/                          # Model Context Protocols (MCP servers)
│   ├── skills/                        # Reusable skills workflows
│   └── tools/                         # Custom tools
├── databases/                         # Database context
├── docs/                              # Documentation files (including synced Notion pages)
├── repos/                             # Cloned repositories
├── semantics/                         # Semantic context
└── queries/                           # Example queries
```

## Build Your Context

Learn how to add different types of context:

<CardGroup cols={3}>
  <Card title="Databases" icon="database" href="/nao-agent/context-builder/databases">
    Connect databases and sync schemas
  </Card>

  <Card title="Repositories" icon="git" href="/nao-agent/context-builder/repos">
    Add dbt projects and documentation
  </Card>

  <Card title="Rules" icon="book-open" href="/nao-agent/context-builder/rules-context">
    Define how your agent should behave
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Context Configuration" icon="gear" href="/nao-agent/context-builder/configuration">
    Learn how to initialize and configure your nao project
  </Card>

  <Card title="Context Principles" icon="lightbulb" href="/nao-agent/context-engineering/principles">
    Core principles for optimizing your agent's performance
  </Card>

  <Card title="Context Engineering Playbook" icon="book" href="/nao-agent/context-engineering/playbook">
    Step-by-step guide to building effective context for your analytics agent
  </Card>

  <Card title="Evaluation" icon="flask" href="/nao-agent/context-engineering/evaluation">
    Test and evaluate your agent with unit tests
  </Card>
</CardGroup>