GitHub

Context & docs

Ground your specs in the code that already exists

The quickest way to write a useless ticket is to describe something that already exists, or to name a module that does not. Connect GitHub, pin up to five repos, and Spectr reads the relevant code before drafting - so a story names your actual services and endpoints, and the estimate reflects what the change would really touch.

How GitHub fits in

Import your call. Let Spectr take over.

A call is imported from a note-taker (Fathom, Granola, Read.ai, or Fireflies.ai). Spectr picks out a requirement, a bug, an action item and an out-of-scope ask, reads GitHub, Notion, and Figma for context, and drafts a story and a bug with acceptance criteria. A person approves both, they are published to the team's tracker (Jira, Linear, or Shortcut), and the requirements, scope log and project memory update from the same call.

How it connects

OAuth App with the repo and read:org scopes. Spectr only uses them to read code and issues; it never pushes, opens pull requests, or comments.

Before you start

A GitHub account that can see the repositories you want read, private ones included. Up to five repositories can be pinned per project.

What Spectr reads from GitHub

Up to five pinned repositories
Chosen from your accessible repositories, sorted by recent activity. Private repositories are included when the authorising account can see them.
Relevant source files
Spectr searches for the code a discussion actually concerns and reads those files - up to 30,000 characters each - rather than sampling the tree at random. Search results themselves are never stored as context; only the files that got read.
Open issues
So a generated story can reference work already in flight instead of duplicating it.

Setting it up

  1. In Spectr, open the project and go to Integrations.

  2. Choose GitHub and click Connect, then authorise the OAuth app.

  3. Select up to five repositories to pin as project context.

  4. On your next spec sheet, open Context Gathered to see exactly which source files were read.

Frequently asked questions

Anything else? Email hello@crowdlinker.com and a person will answer.

Can Spectr push code or open pull requests?

No. GitHub is read-only context. Spectr reads code and issues to write better specs.

Does this work with private repositories?

Yes, for repositories the authorising GitHub account can already access.

Will I have to reconnect GitHub?

Standard GitHub OAuth tokens do not expire. They can be revoked - including automatically by GitHub if a token is ever exposed in a public repo - and if that happens, reconnect GitHub in the project's Integrations tab.

Related

Use case

Write user stories your developers can actually start

Draft stories with real acceptance criteria, then approve, edit or reject each one

See all 20 integrations →

AI ProductOps for the entire team.

Start for free at spectr.pm
  • Free plan
  • No credit card to sign up
  • 30-day free trial on Starter