msd-core/get-shit-done/references/git-planning-commit.md

Git Planning Commit

Check whether to commit planning artifacts, then commit if enabled.

Check Configuration

# Check config.json first
COMMIT_PLANNING_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")

# Auto-detect gitignored (overrides config)
git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false

Default: true if not set or config missing.

Conditional Commit

Only run git operations if COMMIT_PLANNING_DOCS=true:

if [ "$COMMIT_PLANNING_DOCS" = "true" ]; then
  git add .planning/STATE.md .planning/ROADMAP.md
  git commit -m "$(cat <<'EOF'
docs({scope}): {description}

{optional body}

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"
fi

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/)