Commit Workflow

Prepare, verify, and commit code changes following project standards.

Workflow Overview

Verify → Fix Issues (TDD) → Pre-commit Checks → Commit → Tests → [Push]

Quick Start Checklist

Copy and track progress:

Commit Progress:
- [ ] Step 1: Run verification skill
- [ ] Step 2: Fix issues using TDD
- [ ] Step 3: Run pre-commit checks
- [ ] Step 4: Create atomic commit
- [ ] Step 5: Run ALL test suites (3 REQUIRED):
      - [ ] make test
      - [ ] INTEG_TESTS=1 make test
      - [ ] SMOKE_TESTS=1 make test
- [ ] Step 6: Push (optional, ask first)

CRITICAL: Step 5 has THREE mandatory test suites. Skipping any is FORBIDDEN.

Step 1: Run Verification Skill

Execute the verification skill to analyze code changes:

Verification Progress:
- [ ] Load project rules and standards
- [ ] Trace code paths for modified files
- [ ] Check for semantic changes
- [ ] Identify code smells
- [ ] Run security scans
- [ ] Review PR feedback (if PR exists)

Read and follow: .cursor/skills/verification/SKILL.md

Output: List of issues found, categorized by severity.

Step 2: Fix Issues Using TDD

For each issue identified by verification:

TDD Gate (MANDATORY)

Before ANY fix:

• Write failing test first
• Confirm test fails without fix
• Implement minimal fix
• Confirm test passes

Never skip TDD. Use implementation skill for complex fixes.

Issue Priority

1. Security vulnerabilities - Fix immediately (except test data)
2. Breaking changes - Confirm intentional, add tests
3. Code smells - Fix immediately
4. PR feedback - Address blockers first

Step 3: Pre-commit Checks

Run:

bash
1make format
2make test
3INTEG_TESTS=1 make test
4SMOKE_TESTS=1 make test

Security Scans

Get absolute path first:

bash
1pwd

Then run:

1. snyk_sca_scan with absolute project path
2. snyk_code_scan with absolute project path

Fix any security issues (skip test data false positives).

Step 4: Create Atomic Commit

Pre-commit Verification

- [ ] Linting clean (make format shows no changes)
- [ ] Security scans clean
- [ ] No implementation plan files staged
- [ ] Documentation updated (if needed)

Commit Format

type(scope): description [XXX-XXXX]

Body explaining what and why.

Types: feat, fix, refactor, test, docs, chore, perf

Extract issue ID from branch:

bash
1git branch --show-current

Staged Files Check

bash
1# Review what will be committed
2git status
3git diff --staged

Never commit:

• Implementation plan files (*_implementation_plan/)
• Secrets or credentials
• Generated diagram source (commit PNGs only if needed)

Execute Commit

bash
1git add <files>
2git commit -m "$(cat <<'EOF'
3type(scope): description [XXX-XXXX]
4
5Body explaining what and why.
6EOF
7)"

NEVER use --no-verify. NEVER amend commits.

Step 5: Run All Test Suites (After Commit, Before Push)

CRITICAL: ALL three test suites MUST be executed after commit but before push. Skipping ANY test suite is FORBIDDEN.

Execution Order

Run these commands IN ORDER and wait for each to complete:

bash
1make test
2INTEG_TESTS=1 make test
3SMOKE_TESTS=1 make test

Test Gate Enforcement

Before proceeding to Step 6, verify:

1. Did SMOKE_TESTS=1 make test complete with all tests passing?
2. Did INTEG_TESTS=1 make test complete with all tests passing?
3. Did make test complete with all tests passing?

If ANY answer is "no" or "I didn't run it", STOP and run the missing tests.

Test Failure Protocol

CRITICAL: If tests fail, do not check if they are related to our changes. Identify the root cause and fix it.

If tests fail:

1. Do not proceed to push
2. Identify root cause
3. Apply TDD fix (test first, then implementation)
4. Create new commit with fix
5. Re-run ALL test suites (not just the one that failed)
6. Continue only when ALL three test suites pass

Step 6: Push (Optional)

Mandatory Test Checklist

You MUST run each test suite and check it off. Do NOT proceed to push until ALL boxes are checked:

Test Suite Checklist (ALL REQUIRED):
- [ ] SMOKE_TESTS=1 make test                    → Smoke tests PASSED

Always ask before pushing.

If approved:

bash
1git push --set-upstream origin $(git branch --show-current)

After Push

Offer to:

1. Create draft PR (if none exists)
2. Update PR description (if PR exists)
3. Check snyk-pr-review-bot comments
4. Run sleep for 60s
5. Read and run verification skill

Command Reference

Red Flags (STOP)

• Tests failing
• Any test suite skipped
• Security vulnerabilities unfixed
• Implementation plan files staged
• Unresolved PR blockers
• TDD not followed for fixes
• --no-verify being considered