commit-narrator

Write commit messages that say why, not just what.

TL;DR: git add -p && /commit-narrator → a conventional-commit message with a real rationale, not "fix stuff".

Writing

LinkedIn

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems.
• 📄 LinkedIn Articles — All published articles
• 📊 LinkedIn Documents — Research papers and technical documents

Dev.to

• Why AI Agents Fail?
• We Ship to Production Without Tests. Here's How It Destroyed Us.
• I built a product in one AI session. Here's the system that made it ship right.
• Remote Work Didn't Break Productivity — It Broke Human Connection
• Hermes vs OpenClaw: Which AI assistant would you actually trust?
• Strategic LLM Adoption: A Director's Guide to Fine-Tuning Models
• The Context Window Lie: Why Your LLM Remembers Nothing
• Stop Your AI Agent From Building Tools That Already Exist
• Why Versioned SQL Beats Vector RAG for Agent Memory Systems
• I Got Access to 136 AI Models for Free — NVIDIA NIM API Deep Dive
• Your Agent Isn't Reflecting. It's Performing Reflection.
• How I Stopped My AI Agent From Reinventing the Wheel

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Install (Claude Code)

git clone https://github.com/mturac/pluginpool-commit-narrator ~/.claude/plugins/commit-narrator

Restart Claude Code; the slash command /commit-narrator appears.

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Quick start

git add -p
/commit-narrator

Or invoke the helper directly:

git diff --staged | python3 scripts/narrate.py --diff -
python3 scripts/narrate.py --format json

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Flags

Flag	Default	Description
--diff PATH / -	git diff --cached	Read diff from path or stdin
--format	text	text or json

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Example output

feat(api): add login throttle

Changed files:
- src/api/auth.py
- tests/test_auth.py

Throttle prevents brute-force enumeration on the /login endpoint by
rate-limiting on (ip, email) — the abuse pattern surfaced in the
2026-Q2 incident review.

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

How it works

1. Reads the staged diff (or a path you give it).
2. Classifies the change type — feat / fix / refactor / docs / test / chore / perf — using path patterns and patch-hunk heuristics.
3. Derives a scope from the most-touched top-level directory.
4. Emits a conventional-commit subject plus a body listing changed files and a placeholder WHY line.
5. Claude reads the helper's output and the diff, then replaces the placeholder with rationale that the diff actually supports.

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Limitations

• Heuristics are intentionally conservative. You'll get chore for messy mixed diffs — that's a signal to split the commit, not a bug.
• The helper itself never calls a network service; only the slash command's Claude pass adds language.

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Examples

Step-by-step walkthroughs with real input fixtures and the helper's actual output live in examples/. Three or four scenarios per plugin — from the happy path to the edge cases the test suite guards.

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

Part of the pluginpool family

Ten focused Claude Code plugins for everyday productivity: commit-narrator · pr-storyteller · test-gap · deps-doctor · env-lint · secret-guard · standup-gen · todo-harvest · flaky-detector · changelog-forge

Writing

• ✍️ Dev.to · TuracTheThinker — Technical articles on AI, agentic systems, and production engineering

• 📄 LinkedIn Articles — Industry insights and analysis

• 📊 LinkedIn Documents — Research papers and technical documents

• 🗡️ Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)

License

MIT — see LICENSE. Contributions welcome.