core-story-delivery-and-commit-workflow

What problem does it solve?

Projects often produce large, unfocused branches and commits that are hard to review and trace back to backlog items, which slows delivery and reduces auditability. This Skill defines a disciplined, repeatable workflow so each backlog item becomes a small, reviewable, and traceable Git change.

Core Features & Use Cases

• Enforces one delivery branch per backlog item and clear branch naming for US-, HUS-, and BUG- work items.
• Installs and configures Git hooks and a commit template to validate Conventional Commits and require work-item IDs.
• Provides pre-commit checks that block generated or local-only artifacts and detect potential secret files.
• Defines pull request and review packet expectations, a pause/resume protocol for blocked stories, and guidance for draft PRs and review-ready transitions.
• Use case: an AI or developer opens a short-lived us/US-123 branch, makes focused commits validated by hooks, attaches a review packet, and opens a draft PR for early feedback.

Quick Start

Install the story workflow to set the commit template and enable the commit-msg and pre-commit hooks so commits require Conventional Commit formatting and work-item IDs.