Connecting Linear lets you act on audit findings without leaving your existing engineering workflow. Once connected, you can push any finding from the Gaps & Edge Cases tab directly to your Linear workspace — either as a single issue for a specific finding, or as a parent issue with sub-issues grouping all related findings from the audit. Rationale pre-fills team, assignee, and labels so the issues land in the right place with the right context.Documentation Index
Fetch the complete documentation index at: https://doc.getrationale.app/llms.txt
Use this file to discover all available pages before exploring further.
What the Linear integration does
Push a single finding
Select one gap or edge case and create a single Linear issue scoped to that finding. Use this for one-off issues you want to track immediately.
Bundle the full audit
Push the entire audit as a parent issue plus sub-issues — one sub-issue per gap and uncovered edge case. Related findings stay grouped under one parent in Linear.
Pre-filled fields
Each push pre-fills the team, assignee, and labels. Rationale labels issues with the audit category — missing state, logic gap, edge case, or accessibility — and a version tag.
Re-sync on demand
Push the same audit again after changes and Rationale creates new sub-issues, updates existing ones, and resolves any that are no longer flagged.
What each Linear issue contains
Every issue Rationale creates includes:- The relevant screen name
- The category of finding (missing requirement, logic gap, edge case, or accessibility)
- The exact finding text from the audit
- A reference back to the Rationale project and version it came from
How to connect
How to push findings to Linear
Open a project with a completed audit
Open any project that has audit results. Go to the Gaps & Edge Cases tab.
Push a single finding or the full audit
To push a single finding, click the push icon next to any individual gap or edge case. To push the full audit, use the Push to Linear button at the top of the tab.
Set team, assignee, and cycle
In the push modal, choose the Linear team. Optionally select a project, cycle, and default assignee. You can also assign per screen if you want different owners for different areas.