> For the complete documentation index, see [llms.txt](https://docs.therisk.global/organization/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.therisk.global/organization/operations/frameworks/nexus-agile-framework-naf.md).

# Nexus Agile Framework (NAF)

Nexus Agile Framework (NAF) for public-good governance, standards, lifecycle, portfolios, software, data, AI, compute, intelligence, and lawful handoff.

**Where this fits:** all six sectors · [Foundry](/organization/programme/foundry.md) · GCRI (technical office), under the Nexus Consortium · readiness preparation and the controlled build (G2 to G3), with closeout and correction · systems [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md) · framework page (NAF).

**In brief.** Nexus Agile Framework (NAF) is the operating framework for public-good systems delivery. This page belongs to the Nexus Agile Framework (NAF), read as the delivery method of the Foundry pillar: how the systems are specified, built, verified and handed on through the programme year, from signal to record, from record to evidence and from evidence to controlled release. A configured or simulated capability is not a validated result, and a National Portfolio entry is not an investment decision; a lawful handoff prepares a decision, it never makes one. The method aligns with international practice ([Beck et al. 2001](https://agilemanifesto.org/); [OMG 2011](https://www.omg.org/spec/BPMN/2.0/)).

{% hint style="info" %}
**Read with the current model (21 October 2026).** NAF is read as the method of the [Foundry pillar](/organization/programme/foundry.md), the pillar that builds, simulates and prepares, and of the [twenty systems](/organization/systems.md) it works on. System names follow the [Nexus Standards](/organization/institutions/nexus-standards.md) display codes: `GRIx` is NXS-GRX (risk data, provenance and federation), `Nexus Studio` is NXS-STU, `Nexus Rails` is NXS-RLS, and `Nexus Labs` is the Labs pillar with NXS-LAB. Technology readiness follows ISO 16290, which defines nine levels; level 10 in this framework is a Nexus extended record, not an ISO level ([ISO 2013](https://www.iso.org/standard/56064.html)). Marketplace, licensing and capital-facing sections are design text: the programme forms, arranges and advises on no transaction ([Lawful handoffs](/organization/finance-readiness/lawful-handoffs.md)). Delivery follows the gates of [the programme year](/organization/programme/the-programme-year.md).
{% endhint %}

### Overview

Nexus Agile Framework (NAF) is the operating framework for public-good systems delivery. It organizes governance, standards, lifecycle management, portfolios, people, software, data, AI, compute, intelligence, and lawful handoff across Nexus.

NAF helps teams move from signal to record, from record to evidence, and from evidence to controlled release. It keeps work traceable, reviewable, nationally grounded, and correctionable.

### What NAF does

* Defines the rules, roles, and boundaries for Nexus delivery.
* Connects research, production, reporting, intelligence, and readiness into one operating model.
* Prepares lawful handoff without implying approval, procurement, finance, or execution.

### Core themes

* **Governed delivery** - Every output moves through records, review, status, and correction.
* **Public-good discipline** - NAF separates learning, evidence, readiness, and handoff from execution.
* **National-to-global coordination** - NAF supports national ownership with regional and global interoperability.

### Explore NAF

* [I. FOUNDATIONS](/organization/operations/frameworks/nexus-agile-framework-naf/i.-foundations.md) - Defines the identity, doctrine, and constitutional rules of NAF. It sets non-execution, validity by record, correctionability, and public-good boundaries.
* [II. SYSTEMS](/organization/operations/frameworks/nexus-agile-framework-naf/ii.-systems.md) - Maps the Nexus system, institutions, layers, and interfaces. It clarifies how the public-good stack and enterprise stack stay separate.
* [III. STANDARDS](/organization/operations/frameworks/nexus-agile-framework-naf/iii.-standards.md) - Explains how NAF stays standards-aware without claiming standards authority. It covers interoperability, controlled mappings, and conformance questions.
* [IV. LIFECYCLE](/organization/operations/frameworks/nexus-agile-framework-naf/iv.-lifecycle.md) - Shows how work moves from signal to archive through intake, triage, routing, release, correction, and retention.
* [V. PORTFOLIOS](/organization/operations/frameworks/nexus-agile-framework-naf/v.-portfolios.md) - Organizes work across global, regional, national, thematic, sector, and technology portfolios. It links priorities to national ownership and readiness.
* [VI. PEOPLE](/organization/operations/frameworks/nexus-agile-framework-naf/vi.-people.md) - Defines contributors, teams, cells, guilds, and participation roles. It sets labor boundaries and collaboration rules.
* [VII. FOUNDRY](/organization/operations/frameworks/nexus-agile-framework-naf/vii.-foundry.md) - Covers quests, bounties, builds, maintainers, and quality gates. It is the production engine for reusable public-good outputs.
* [VIII. R\&D](/organization/operations/frameworks/nexus-agile-framework-naf/viii.-r-and-d.md) - Connects research, testbeds, and frontier methods to delivery. It turns discovery into builds, reports, and handoff context.
* [IX. SOFTWARE](/organization/operations/frameworks/nexus-agile-framework-naf/ix.-software.md) - Governs public-good software, repositories, APIs, release discipline, and support classes. It keeps software reusable without implying deployment or warranty.
* [X. DATA](/organization/operations/frameworks/nexus-agile-framework-naf/x.-data.md) - Defines DICE, data commons, metadata, lineage, rights, and secure data workflows. It sets the rules for governed data operations.
* [XI. AI](/organization/operations/frameworks/nexus-agile-framework-naf/xi.-ai.md) - Governs AI systems, model cards, agentic workflows, human oversight, and AI safety controls. It keeps AI useful, bounded, and reviewable.
* [XII. COMPUTE](/organization/operations/frameworks/nexus-agile-framework-naf/xii.-compute.md) - Covers cloud, edge, HPC, sovereign compute, networking, and resilience. It explains infrastructure readiness without implying operational authority.
* [XIII. INTELLIGENCE](/organization/operations/frameworks/nexus-agile-framework-naf/xiii.-intelligence.md) - Structures risk meaning through NXS-GRX, DRI, and the Nexus Observatory. It turns signals into governed intelligence without becoming warnings or ratings.
* [XIV. STUDIO](/organization/operations/frameworks/nexus-agile-framework-naf/xiv.-studio.md) - Provides controlled runtime for dashboards, simulations, digital twins, AI review, and secure workflows. It supports learning and demonstrations without becoming deployment.
* [XV. GRID](/organization/operations/frameworks/nexus-agile-framework-naf/xv.-grid.md) - Defines readiness, TRL 1–9 (ISO 16290) and the Nexus extended level 10, review routing, and assurance without certification. It records bounded maturity and support status.
* [XVI. REGISTRY](/organization/operations/frameworks/nexus-agile-framework-naf/xvi.-registry.md) - Governs Marketplace discovery and Registry status truth. It preserves lifecycle records, support status, correction, and archive.
* [XVII. REPORTS](/organization/operations/frameworks/nexus-agile-framework-naf/xvii.-reports.md) - Turns evidence into publications, public-safe reporting, and repository-ready knowledge products. It supports open science without creating authority by publication.
* [XVIII. ACADEMY](/organization/operations/frameworks/nexus-agile-framework-naf/xviii.-academy.md) - Builds capability through learning pathways, WILPs, micro-credentials, and workforce resilience. It links learning to contribution without implying professional licensing.
* [XIX. CAMPAIGNS](/organization/operations/frameworks/nexus-agile-framework-naf/xix.-campaigns.md) - Mobilizes signatures, pledges, volunteers, support, and public-safe storytelling. It activates participation without creating mandate or consent.
* [XX. UNIVERSE](/organization/operations/frameworks/nexus-agile-framework-naf/xx.-universe.md) - Concentrates the annual surge across arenas, rooms, builds, and national portfolios. It links year-round work to lawful handoff preparation.
* [XXI. AGENCY](/organization/operations/frameworks/nexus-agile-framework-naf/xxi.-agency.md) - Routes expertise through advisory support, risk translation, and bounded client interfaces. It supports decisions without becoming execution.
* [XXII. HANDOFF](/organization/operations/frameworks/nexus-agile-framework-naf/xxii.-handoff.md) - Defines lawful handoff, recipient responsibilities, procurement neutrality, and finance-readiness without finance. It transfers context, not authority.
* [XXIII. CONTROLS](/organization/operations/frameworks/nexus-agile-framework-naf/xxiii.-controls.md) - Establishes governance, safeguards, AI, security, privacy, incident response, correction, and archive discipline. It is the trust layer of NAF.
* [XXIV. DECLARATION](/organization/operations/frameworks/nexus-agile-framework-naf/xxiv.-declaration.md) - Sets the adoption model, templates, standard notices, and final no-conversion rule. It defines the final operating formula of NAF.

### Why it matters

NAF gives Nexus one operating language for complex public-good delivery. It keeps outputs traceable, interoperable, nationally grounded, and ready for lawful downstream use without collapsing into execution.

## Systems and pillars by page

| Page                                                                                                      | Pillars                                                                                                | Systems                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [I. FOUNDATIONS](/organization/operations/frameworks/nexus-agile-framework-naf/i.-foundations.md)         | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [II. SYSTEMS](/organization/operations/frameworks/nexus-agile-framework-naf/ii.-systems.md)               | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [III. STANDARDS](/organization/operations/frameworks/nexus-agile-framework-naf/iii.-standards.md)         | [Foundry](/organization/programme/foundry.md), [Nexus Standards](/organization/programme/standards.md) | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-GRX](/organization/systems/nxs-grx.md), [NXS-NSF](/organization/systems/nxs-nsf.md) |
| [IV. LIFECYCLE](/organization/operations/frameworks/nexus-agile-framework-naf/iv.-lifecycle.md)           | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [IX. SOFTWARE](/organization/operations/frameworks/nexus-agile-framework-naf/ix.-software.md)             | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [V. PORTFOLIOS](/organization/operations/frameworks/nexus-agile-framework-naf/v.-portfolios.md)           | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-POR](/organization/systems/nxs-por.md)                                              |
| [VI. PEOPLE](/organization/operations/frameworks/nexus-agile-framework-naf/vi.-people.md)                 | [Foundry](/organization/programme/foundry.md), [Risk Academy](/organization/programme/academy.md)      | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-HUB](/organization/systems/nxs-hub.md)                                              |
| [VII. FOUNDRY](/organization/operations/frameworks/nexus-agile-framework-naf/vii.-foundry.md)             | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [VIII. R\&D](/organization/operations/frameworks/nexus-agile-framework-naf/viii.-r-and-d.md)              | [Foundry](/organization/programme/foundry.md), [Labs](/organization/programme/labs.md)                 | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-LAB](/organization/systems/nxs-lab.md)                                              |
| [X. DATA](/organization/operations/frameworks/nexus-agile-framework-naf/x.-data.md)                       | [Foundry](/organization/programme/foundry.md), [Nexus Standards](/organization/programme/standards.md) | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-GRX](/organization/systems/nxs-grx.md)                                              |
| [XI. AI](/organization/operations/frameworks/nexus-agile-framework-naf/xi.-ai.md)                         | [Foundry](/organization/programme/foundry.md), [Labs](/organization/programme/labs.md)                 | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-LAB](/organization/systems/nxs-lab.md)                                              |
| [XII. COMPUTE](/organization/operations/frameworks/nexus-agile-framework-naf/xii.-compute.md)             | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-COR](/organization/systems/nxs-cor.md), [NXS-NET](/organization/systems/nxs-net.md) |
| [XIII. INTELLIGENCE](/organization/operations/frameworks/nexus-agile-framework-naf/xiii.-intelligence.md) | [Foundry](/organization/programme/foundry.md), [Nexus Universe](/organization/programme/universe.md)   | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-CMD](/organization/systems/nxs-cmd.md), [NXS-DSS](/organization/systems/nxs-dss.md) |
| [XIV. STUDIO](/organization/operations/frameworks/nexus-agile-framework-naf/xiv.-studio.md)               | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md)                                                                                           |
| [XIX. CAMPAIGNS](/organization/operations/frameworks/nexus-agile-framework-naf/xix.-campaigns.md)         | [Foundry](/organization/programme/foundry.md), [Nexus Universe](/organization/programme/universe.md)   | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-CMD](/organization/systems/nxs-cmd.md), [NXS-DSS](/organization/systems/nxs-dss.md) |
| [XV. GRID](/organization/operations/frameworks/nexus-agile-framework-naf/xv.-grid.md)                     | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-COR](/organization/systems/nxs-cor.md), [NXS-NET](/organization/systems/nxs-net.md) |
| [XVI. REGISTRY](/organization/operations/frameworks/nexus-agile-framework-naf/xvi.-registry.md)           | [Foundry](/organization/programme/foundry.md), [Nexus Standards](/organization/programme/standards.md) | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-GRX](/organization/systems/nxs-grx.md), [NXS-NSF](/organization/systems/nxs-nsf.md) |
| [XVII. REPORTS](/organization/operations/frameworks/nexus-agile-framework-naf/xvii.-reports.md)           | [Foundry](/organization/programme/foundry.md), [Nexus Reports](/organization/programme/reports.md)     | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-HUB](/organization/systems/nxs-hub.md)                                              |
| [XVIII. ACADEMY](/organization/operations/frameworks/nexus-agile-framework-naf/xviii.-academy.md)         | [Foundry](/organization/programme/foundry.md), [Risk Academy](/organization/programme/academy.md)      | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-HUB](/organization/systems/nxs-hub.md)                                              |
| [XX. UNIVERSE](/organization/operations/frameworks/nexus-agile-framework-naf/xx.-universe.md)             | [Foundry](/organization/programme/foundry.md), [Nexus Universe](/organization/programme/universe.md)   | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-CMD](/organization/systems/nxs-cmd.md), [NXS-DSS](/organization/systems/nxs-dss.md) |
| [XXI. AGENCY](/organization/operations/frameworks/nexus-agile-framework-naf/xxi.-agency.md)               | [Foundry](/organization/programme/foundry.md), [Nexus Universe](/organization/programme/universe.md)   | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-CMD](/organization/systems/nxs-cmd.md), [NXS-DSS](/organization/systems/nxs-dss.md) |
| [XXII. HANDOFF](/organization/operations/frameworks/nexus-agile-framework-naf/xxii.-handoff.md)           | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-RLS](/organization/systems/nxs-rls.md), [NXS-NSF](/organization/systems/nxs-nsf.md) |
| [XXIII. CONTROLS](/organization/operations/frameworks/nexus-agile-framework-naf/xxiii.-controls.md)       | [Foundry](/organization/programme/foundry.md)                                                          | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-RLS](/organization/systems/nxs-rls.md), [NXS-NSF](/organization/systems/nxs-nsf.md) |
| [XXIV. DECLARATION](/organization/operations/frameworks/nexus-agile-framework-naf/xxiv.-declaration.md)   | [Foundry](/organization/programme/foundry.md), [Nexus Standards](/organization/programme/standards.md) | [NXS-FAC](/organization/systems/nxs-fac.md), [NXS-STU](/organization/systems/nxs-stu.md), [NXS-NXQ](/organization/systems/nxs-nxq.md), [NXS-APP](/organization/systems/nxs-app.md), [NXS-GRX](/organization/systems/nxs-grx.md), [NXS-NSF](/organization/systems/nxs-nsf.md) |

## Sources

1. Beck, K. et al. (2001). Manifesto for Agile Software Development. [agilemanifesto.org](https://agilemanifesto.org/)
2. Object Management Group (2011). Business Process Model and Notation (BPMN), Version 2.0. Needham, MA: OMG. [www.omg.org/spec/BPMN/2.0](https://www.omg.org/spec/BPMN/2.0/)
3. ISO (2018). ISO 31000:2018 Risk management — Guidelines. Geneva: International Organization for Standardization. [www.iso.org/standard/65694.html](https://www.iso.org/standard/65694.html)
4. ISO (2013). ISO 16290:2013 Space systems — Definition of the Technology Readiness Levels (TRLs) and their criteria of assessment. Geneva: ISO. [www.iso.org/standard/56064.html](https://www.iso.org/standard/56064.html)

**Standards that apply.** Masters: [Communities, Learning and Contribution](https://nexustandards.com/communities/) (PLANNED); [Open Infrastructure and Developers](https://nexustandards.com/open-infrastructure/) (PLANNED). Standards: [NS-0](https://nexustandards.com/standards/ns-0/) (PROPOSED), [NS-1](https://nexustandards.com/standards/ns-1/) (PROPOSED), [NS-2](https://nexustandards.com/standards/ns-2/) (PROPOSED), [NS-3](https://nexustandards.com/standards/ns-3/) (PROPOSED), [NS-3b](https://nexustandards.com/standards/ns-3b/) (PROPOSED), [NS-4](https://nexustandards.com/standards/ns-4/) (PROPOSED), [NS-5](https://nexustandards.com/standards/ns-5/) (PROPOSED), [NS-8](https://nexustandards.com/standards/ns-8/) (PROPOSED), [NS-9](https://nexustandards.com/standards/ns-9/) (PROPOSED), [NS-10](https://nexustandards.com/standards/ns-10/) (PROPOSED), [NS-11](https://nexustandards.com/standards/ns-11/) (PROPOSED), [NS-12](https://nexustandards.com/standards/ns-12/) (PROPOSED), [NS-13](https://nexustandards.com/standards/ns-13/) (PROPOSED). Statuses are registry statuses on nexustandards.com, never adoption or certification.

**In the GitBook.** [Programme](/organization/programme.md) · [Governance in operation](/organization/governance-in-operation.md) · [Systems](/organization/systems.md) · [Reference](/organization/reference.md).


---

# 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://docs.therisk.global/organization/operations/frameworks/nexus-agile-framework-naf.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.
