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

# file

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

[Language reference](/reference/language/overview.md) / `file`

## Meaning and placement

### promptText · oneOf · 1

The project file whose text is the field's value · relative to the workflow file that names it.

| Property | Declaration |
| - | - |
| Requirement | Required in this object |
| Schema location | `/$defs/promptText/oneOf/1/properties/file` |
| type | `"string"` |
| minLength | `1` |

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

### schemaContract · oneOf · 0

The project file holding the schema · relative to the workflow file that names it.

| Property | Declaration |
| - | - |
| Requirement | Required in this object |
| Schema location | `/$defs/schemaContract/oneOf/0/properties/file` |
| type | `"string"` |
| minLength | `1` |

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

## Examples

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

## Contract and implementation

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

Canonical identity: `language:word:file`. Spec revision: [`a4796d976534`](https://github.com/supernovae-st/nika-spec/tree/a4796d976534bddb28562df157ac2afcaadd787c).

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


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