Skip to content

crackingshells/writing-history

v1.0.0AGPL-3.0-or-later

Guides the git-discipline lifecycle for commit history: vocabulary, versioning, commits, and branch integration.

writing-history

Guides the full git-discipline lifecycle for a project's commit history, for both code and documents. Covers deriving a project-specific commit vocabulary from existing history, setting up commit conventions together with semantic versioning and changelog automation, authoring individual commits against that derived vocabulary, integrating finished branches via rebase-then-merge-with-no-ff, and conditionally cleaning up worktrees once integration is complete. Use when the user asks to set up commit or versioning conventions, derive or apply a commit vocabulary, author or draft a commit message, integrate or merge a branch, rebase work before merging, or clean up a git worktree after a feature lands — including cases mixing code changes with documentation changes.

Read SKILL.md at the source

Pinned to revision 6d6f6206132d, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.