<h1>Spades User Guide</h1><p>Spades is a modern pointing poker application that integrates with Linear to help development teams estimate story points through real-time collaborative voting sessions.</p><h2>Getting Started</h2><h3>What is Spades?</h3><p>Spades enables development teams to:</p><ul class="accent-bullets"><li><p><strong>Import unestimated issues</strong> directly from Linear workspace</p></li><li><p><strong>Collaborate in real-time</strong> through voting sessions using Fibonacci sequence</p></li><li><p><strong>Get smart analytics</strong> with automatic calculation of median, average, highest and lowest votes</p></li><li><p><strong>Set estimates directly in Linear</strong> with one click after reaching consensus</p></li></ul><h3>First Steps</h3><ol class="steps-list"><li><p><strong>Login with Linear</strong>: Connect your Linear account to access your workspace issues</p></li><li><p><strong>Select a Team/View</strong>: Use the dropdown that appears to choose your team or favorite Linear view</p></li><li><p><strong>Invite the Team</strong>: Share the URL that is generated with your team members</p></li><li><p><strong>Start Voting</strong>: Once issues load, team members can begin estimating using the voting buttons or keyboard shortcuts</p></li><li><p><strong>Set Estimates</strong>: After voting concludes, click on the calculated results to set the estimate in Linear</p></li></ol><h3>Team Collaboration</h3><ul class="accent-bullets"><li><p><strong>Share the Round URL</strong>: Send the session URL to teammates so they can join the same voting session</p></li><li><p><strong>Real-time Sync</strong>: All votes and navigation updates sync instantly across all participants</p></li><li><p><strong>Anonymous Participation</strong>: Team members can participate without Linear accounts in anonymous mode</p></li></ul><hr><h2>Keyboard Shortcuts &amp; Command Bar</h2><p>Spades offers powerful keyboard shortcuts to streamline your estimation workflow.</p><h3>Command Bar Access</h3><p><strong>Primary Shortcut</strong>: <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Cmd+K</code> (Mac) / <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+K</code> (Windows/Linux)</p><p>The command bar provides quick access to all major functions and shows available shortcuts.</p><h3>Navigation Shortcuts</h3><table style="min-width: 75px"><colgroup><col style="min-width: 25px"><col style="min-width: 25px"><col style="min-width: 25px"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Shortcut</p></th><th colspan="1" rowspan="1"><p>Action</p></th><th colspan="1" rowspan="1"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">J</code></p></td><td colspan="1" rowspan="1"><p>Previous Issue</p></td><td colspan="1" rowspan="1"><p>Navigate to the previous issue in the current view</p></td></tr><tr><td colspan="1" rowspan="1"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">K</code></p></td><td colspan="1" rowspan="1"><p>Next Issue</p></td><td colspan="1" rowspan="1"><p>Navigate to the next issue in the current view</p></td></tr><tr><td colspan="1" rowspan="1"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Cmd+G</code> / <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+G</code></p></td><td colspan="1" rowspan="1"><p>Select Team/View</p></td><td colspan="1" rowspan="1"><p>Open the team/view selection dropdown</p></td></tr></tbody></table><h3>Voting Shortcuts</h3><table style="min-width: 179px"><colgroup><col style="width: 129px"><col style="min-width: 25px"><col style="min-width: 25px"></colgroup><tbody><tr><th colspan="1" rowspan="1" colwidth="129"><p>Shortcut</p></th><th colspan="1" rowspan="1"><p>Action</p></th><th colspan="1" rowspan="1"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" colwidth="129"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+1</code></p></td><td colspan="1" rowspan="1"><p>Vote 1</p></td><td colspan="1" rowspan="1"><p>Submit estimate of 1 story point</p></td></tr><tr><td colspan="1" rowspan="1" colwidth="129"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+2</code></p></td><td colspan="1" rowspan="1"><p>Vote 2</p></td><td colspan="1" rowspan="1"><p>Submit estimate of 2 story points</p></td></tr><tr><td colspan="1" rowspan="1" colwidth="129"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+3</code></p></td><td colspan="1" rowspan="1"><p>Vote 3</p></td><td colspan="1" rowspan="1"><p>Submit estimate of 3 story points</p></td></tr><tr><td colspan="1" rowspan="1" colwidth="129"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+5</code></p></td><td colspan="1" rowspan="1"><p>Vote 5</p></td><td colspan="1" rowspan="1"><p>Submit estimate of 5 story points</p></td></tr><tr><td colspan="1" rowspan="1" colwidth="129"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+8</code></p></td><td colspan="1" rowspan="1"><p>Vote 8</p></td><td colspan="1" rowspan="1"><p>Submit estimate of 8 story points</p></td></tr></tbody></table><h3>Utility Shortcuts</h3><table style="min-width: 75px"><colgroup><col style="min-width: 25px"><col style="min-width: 25px"><col style="min-width: 25px"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Shortcut</p></th><th colspan="1" rowspan="1"><p>Action</p></th><th colspan="1" rowspan="1"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">?</code></p></td><td colspan="1" rowspan="1"><p>Show Help</p></td><td colspan="1" rowspan="1"><p>Display the help dialog with tips and shortcuts</p></td></tr><tr><td colspan="1" rowspan="1"><p><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Cmd+E</code> / <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+E</code></p></td><td colspan="1" rowspan="1"><p>Update Profile</p></td><td colspan="1" rowspan="1"><p>Open profile settings dialog</p></td></tr></tbody></table><h3>Smart Context Awareness</h3><ul class="accent-bullets"><li><p>Shortcuts are automatically disabled when typing in text fields or dialogs</p></li><li><p>The system detects your operating system and shows appropriate key symbols (⌘ for Mac, Ctrl for Windows/Linux)</p></li></ul><hr><h2>Issue Navigation &amp; View Selection</h2><h3>Team and View Selection</h3><p><strong>Access Method</strong>: Click the search icon in the top-right corner or press <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Cmd+G</code> / <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+G</code></p><h4>Available Options:</h4><ol class="steps-list"><li><p><strong>Teams</strong>: Select from your Linear teams to view all unestimated issues for that team</p></li><li><p><strong>Views</strong>: Choose from your favorite Linear views to filter issues based on custom criteria</p></li><li><p><strong>Projects</strong>: Browse issues from favorited Linear projects</p></li></ol><h4>Selection Behavior:</h4><ul class="accent-bullets"><li><p>Selecting a new option clears the current issue list and loads fresh data</p></li><li><p>Only one selection can be active at a time (team, view, or project)</p></li><li><p>The dropdown shows your current selection or "Select View" if none is active</p></li></ul><h3>Issue Navigation Controls</h3><h4>Automatic Navigation:</h4><ul class="accent-bullets"><li><p>Issues are displayed one at a time in a focused estimation interface</p></li><li><p>Navigate between issues using keyboard shortcuts (<code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">J</code>/<code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">K</code>) or navigation arrows</p></li></ul><h4>Issue Information Display:</h4><ul class="accent-bullets"><li><p><strong>Title</strong>: Clear issue title from Linear</p></li><li><p><strong>Description</strong>: Full issue description with markdown formatting</p></li><li><p><strong>Comments</strong>: Linear comments displayed below the issue description</p></li></ul><hr><h2>Estimation &amp; Voting Workflow</h2><h3>Fibonacci Sequence Voting</h3><p>Spades uses the Fibonacci sequence for story point estimation: <strong>1, 2, 3, 5, 8</strong></p><h4>Voting Process:</h4><ol class="steps-list"><li><p><strong>Individual Voting</strong>: Each team member selects their estimate without seeing others' votes</p></li><li><p><strong>Vote Collection</strong>: Votes are collected in real-time as participants submit estimates</p></li><li><p><strong>Results Calculation</strong>: Once all expected votes are in, results are automatically calculated</p></li><li><p><strong>Estimate Setting</strong>: Click on any result to set that value as the official estimate in Linear</p></li></ol><h3>Voting Options</h3><h4>Standard Fibonacci Values:</h4><ul class="accent-bullets"><li><p><strong>1-8 Points</strong>: Use the standard Fibonacci sequence for complexity estimation</p></li><li><p><strong>Abstain</strong>: Choose to abstain from voting on a particular issue</p></li></ul><h4>Voting Methods:</h4><ul class="accent-bullets"><li><p><strong>Click Buttons</strong>: Use the estimate buttons in the interface</p></li><li><p><strong>Keyboard Shortcuts</strong>: Press <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">Ctrl+[number]</code> for quick voting</p></li></ul><h3>Results Analysis</h3><p>After all votes are collected, Spades automatically calculates:</p><ul class="accent-bullets"><li><p><strong>Lowest Vote</strong>: The minimum estimate from all participants</p></li><li><p><strong>Median Vote</strong>: The middle value when votes are sorted</p></li><li><p><strong>Average Vote</strong>: The mathematical average of all votes (rounded to nearest integer)</p></li><li><p><strong>Highest Vote</strong>: The maximum estimate from all participants</p></li></ul><h4>Setting Estimates in Linear:</h4><ol class="steps-list"><li><p><strong>Review Results</strong>: Examine the calculated statistics</p></li><li><p><strong>Team Discussion</strong>: Discuss any significant variance in estimates</p></li><li><p><strong>Choose Final Estimate</strong>: Click on one of the result cards (Lowest, Median, Average, or Highest)</p></li><li><p><strong>Automatic Fibonacci Rounding</strong>: The selected value is automatically rounded to the nearest Fibonacci number</p></li><li><p><strong>Linear Update</strong>: The estimate is immediately set in Linear</p></li></ol><h3>Team Participation Tracking</h3><ul class="accent-bullets"><li><p><strong>Expected Votes</strong>: The system tracks how many team members are expected to vote</p></li><li><p><strong>Vote Progress</strong>: Real-time display of voting progress (e.g., "3 of 5 votes collected")</p></li><li><p><strong>Completion Status</strong>: Clear indication when all votes are collected and results are ready</p></li></ul><hr><h2>Linear Integration Features</h2><h3>Authentication &amp; Access</h3><ul class="accent-bullets"><li><p><strong>OAuth Integration</strong>: Secure login through Linear OAuth</p></li><li><p><strong>Workspace Access</strong>: Automatic access to your Linear workspace data</p></li></ul><h3>Issue Management</h3><h4>Import Capabilities:</h4><ul class="accent-bullets"><li><p><strong>Unestimated Issues</strong>: Automatically filters for issues without story point estimates</p></li><li><p><strong>Team Issues</strong>: Access issues assigned to specific Linear teams</p></li><li><p><strong>View Filtering</strong>: Use Linear saved views to filter issues by custom criteria</p></li><li><p><strong>Project Issues</strong>: Browse issues within specific Linear projects</p></li></ul><h4>Issue Display:</h4><ul class="accent-bullets"><li><p><strong>Complete Metadata</strong>: Issue title, description, assignees, and status (hover over issue title)</p></li><li><p><strong>Rich Text Support</strong>: Markdown rendering for issue descriptions</p></li><li><p><strong>Comment Integration</strong>: Display Linear comments within the estimation interface</p></li><li><p><strong>Real-time Sync</strong>: Updates reflect immediately in Linear</p></li></ul><h3>Estimate Setting</h3><h4>Direct Integration:</h4><ul class="accent-bullets"><li><p><strong>One-Click Updates</strong>: Set estimates directly in Linear from Spades results</p></li><li><p><strong>Fibonacci Compliance</strong>: Automatic rounding to valid Fibonacci values</p></li><li><p><strong>Immediate Sync</strong>: Estimates appear in Linear instantly</p></li></ul><h3>Workspace Features</h3><h4>Multi-Team Support:</h4><ul class="accent-bullets"><li><p><strong>Team Navigation</strong>: Switch between different Linear teams</p></li><li><p><strong>View Management</strong>: Access all your saved Linear views</p></li><li><p><strong>Project Organization</strong>: Browse issues by Linear projects</p></li></ul><h4>Real-time Collaboration:</h4><ul class="accent-bullets"><li><p><strong>Live Updates</strong>: Changes sync across all participants in real-time</p></li><li><p><strong>Shared Sessions</strong>: Multiple team members can join the same estimation session</p></li><li><p><strong>Automatic Refresh</strong>: Issue data updates automatically as changes occur in Linear</p></li></ul><p></p>

User Guide

Full Overview

Quick Start Guide

User Management

Troubleshooting

Next Steps

Linear Integration

AI Integration

Voting and Estimation

Voting

Keyboard Shortcuts

Productivity

Summary

Voting Best Practices

Team Best Practices

Best Practices

Docs

Spades