← ClaudeAtlas

ws-jira-conventionslisted

WS Agency Jira commit/branch/PR conventions. Use when working with Jira tickets, writing commits that reference issue keys (e.g. WSC-123), naming branches, or composing PR titles. Documents the project's Conventional Commits + Jira suffix format and Smart Commit syntax.
wsagency/WS-Claude-marketplace · ★ 0 · Code & Development · score 72
Install: claude install-skill wsagency/WS-Claude-marketplace
# WS Agency Jira Conventions How we link git activity to Jira at WS Agency. Aligns with Atlassian's official Smart Commits and dev-connector recognition rules. ## Branch naming ``` <TICKET-KEY>-<slugified-summary> ``` Examples: - `WSC-142-otp-screen` - `WSC-138-token-refresh-race` - `WSC-150-dark-mode-toggle` Ticket key first → Jira auto-detects via the GitHub/Bitbucket/Gitea dev connector. Key MUST be uppercase. ## Commit messages Format: **Conventional Commits + Jira suffix**. ``` <type>(<scope>): <imperative description> (<TICKET-KEY>) - optional body bullets Refs: <TICKET-KEY> ``` Examples: ``` feat(auth): add OTP screen for login (WSC-142) - validates 6-digit code - handles 30s resend timeout Refs: WSC-142 ``` ``` fix(api): handle expired token race (WSC-138) Refs: WSC-138 ``` Rules: - `type`: feat, fix, refactor, chore, docs, test, perf, style, build, ci - Subject ≤ 72 chars including ` (WSC-XXX)` suffix - Ticket key uppercase, in parens at end of subject - `Refs:` trailer at the end of the body (git-trailers convention) ## Smart Commits (optional record, not the mechanism) Since the jira-cli migration, worklogs/transitions/comments are applied by **explicit jira-cli calls** (`jira issue worklog add`, `jira issue move`, `jira issue comment add`) — the trailer below is a human-readable record in the commit body, included when `defaults.smart_commit_trailer: true` (default). ⚠️ If your Jira has an active dev-connector that ingests Smart Commits from th