Skip to content

Let bugfix start from a ticket key - #20

Merged
craigmbooth merged 1 commit into
mainfrom
feat/bugfix-takes-a-ticket-key
Aug 5, 2026
Merged

Let bugfix start from a ticket key#20
craigmbooth merged 1 commit into
mainfrom
feat/bugfix-takes-a-ticket-key

Conversation

@craigmbooth

Copy link
Copy Markdown
Collaborator

/colormath:bugfix CM-00012 now reads the ticket over MCP — description, type,
every comment, and the plans if it was groomed — instead of needing the report
pasted in. Prose, a stack trace and a path to a report file all behave exactly
as before; the skill branches on which of the three shapes it was handed.

Why

A bug is usually a ticket by the time somebody fixes it, and bugfix was the
odd one out: refine-ticket, implement-ticket, refine-initiative and
plan-initiative all take a key. The only way to hand bugfix a filed bug was
to copy the description out of the tracker — which silently drops the comment
thread, and that is where a filed bug's actual reproduction usually ends up.

So reading the thread is the point rather than a side effect: the skill is told
to read every comment, because the environment, the repro somebody finally
landed on, and the "it also happens when…" typically live there and not in the
description. What it must not do is treat a numbered ticket as more
authoritative than a pasted paragraph — step 1 ("find what's missing") applies
unchanged either way, and the text says so.

What changed

  • argument-hint names both forms.
  • allowed-tools gains mcp__abacus__get_ticket, list_boards,
    list_tickets and add_comment — the same read set refine-ticket carries,
    plus the comment write. A consumer with no abacus MCP server configured is
    unaffected: the pasted-report path never touches those tools.
  • The opening paragraph becomes a three-way "work out what you were handed",
    with the title-fragment fallback (list_boardslist_tickets, confirm
    which one you landed on) worded as refine-ticket words it.
  • A new rule closes the loop: a run that started from a ticket
    add_comments the outcome — PR link, merged or held, the cause, what it
    deliberately left alone — matching implement-ticket. It leaves the ticket's
    own fields and lane alone; the description is what was reported, the comment
    is what happened, and whether a bug is done is the filer's call.

Release

MINOR per LIFECYCLE.md — a new input shape with the old ones
unchanged. Notes are under ## Unreleased; no version stamped.

Markdown only: no gate, script, action, input or vendored file is touched, so
the self-hosted suite against example/ is unaffected.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NFTx8sFMcQPxn2RH8z4jDG

`/colormath:bugfix CM-00012` now reads the ticket over MCP instead of
needing the report pasted in. Prose, a stack trace and a path to a report
file behave exactly as before — the skill branches on which of the three
shapes it was handed.

A bug is usually a ticket by the time somebody fixes it, and `bugfix` was
the only key-shaped skill that could not take one: `refine-ticket`,
`implement-ticket`, `refine-initiative` and `plan-initiative` all do. The
workaround was copying the description out of the tracker, which silently
drops the comment thread — where a filed bug's actual reproduction
usually ends up. So the skill is told to read every comment, and told
that a numbered ticket is still evidence rather than a specification.

It also closes the loop, the way implement-ticket does: a run that
started from a ticket comments the outcome back on it and leaves the
ticket's own fields and lane alone.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NFTx8sFMcQPxn2RH8z4jDG
@craigmbooth
craigmbooth merged commit 430d729 into main Aug 5, 2026
17 checks passed
@craigmbooth
craigmbooth deleted the feat/bugfix-takes-a-ticket-key branch August 5, 2026 23:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant