Use case · Specs from vague issues

Vague ticket in.
Real spec out.

Label a fuzzy GitHub issue needs-spec. A fast model checks whether it’s actionable. If it isn’t, a stronger model drafts a spec with acceptance criteria and open questions, and after you approve it, the spec is posted back as a comment. No code and no repository needed.

GitHubacme/app#402Make exports betterneeds-spec
Pipeline
  1. Needs a spec? Claude API · haiku
  2. Draft spec Claude API · opus
  3. Review spec you
  4. Post comment gh issue comment
Commentacme/app#402Problem · Proposed behavior · Acceptance criteria · Open questionsPosted
Why it holds up

What the pipeline does for you

  • Leaves clear issues alone

    If the classifier says the issue is already actionable, every later step is skipped and nothing is posted.

  • Asks instead of inventing

    The prompt tells the model to list product decisions as open questions rather than make them up.

  • Read before it’s posted

    The approval step shows the full draft, rendered as Markdown. Reject it and nothing reaches the issue.

  • No repository needed

    It runs on the Claude API harness in an empty folder. The model has no tools or file access, which is exactly right for writing.

Set it up

Four steps, once

  1. Import the Spec writer pipeline JSON from the examples.
  2. Add a GitHub trigger on the needs-spec label.
  3. Make sure the GitHub CLI is signed in so it can comment.
  4. Label a vague issue.