Skip to content
cccskills
FreePublished on GitHub

vcsdd-commit

Create a git commit for the current VCSDD phase. Auto-generates a conventional commit message from state.json including phase, sprint, gate verdict, and affected bead IDs. Tags with vcsdd/<feature>/phase-<id>.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  1. Read state.json: get feature name, phase, sprint, gate verdict, affected beads
  2. Check for unrelated dirty files: warn if worktree has changes outside scope
  3. 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]
    
  4. 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.
  5. Commit with generated message
  6. Create phase tag: git tag vcsdd/my-feature/phase-2b (do not overwrite an existing tag)
  7. 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)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use this skill when running or interpreting VCSDD adversarial reviews. Provides calibration guidance for the Adversary agent, finding severity classification, and anti-leniency enforcement patterns.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run Phase 3 (adversarial review) for the active VCSDD feature. Spawns a fresh vcsdd-adversary agent with zero Builder context to review implementation against spec. Produces binary PASS/FAIL verdict per dimension.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run the strict-mode sprint contract review after Phase 2c. Spawns a fresh vcsdd-adversary instance to review `contracts/sprint-N.md` and writes a PASS/FAIL verdict under `reviews/contracts/sprint-N/output/`.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run Phase 6 (convergence check) for the active VCSDD feature. Validates four-dimensional convergence: finding diminishment, finding specificity, criteria coverage, and duplicate detection.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Use this skill during Phase 6 convergence checks. Provides four-dimensional convergence analysis, hallucination detection, and duplicate finding identification.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Architect escalation approval — extend iteration limit for a phase that has hit its cap. Records the approval decision in state and allows the blocked transition to proceed.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

See all skills by sc30gsw

Report a problem with this skill