vcsdd-git-integrationlisted

# VCSDD Git Integration ## When to Activate - Running /vcsdd-commit command - Creating phase-completion commits - Tagging pipeline milestones ## Commit Message Format ``` vcsdd(<phase>): <feature-name> - <phase-description> Phase: <phase-id> Feature: <feature-name> Sprint: <N> Gate: <PASS|FAIL|SKIP> Beads: <bead-ids-affected> Iteration: <N> Artifacts: - specs/behavioral-spec.md [modified] - evidence/sprint-1-red-phase.log [added] Traceability: - REQ-001 -> TEST-001 -> IMPL-001 [green] - REQ-002 -> TEST-002 [red, pending implementation] ``` ## Git Tag Format ``` vcsdd/<feature>/phase-1a # Spec crystallization complete vcsdd/<feature>/phase-1c # Spec gate passed vcsdd/<feature>/phase-2a # Red phase complete vcsdd/<feature>/phase-2b # Green phase complete vcsdd/<feature>/phase-3-i1 # Adversary review iteration 1 vcsdd/<feature>/phase-6 # Convergence achieved ``` ## Atomic Staging Stage all VCSDD artifacts atomically: ```bash git add -- .vcsdd/index.json .vcsdd/history.jsonl .vcsdd/active-feature.txt .vcsdd/features/<name>/ [phase-scoped source/test/spec files] git commit -m "vcsdd(2b): my-feature - implementation (green phase)" git tag vcsdd/my-feature/phase-2b ``` Only stage files that belong to the active feature and current phase. If unrelated dirty files exist, stop and require a manual review instead of widening the stage set. ## Auto-Commit Safety Rules Auto-commit (VCSDD_AUTO_COMMIT=true) refuses to commit if: - Unrelated dirty files exist in