Refine

From vague to bulletproof.

Refine is a technical refinement assistant that reads your codebase, analyzes attached screenshots and Loom videos, and conducts multi-turn Q&A until every ambiguity is resolved. The output: clear acceptance criteria, identified risks, dependencies, and a calibrated story point estimate with justification.

How it works

1

Reads everything

Issue title, description, all comments, attached images, Loom video transcripts, and actual source code in your connected repositories.

2

Asks targeted questions

Uses Linear's AgentSession API to ask one question at a time. No limit on rounds — thoroughness over speed.

3

Challenges assumptions

Proactively proposes better implementations and identifies risks based on your existing codebase patterns.

4

Delivers the spec

Outputs acceptance criteria, steps to reproduce (for bugs), risks and dependencies, documentation flags, and Fibonacci story point estimate (1-13) with justification.

Capabilities

Multi-turn Q&A

Asks questions one at a time inside Linear. Pauses and resumes across sessions — works naturally with async team workflows.

Loom Video Analysis

Automatically transcribes Loom recordings attached to issues. Extracts reproduction steps and context from video demos.

Screenshot & Image Analysis

Analyzes attached screenshots, mockups, and design references to understand visual requirements.

Codebase Traversal

Reads your actual source files, README, and docs to ground recommendations in your existing architecture.

Story Point Calibration

Estimates using Fibonacci scale (1-13) with written justification. Flags issues that should be split.

Risk Assessment

Identifies technical risks, missing dependencies, and potential blockers before development starts.

What you get

Refinement Output

Acceptance Criteria

  • API returns paginated results with cursor-based navigation
  • Rate limiting applied at 100 req/min per workspace
  • Error responses follow existing RFC 7807 format

Risks

  • !Migration requires backfilling 12k rows — needs off-peak scheduling
8 SP3 risks2 dependencies
Get Started