commit-story-generator — turn git commits into adventure stories + engineering release notes

This is a submission for the GitHub Copilot CLI Challenge

What I Built

I built commit-story-generator, a cross-platform CLI that turns git commit history into two copy/paste-ready narratives:

• Adventure style (release story with chapters)
• Engineering style (PR/release summary with risk/validation/rollback)

It can also emit a categorized changelog (feat/fix/refactor/docs/test/chore) and basic stats.

Repo: https://github.com/aisamposhen/commit-story-generator

Demo

Reproducible 90-second demo (no git needed):

pip install -e .[test]

story template
story generate --fixture --style adventure --format md --dry-run
story release-notes --fixture --format md --dry-run
story changelog --fixture --format md --dry-run
story stats --fixture --format md --dry-run

My Experience with GitHub Copilot CLI

I used Copilot CLI as a terminal-first pair programmer to iterate module-by-module:

• A robust git log reader (using record/field separators to avoid breaking on newlines)
• Parser + classifier (feat/fix/refactor/docs/test/chore)
• Story templates (adventure + engineering) with traceable short SHAs
• Markdown + JSON rendering
• Pytest coverage and CI matrix (Python 3.11 + 3.14)

The biggest win was tight feedback loops: prompt → run tests → refine behavior and UX.