Hops

Search documentation

Search pages by title, headings and content

Spec review

Engineering comments in place; Hops revises the spec and keeps a decision log.

Spec comments pile up, answers get lost, and decisions are forgotten by the next review. Hops turns each comment into a proposed edit, routes open questions and keeps a decision log.

What it does

  • Turns comments into edits. For each comment on the spec, Hops proposes one concrete edit.
  • Applies only what the PM accepts. Nothing changes in the spec without approval.
  • Keeps a decision log. A Table records decision, owner, date and status.
  • Routes open questions. Unanswered questions go to the person who can answer them, with a link to the comment.
  • Reads the spec where it lives. Hops works with Notion or Google Docs and links the Jira or Linear tickets.

Ask Hops

Copy a prompt into any chat with Hops, or mention @Hops in a Space.

Plain text
Review the comments on the Search filters spec and propose an edit for each.
Plain text
Apply the edits I accepted to the Acme search spec.
Plain text
Which open questions on the spec have no owner or answer?
Plain text
Add today's decisions to the decision log with owners.
Plain text
Show me the decision log for the Search filters spec.

Example reply:

Search filters spec review:

  • 4 comments turned into proposed edits, awaiting your approval.
  • 2 open questions routed to Alex Kim.
  • 3 entries added to the decision log.

What you get

  • A daily post. At 5pm, open questions and their owners are posted in the Space chat or your Slack channel.
  • An updated decision log. Decisions are added as rows to a decision log in Tables in the Space.
  • Answers on demand. Ask Hops to review new comments or apply accepted edits at any time.

Connections needed

Connect these apps. Each card opens Connections in the app.

Specs and comments (or Google Docs).

Specs and comments (or Notion).

Linked tickets (or Linear).

Linked tickets (or Jira).

Where open questions are routed.

Set it up

  1. Connect your apps

    Connect Notion or Google Docs, Jira or Linear, and Slack in Connections.

    See Connections.

  2. Create the Space

    Create a product-eng Space and pin the spec template and the current spec in Space context.

    See Spaces and Space context.

  3. Add the skill

    Give Hops these instructions:

    Plain text
    You run spec reviews. For each comment, propose one concrete edit. Apply only edits the PM accepts. Keep a decision log table: decision, owner, date, status. Route unanswered questions to the person who can answer them.

    See Build a skill.

  4. Schedule it

    Create an automation that runs every weekday at 5pm. It posts open spec questions with their owners to the Space and updates the decision log in Tables.

    See Automation.