| name | python-langgraph-workflow |
| description | Use this skill when managing a Python LangGraph repository using uv and a Makefile. Covers dependency syncing, running quality controls (lint, format, typecheck, tests), generating agent graphs, and executing the git commit/push workflow. |
LangGraph Python Local CI & Git Push Workflow
This skill hooks into the project's native uv and Makefile lifecycle tasks, ensuring all LangGraph agents, validation suites, and formatting checks pass cleanly before committing changes.
🛠️ Environment Constraints
- Package Manager:
uv
- Python Runtime Wrapper:
uv run
- Task Runner:
make
🏃♂️ Step 1: Pre-Commit Quality Verification
Run the unified check command. This will execute formatting checks, Ruff/Pylint linting, Mypy type-checking, Pytest suites, and codespell in sequence. Stop immediately if this command fails.
make check
Optional Specialized Targets
If a specific sub-task in the check fails, use these isolated commands to debug or fix:
- Auto-format Code:
make format
- Run Unit Tests:
make test
- Visualize LangGraph State Machine: Generate and inspect the compiled graph image:
make graph
🔍 Step 2: Stage & Diff Analysis
Once the codebase passes make check, audit the workspace modifications before committing.
- Check Workspace Status:
git status
- Stage Changes:
git add .
- Review Staged Changes: Run the following command to review the exact lines modified in the graphs, prompts, or tests:
git diff --cached
- Agent Instruction: Read through the staged diff carefully. Note changes to LangGraph nodes, conditional edges, state schemas, or system prompts to write a precise, technical commit message.
🔀 Step 3: Git Commit & Push
Only proceed to this step after all local verification targets have passed and the staged changes have been audited.
- Commit with Context:
- Craft a concise, clear commit message using the imperative mood (e.g.,
feat: add conditional router edge to conversational agent graph).
- Base the message directly on the specific logical changes found during the
git diff --cached step.
git commit -m "<descriptive-message-from-diff>"
- Push to Remote:
git push origin HEAD
