Prompt File

The primary prompt document — format, data asset references, and template variables.

---

Format

The prompt file is a UTF-8 encoded Markdown document. Clients MUST pass the full content of this file to the agent as the initial user message (or system prompt, per client policy — see Execution Model).

---

Data Asset References

The prompt MAY reference data assets using paths relative to the archive root, enclosed in backticks or written as bare relative paths. Clients SHOULD resolve these references against the extracted archive directory and make the referenced files available to the agent (e.g., by including their content inline, providing file paths, or mounting them into the container).

Example Reference Syntax

Please analyse the sales data in `data/q1/north-region.csv` and compare
it against `data/q1/south-region.csv`.

The exact syntax for data asset references is non-normative. Clients MAY support additional reference syntaxes beyond backtick-enclosed paths.

---

Template Variables

Prompt files MAY include template variables using the syntax {{variable_name}}. Clients MAY substitute these at runtime.

Reserved Variables

The following variable names are RESERVED and have defined substitution values:

Variable	Substituted With
{{archive_name}}	The base filename of the archive (without extension).
{{extracted_path}}	Absolute path to the extracted archive root in the container.
{{timestamp}}	ISO 8601 UTC execution time.
{{agent}}	The agent identifier selected by the client.

Example Usage

# Task: {{archive_name}}

You are running at {{timestamp}} using {{agent}}.

Please analyse the sales data in `data/q1/north-region.csv` and write
your report to `{{extracted_path}}/output/report.md`.