align-ticket-with-implementation

Revises issue ticket acceptance criteria to match the current branch's implementation.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill align-ticket-with-implementation-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: align-ticket-with-implementation
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/align-ticket-with-implementation
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill align-ticket-with-implementation-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementing work on a branch, the original issue ticket often no longer reflects what the code actually does. This Skill produces or revises a ticket (GitHub issue, Jira issue, or local artifact) so its acceptance criteria accurately describe the branch's implementation, keeping the record of work consistent. ## Core Features & Use Cases - Two operating branches: Generates a full ticket from the implementation when no prior ticket exists, or aligns only the acceptance criteria of an existing ticket while reproducing its problem, context, and proposed solution verbatim. - Ratified-delta and spike modes: Applies a caller-supplied, user-approved delta exactly as given, or reconciles spike investigations against their questions instead of acceptance criteria. - Dual write targets: Writes the ticket of record on its remote platform and saves a local ticket artifact with universal frontmatter, with --write-target=remote|local control. - Use Case: After finishing a bug-fix branch, run the Skill to diff against the default branch, update the linked GitHub issue's acceptance criteria to match what was actually fixed, and save a timestamped local ticket artifact. ## Quick Start Ask the agent to align the current branch's ticket with its implementation, optionally passing --write-target=local to update only the local artifact.

Frequently Asked Questions about align-ticket-with-implementation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a GitHub issue to match my branch's implementation?

Invoke the Skill on your branch; it diffs the default branch against HEAD, revises only the acceptance criteria of the existing ticket, and writes the update to the remote issue. Problem, context, and proposed solution sections are reproduced verbatim from the source ticket.

What happens when no prior ticket exists for the branch?

The Skill switches to generation mode and authors every section from the implementation itself. The proposed solution section records the approach the branch actually took rather than a forward-looking proposal, and no remote ticket is written.

Can I update only the local ticket artifact without touching the remote issue?

Yes, pass --write-target=local to save only the local ticket artifact and leave the ticket of record unchanged. The mode constraints and confirmation steps still apply to the revision itself.

Does the Skill rewrite the whole ticket when implementation diverges from the proposal?

No, alignment revises acceptance criteria alone because they are the only contract an implementation can falsify. Divergence between implementation and proposal belongs in the pull-request description, not in ticket edits.

What is ratified-delta mode and when is it used?

Ratified-delta mode applies when the caller supplies a delta the user has already approved, such as a review's proposed-edit preview. The Skill applies exactly those lines, reproduces everything else verbatim, and stops if it finds changes outside the delta.