Skip to main content
GeneralSteveGJones

commit

Validated commit — runs quick checks before committing. Use when ready to commit changes.

Stars
38
Source
SteveGJones/ai-first-sdlc-practices
Updated
2026-05-11
Slug
SteveGJones--ai-first-sdlc-practices--commit
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/SteveGJones/ai-first-sdlc-practices/HEAD/plugins/sdlc-core/skills/commit/SKILL.md -o .claude/skills/commit.md

Drops the SKILL.md into .claude/skills/commit.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Validated Commit

Run quick validation, then commit if clean.

Steps

  1. Run quick validation
/sdlc-core:validate --quick
  1. Run tests and smoke test (if application code was changed)
# Run test suite if configured
pytest --tb=short -q 2>/dev/null || echo "No pytest configured"

# Smoke test: verify the app's main module imports cleanly
python -c "import app" 2>/dev/null || python -c "import main" 2>/dev/null || echo "No app module found"

If tests fail or the app cannot import, stop. Fix the issue before committing. Static analysis passing does not mean the code works.

  1. If validation or tests fail, report the issues and stop. Do NOT commit.

  2. If all checks pass, proceed:

    • Review all changed files with git status and git diff
    • Stage the relevant files (prefer specific files over git add -A)
    • If $ARGUMENTS is provided, use it as the commit message
    • If no message provided, draft a concise commit message based on the changes
    • Use conventional commit format: feat:, fix:, docs:, refactor:, test:, chore:
  3. Commit using a heredoc for proper formatting:

git commit -m "$(cat <<'EOF'
<type>: <description>

<optional body>

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"
  1. Run git status after commit to verify success.