Skill

vcsdd-commit

Creates git commits and tags for VCSDD phase completions. Auto-generates conventional messages from state.json with phase, sprint, gate verdict, beads, artifacts, and traceability. Stages feature/phase files atomically.

Git

Bash

git-workflow

npx claudepluginhub sc30gsw/vcsdd-claude-code --plugin vcsdd

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Creates a git commit atomically staging source, tests, `.vcsdd/features/<name>/`, and evidence files. Auto-generates a conventional commit message from pipeline state.

SKILL.md

Similar Skills

vcsdd-git-integration

Generates conventional commit messages, phase-specific git tags, and atomic staging commands for VCSDD pipeline artifacts. Useful for phase completions, /vcsdd-commit, and milestone tagging.

vcsdd

commit-standards

Defines commit message format and changelog standards for SDD projects. Auto-activates after filesystem changes, SDD tasks, or commit requests.

sdd

commit-msg

Commits staged git changes with meaningful messages using tags from git-msg-tags.md. Supports short/full formats based on change size, milestones on dev branches, and issue references.

agentize

Stats

Stars16

Forks0

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

vcsdd(2b): my-feature - implementation (green phase) Phase: 2b Feature: my-feature Sprint: 1 Gate: PASS Beads: BEAD-005, BEAD-006, BEAD-007 Iteration: 1 Artifacts: - src/parser.py [added] - tests/test_parser.py [modified] - .vcsdd/features/my-feature/evidence/sprint-1-green-phase.log [added] Traceability: - REQ-001 -> TEST-001 -> IMPL-001 [green]

What

Creates a git commit atomically staging source, tests, .vcsdd/features/<name>/, and evidence files. Auto-generates a conventional commit message from pipeline state.

When

Run at any phase completion milestone to preserve the pipeline state in git. Works at any phase.

How

Read state.json: get feature name, phase, sprint, gate verdict, affected beads
Check for unrelated dirty files: warn if worktree has changes outside scope

Build commit message:

vcsdd(2b): my-feature - implementation (green phase)

Phase: 2b
Feature: my-feature
Sprint: 1
Gate: PASS
Beads: BEAD-005, BEAD-006, BEAD-007
Iteration: 1

Artifacts:
- src/parser.py [added]
- tests/test_parser.py [modified]
- .vcsdd/features/my-feature/evidence/sprint-1-green-phase.log [added]

Traceability:
- REQ-001 -> TEST-001 -> IMPL-001 [green]

Stage atomically:
```
git add -- .vcsdd/index.json .vcsdd/history.jsonl .vcsdd/active-feature.txt .vcsdd/features/my-feature/ [phase-scoped source/test/spec files]
```
Limit staging to files that belong to the active feature and current phase. If other dirty files exist, stop and ask for a manual commit instead of widening the scope.
Commit with generated message
Create phase tag: git tag vcsdd/my-feature/phase-2b (do not overwrite an existing tag)
Record last-commit-phase for auto-commit deduplication

Auto-Commit vs Manual

This command is for manual phase commits. The vcsdd-auto-commit.js hook handles auto-commits (only when VCSDD_AUTO_COMMIT=true and worktree is clean).

Examples

/vcsdd-commit
/vcsdd-commit --message "custom note"    # append custom note to auto-generated message
/vcsdd-commit --tag-only                 # tag without new commit (already committed manually)