name: archive-ticket description: Complete commit workflow - format, archive, update changelog, and commit in one operation. allowed-tools: Bash user-invocable: false
Archive Ticket
Complete commit workflow after user approves implementation.
When to Use
Use this skill after user approves implementation. The script handles formatting, archiving, changelog, and commit.
IMPORTANT: Always use the script. Never manually move tickets or create changelogs.
Note: Archiving requires being on a named branch (not detached HEAD). The script will exit with an error if not on a branch.
Instructions
Run the bundled script with ticket path, commit message, repo URL, and optional description:
bash .claude/skills/archive-ticket/sh/archive.sh <ticket-path> <commit-message> <repo-url> [description] [files...]
Example:
bash .claude/skills/archive-ticket/sh/archive.sh \
.workaholic/tickets/todo/20260115-feature.md \
"Add new feature" \
https://github.com/org/repo \
"Enables users to authenticate with session-based login, addressing the need for secure access control." \
src/foo.ts src/bar.ts
Commit Message Rules
- NO prefixes - Do not use
[feat],[fix],feat:,fix:, etc. - Start with a present-tense verb (Add, Update, Fix, Remove, Refactor)
- Keep the title concise (50 characters or less)
- Focus on WHAT changed in the title
Examples
Add JSDoc comments to gateway exports
Update traceparent format with W3C spec
Fix session decryption to handle invalid tokens
Remove unused RegisterTool type after consolidation
Description Rules
The optional description parameter captures the WHY behind the change:
- 1-2 sentences explaining the motivation or problem being solved
- Extract from the ticket's Overview section
- Appears as a second line in CHANGELOG entries
- Used by
/reportto generate comprehensive PR descriptions
Example
"Enables users to authenticate with session-based login, addressing the need for secure access control."
File Locations
The script manages two separate locations:
- Tickets are archived to
.workaholic/tickets/archive/<branch>/ - Changelogs are written to
.workaholic/changelogs/<branch>.md
This separation keeps change requests (tickets) distinct from change summaries (changelogs).
CHANGELOG Format
Entries are automatically categorized based on commit verb and include optional descriptions:
Categorization
- Added: Add, Create, Implement, Introduce
- Changed: Update, Fix, Refactor (default)
- Removed: Remove, Delete
Entry Format
- Commit title ([hash](url)) - [ticket](file.md)
Description explaining why this change was made.
The description line is optional but recommended for generating comprehensive PR summaries.