.opencode/gsd-core/references/git-planning-commit.md

Git Planning Commit

Commit planning artifacts via gsd-tools query commit, which checks commit_docs config and gitignore status (same behavior as legacy gsd-tools.cjs commit).

Commit via CLI

Pass the message first, then file paths via --files. Both commit and commit-to-subrepo use --files to declare the paths to commit.

Always use this for .planning/ files — it handles commit_docs and gitignore checks automatically:

gsd-tools query 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:

gsd-tools query 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/)