> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/en/features/compliance/library/frameworks/custom.md).

# Create a custom framework

Dastra lets you create your own regulatory framework and adapt it to your needs with the help of artificial intelligence

## Introduction

Creating a custom framework makes it possible to build a compliance framework **adapted to the organization's specific context**: internal policy, sector-specific framework, AI initiative, security, quality or governance.

A custom framework can be:

* built **entirely from scratch**,
* or serve as a **common foundation** for several compliance projects.

***

## Step 1: Creating the framework

{% columns %}
{% column %}
When creating a custom framework, the user defines:

* **The framework name** (e.g. *Custom AI*, *AI ISSP, Demo*)
* **The framework language**, which will determine the default language of the requirements and controls

Once created, the framework is added to the Library, in a **draft** state.
{% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-d7ff6a4c52ce9a9c732dd51f7135194064204f80%2Fimage-448.png?alt=media" alt="Framework creation window with the name, the language and the logo"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Step 2: Viewing and available actions

By default, a newly created framework is:

* **empty**
* **read-only**

### Actions available as long as the framework has not been modified

* **Export**: retrieve the framework in JSON / Excel format
* **Create a copy**: duplicate the framework
* **Move to recycle bin**: remove the framework from the library (**Restore** brings it back, **Delete** removes it permanently)

**No addition or modification is possible until the framework is in edit mode.**

***

## Step 3: Switching to edit mode

{% columns %}
{% column %}
To enrich the framework (chapters, requirements, controls…), it is necessary to:

1. Click on **Edit**
2. Switch the framework to **edit mode**

In edit mode, the user can:

* Create **chapters**
* Add **requirements**
* Progressively structure the framework

{% hint style="warning" %}
Edit mode is only available for a draft version. The requirements of a published version are locked and the **Edit** button is disabled: create a version of the framework to evolve them (see [Framework versions](https://doc.dastra.eu/en/features/compliance/library/frameworks/versions.md)). The name, logo and description remain editable.
{% endhint %}
{% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-8f1c6efffa006566ecc810a2bf2cec10e5a03b02%2Fimage-449.png?alt=media" alt="Page of a newly created framework, empty and read-only"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Creating and structuring requirements

Once the framework has been created and switched to **edit mode**, the user can begin structuring the framework using **chapters** and **requirements**.\
This step makes it possible to translate a regulatory, normative or internal framework into elements that can be used in Dastra.

***

### Structuring by chapters

{% columns %}
{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-1c56a7313057817069135bcdc49b0b20e1eba55c%2Fimage-450.png?alt=media" alt="Chapter creation window"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Chapters make it possible to organize the framework in a readable and coherent way.
{% endcolumn %}
{% endcolumns %}

#### Structuring rules

Dastra allows:

* **root chapters**
* **sub-chapters**

The depth is intentionally limited to a **maximum of two levels** in order to:

* guarantee the readability of the framework
* avoid overly complex structures
* make it easier to use the requirements in compliance projects

#### Fields to fill in

When creating a chapter:

* **Reference**: internal identifier of the chapter
* **Name**: functional title of the chapter

{% hint style="info" %}
*Best practice*: use chapters to structure by major themes\
(e.g. governance, security, operations, uses…).
{% endhint %}

***

### Creating a requirement

{% columns %}
{% column %}
Requirements express the **compliance expectations** the organization must meet.\
They constitute the direct link between the framework and the operational controls.
{% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-b074843dea51fbe8adcaba95c914824ca2d46cfe%2Fimage-451.png?alt=media" alt="Requirement creation window"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### Available fields

* **Reference (required)**\
  Unique identifier of the requirement within the framework
* **Name (required)**\
  Concise formulation of the requirement
* **Description (optional)**\
  Details of the expected content, scope and objectives of the requirement

***

### AI assistance for the requirement reference

{% columns %}
{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-520ae5e2f6eb23079a5f2dc307d5e72c91d0b097%2Fimage-452.png?alt=media" alt="Requirement creation window with the reference suggested by the AI"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
When creating a requirement, Dastra offers **AI assistance** to automatically generate a reference consistent with:

* the name of the requirement
* the parent chapter
* the context of the framework
  {% endcolumn %}
  {% endcolumns %}

This feature makes it possible:

* to harmonize naming conventions
* to avoid inconsistencies or duplicates
* to save time when creating custom frameworks

The user remains free to modify the proposed reference.

***

### Organizing and managing requirements

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-d810b269def1a9eecbab6efb534e5fd81818a9ad%2Fimage-476.png?alt=media" alt="Menu to move a requirement in the framework tree"><figcaption></figcaption></figure>

Once created, requirements can be:

* moved to another chapter
* deleted
* progressively enriched

Each requirement also displays summary indicators (links with controls, risks, tests), making it easier to understand its level of coverage.

***

### Associating controls with a requirement

{% columns %}
{% column %}
Controls are the **operational** elements that make it possible to demonstrate compliance with one or more requirements.

To associate controls with a requirement, two approaches are possible.
{% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-cf761e98137ef0b02232800b6125fec3c7325ad5%2Fimage-453.png?alt=media" alt="Choice between associating existing controls or creating controls with the AI"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

#### Option 1: Associate existing controls

{% columns %}
{% column %}
The user can select one or more controls already present in the Library and attach them to the requirement.
{% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-29ad02f454c171d57cd7d600d4d4f946a4903bad%2Fimage-454.png?alt=media" alt="List of existing controls to associate with a requirement"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

A single control can be associated with **several requirements**, promoting:

* sharing
* consistency of the framework
* better traceability

***

#### Option 2: Create or associate controls with AI

{% columns %}
{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-378f8028d4b9eb0a2dde0d5a0ac4d30c4e7dca6a%2Fimage-455.png?alt=media" alt="Creating or associating controls with the AI for a requirement"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Dastra offers an AI assistance feature that makes it possible to:

* automatically identify **relevant existing controls**
* propose the **creation of new controls** when necessary

The AI relies on:

* the content of the requirement
* the context of the framework
* the controls already present in the Library
  {% endcolumn %}
  {% endcolumns %}

Controls created via AI can automatically include:

* their description
* their attachment to the requirement
* the associated tests

***

### Benefits of this approach

This approach makes it possible to achieve:

* a **progressive structuring** of the framework
* **intentional overlaps** between requirements
* the creation of cross-cutting controls covering several requirements
* a solid basis for risk management and compliance projects


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/en/features/compliance/library/frameworks/custom.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
