Files
msd-core/get-shit-done/references/git-planning-commit.md
Lex Christopherson 24b933e018 fix: rename gsd-tools.js to .cjs to prevent ESM conflicts (closes #495)
Projects with "type": "module" in package.json cause Node to treat
gsd-tools.js as ESM, crashing on require(). The .cjs extension forces
CommonJS regardless of the host project's module configuration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 11:03:22 -06:00

1.4 KiB

Git Planning Commit

Commit planning artifacts using the gsd-tools CLI, which automatically checks commit_docs config and gitignore status.

Commit via CLI

Always use gsd-tools.cjs commit for .planning/ files — it handles commit_docs and gitignore checks automatically:

node ~/.claude/get-shit-done/bin/gsd-tools.cjs commit "docs({scope}): {description}" --files .planning/STATE.md .planning/ROADMAP.md

The CLI will return skipped (with reason) if commit_docs is false or .planning/ is gitignored. No manual conditional checks needed.

Amend previous commit

To fold .planning/ file changes into the previous commit:

node ~/.claude/get-shit-done/bin/gsd-tools.cjs commit "" --files .planning/codebase/*.md --amend

Commit Message Patterns

Command Scope Example
plan-phase phase docs(phase-03): create authentication plans
execute-phase phase docs(phase-03): complete authentication phase
new-milestone milestone docs: start milestone v1.1
remove-phase chore chore: remove phase 17 (dashboard)
insert-phase phase docs: insert phase 16.1 (critical fix)
add-phase phase docs: add phase 07 (settings page)

When to Skip

  • commit_docs: false in config
  • .planning/ is gitignored
  • No changes to commit (check with git status --porcelain .planning/)