Authoring Conventions

Use snake_case names

schema task_summary { ... }
agent summarize_task { ... }
model fast from llm { ... }

model fast from llm {
    id: "gpt-4.1-mini"
}

model smart from llm {
    id: "gpt-4.1"
}

The workflow can express why an agent uses a model without repeating provider-specific IDs everywhere.

Do not introduce multiple models, tools, prompts, resources, or MCP servers until the page is specifically explaining those features.

// This is a regular comment.

schema release_note {
    /// Field description preserved for schema-aware tooling.
    title: string
}