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

# reasoning

> Contract, placement, related fields and source examples for this Nika YAML field.

[Language reference](/reference/language/overview) / `reasoning`

## Meaning and placement

### → run

The reasoning effort requested for every `infer:`/`agent:` task of the run (spec/01-envelope.md §run). Absent, each route keeps its own default, which may stay unknown.

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/properties/run/properties/reasoning` |
| type | `"object"` |
| additionalProperties | `false` |

**In the same object:** [access](/reference/language/words/access) · [clock](/reference/language/words/clock) · [entropy](/reference/language/words/entropy)

[Schema source (use the pointer above)](https://github.com/supernovae-st/nika-spec/blob/f3a952514b51ce884f42839c627bd88887fc941e/schemas/workflow.schema.json)

## Examples

No matching source-template occurrence is recorded in this projection. [Write a workflow](/guides/templates) or consult the schema declaration above.

## Contract and implementation

This page projects the named specification revision. Check [released engine status](/reference/status) and [the validation workflow](/guides/agent-authoring) before running a file. An optional field is not evidence that every engine supports every value.

Canonical identity: `language:word:reasoning`. Spec revision: [`f3a952514b51`](https://github.com/supernovae-st/nika-spec/tree/f3a952514b51ce884f42839c627bd88887fc941e).

[How documentation stays connected](/reference/knowledge-system).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.