# .dinorules

The `.dinorules` file allows you to define custom instructions and development standards to tailor how DinoAI responds to your prompts and questions. These rules are specific to your project and will apply to all DinoAI interactions within your environment.

{% hint style="warning" %}
**.dinorules file is git-tracked by default**

If you don't want this file git-tracked, [see docs](#disabling-git-tracking) to disable.
{% endhint %}

{% hint style="success" %}

#### Key Benefits

* **Define Project-Specific Rules**: Customize DinoAI's behavior to match your team's unique needs and workflows.
* **Set Technical Standards**: Specify coding patterns, architecture guidelines, and best practices for your project.
* **Adapt Over Time**: Easily modify the rules as your project evolves and requirements change.
* **Team Collaboration**: Files are git-tracked by default, enabling shared standards across your entire data team.
  {% endhint %}

### Setting Up .dinorules

1. From the Code IDE, Click the DinoAI icon (🦖) icon on the right-side panel. 
2. Click the settings icon (⚙️) at the top right of the DinoAI panel
3. Click "Edit" in the .dinorules section to create file.
   1. Alternatively, you manually add a .dinorules file in your project files

{% hint style="warning" %}
Make sure the `.dinorules` file is placed in the **root directory of your repository**

```
your-repository
├── dbt_project/
│   ├── staging/
│   └── marts/
├── macros/
├── seeds/
├── .dinorules              # .dinorules file location
├── README.md
```

{% endhint %}

3. Add your [custom instructions to the file](#example-.dinorules-file-configuration). These can be general or highly specific - there's no set syntax required.

{% @arcade/embed flowId="9RN6tO67l5JPmEp1w8cm" url="<https://app.arcade.software/share/9RN6tO67l5JPmEp1w8cm>" %}

***

<details>

<summary>Example .dinorules file configuration</summary>

```
General Project Context
- Domain: E-commerce analytics
- Data Stack: dbt project using Snowflake
- Primary Goal: Provide accurate, reusable, and scalable answers to analytics engineering-related questions.


Modeling Guidelines
- Naming: Use `snake_case` for all model and column names.
- Structure: Assume models follow a `staging → marts` hierarchy.


Materialization Standards
- Staging Models: Typically materialized as views.
- Mart Models: Typically materialized as incremental.
- Performance Exceptions: Assume exceptions may exist for performance reasons.


SQL and dbt Best Practices
1. Trailing Commas: Always use trailing commas in `SELECT` statements for clean diffs.
2. SQL Keywords: Write all SQL keywords (`SELECT`, `FROM`, etc.) in uppercase.
3. snake_case: Consistently use `snake_case` for names.
4. CTEs: Use Common Table Expressions (CTEs) instead of subqueries for clarity.
5. Comments: Add comments to improve readability, especially for complex logic.


Testing Standards
- Schema Tests: Recommend `unique` and `not_null` tests for all primary keys and critical columns.
- Data Tests: Suggest data tests for key metrics and transformations to ensure quality.


Answering Style
1. Specificity: Tailor answers to dbt-specific workflows.
2. No Assumptions: Focus on answering questions without assuming the capability to execute code.
3. Best Practices: Default to dbt and analytics engineering best practices unless otherwise requested.


Documentation Standards
- Descriptive Naming: Recommend clear and descriptive names for models and columns.
- Comments: Suggest adding column comments to enhance data lineage clarity.
- schema.yml: Emphasize the importance of keeping `schema.yml` files updated.
```

</details>

***

### Git Tracking

**.dinorules file is git-tracked** **by default** to enable seamless team collaboration on DinoAI configurations.&#x20;

{% hint style="info" %}

#### What This Means

* **.dinorules** is be tracked by git automatically
* **You can commit, modify, and request reviews** like any other file in your repository
* **Full change tracking and version history**
* **Seamless team collaboration** on AI configurations
  {% endhint %}

#### Disabling Git Tracking

{% hint style="info" %}
If you haven't agreed internally on rules/prompts: You may encounter a merge conflict when updating your branch. You can [use Paradime to resolve it](https://docs.paradime.io/app-help/concepts/working-with-git/merge-conflicts), but we recommend agreeing on common versions for the .dinorules file first.
{% endhint %}

To disable, simply add `.dinorules` to your .gitignore file.&#x20;

{% @arcade/embed flowId="ha19hxzSdo5MUwuZ7FIP" url="<https://app.arcade.software/share/ha19hxzSdo5MUwuZ7FIP>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paradime.io/app-help/documentation/dino-ai/dino-rules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.