CtrlK
BlogDocsLog inGet started
Tessl Logo

matthew-a-carr/revise-spec

Revise a SPEC or EPIC PR based on review feedback and push an update. Use when a routine fires on a PR being labelled `ai:revise-now`, or when a user asks to "revise spec PR #NNN" / "revise epic PR #NNN" interactively. Non-interactive — reads every unresolved review comment + inline comment + the current SPEC/EPIC file, rewrites it, pushes to the same branch, and posts a one-line summary comment pointing at the diff.

88

1.47x
Quality

90%

Does it follow best practices?

Impact

81%

1.47x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

task.mdevals/scenario-2/

Spec Revision: Search Integration PR

Problem Description

A spec pull request for a full-text search integration (PR #17) has come back with review comments from multiple reviewers. The PR is on branch claude/spec-017-search. The comments include a direct contradiction between two reviewers on a performance target, a concrete architectural recommendation from the primary stakeholder, and a request that may conflict with the spec's stated non-goals.

Your job is to produce a revised spec and supporting revision documents that correctly handle all the feedback — including the conflict — according to the project's revision principles.

The input files are provided under inputs/:

  • inputs/SPEC-017-search.md — the current spec file
  • inputs/review_comments.json — the review comments (structured data representing what would be fetched from GitHub), with timestamps and authorship

Output Specification

Produce the following files in your working directory:

  1. SPEC-017-search-revised.md — the updated spec with all appropriate changes applied
  2. revision_plan.md — for each comment: the comment ID, classification, action taken, and reasoning
  3. pr_comment_summary.md — the full text of the top-level PR comment that would be posted, in the format used by the revise-spec workflow
  4. per_comment_replies.md — the reply text for each individual comment
  5. commit_message.txt — the exact commit message that would be used when pushing this revision

Work only from the files in inputs/. Treat the review_comments.json as the authoritative source of all feedback.

SKILL.md

tile.json