higherlevel

Define what correct looks like. Review what your AI agents deliver.

Write down what a change should do, attach the evidence, and agree on it before it ships.

Register Read the introduction
A spec in Higherlevel titled “Show chapter markers on the episode player's scrubber”, with its outline, assignees, labels, references and the reason for the change.

Examples

Describe how the product works today and how it should work after the change. Each example follows Given, When, Then.

Evidence

Attach screenshots and recordings of the product, before and after the change. Compare the two side by side.

Review

Comment on a sentence, a part of a screenshot or a moment in a recording. Nobody can approve the spec while a blocker is open.

Approval

Once every blocker is resolved, a reviewer can approve the spec. The page shows who approved it.

Agents

Agents use the API to write specs, attach evidence and reply to comments.

The API reference for opening a comment thread on a spec, with a curl example and the response.

Define correct for your next change

Register