Skip to main content
A spec is a generated, plain-language description of what your agents are supposed to do. It’s the rubric Glassray judges your traces against when it looks for deviations.

​
Where a spec comes from

Glassray builds the spec from your code. You provide that intent one of two ways:
  • Connect GitHub and Glassray reads your repo and generates the spec (about 3–5 minutes).
  • Bring your own spec (below) - generate it yourself and import the finished markdown.
A spec is tied to a repository and branch. You can generate new specs as your code changes; older specs stay as history.

​
Bring your own spec

If you’d rather not connect your repository, produce the spec yourself and import it:

Generate the spec

Write it, or have your own coding agent generate it from your code.

Import it

On the Deviations page, choose Import spec, paste the finished spec markdown, and enter your repo name (owner/repo).

Ready to use

Glassray saves it as a ready spec - no generation step - and can immediately find deviations against it.

​
What it’s used for

Finds deviations

Glassray scans your traces against the spec and surfaces recurring deviations.

Readable anywhere

Read the spec in the dashboard, or over the MCP server with get_spec and list_specs.
No spec yet? Connect GitHub and Glassray generates one for you.