Unreal Verse

Overview

Workflow

1. Classify the task.
2. Open the matching section in

   references/verse-doc-index.md

   .
3. Draft the smallest valid Verse solution first.
4. Verify effects (

   <suspends>

   ,

   <transacts>

   ,

   <decides>

   ), failure contexts, and container access.
5. Return code plus a short rationale tied to the referenced docs.

Minimal Common Patterns

Class With Mutable State

counter := class:
    var total:int = 0

    Add(value:int):void =
        set total += value

Failable Lookup (Option/Failure Context)

if (first := numbers[0]):
    Print("{first}")

Map Insert + Read

scores:[string]int = map{}
set scores["alice"] = 10

if (score := scores["alice"]):
    Print("{score}")

Basic Loop

for (n := 0..2):
    Print("{n}")

Suspending Function

DoLater()<suspends>:void =
    Sleep(1.0)

Race Two Tasks

winner := race:
    TaskA()
    TaskB()

Execution Rules

• Prefer explicit parameter and return types.
• Keep functions small and compose behavior from small helpers.
• Treat indexing and map reads as failable operations.
• Use specifiers/attributes only when needed and verify exact syntax in docs.
• Use

  race

  ,

  sync

  , and

  branch

  deliberately; always reason about cancellation and lifetime.
• Check language-version notes before using newer syntax in older projects.

Output Expectations

• Produce code that compiles conceptually against current Verse docs.
• Cite the specific Epic page used for non-trivial constructs.
• Keep examples minimal unless the user asks for full architecture.