Menu
Run after completing changes to verify the app builds, tests pass, and the diff is clean before committing.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | verification-loop |
| description | Run after completing changes to verify the app builds, tests pass, and the diff is clean before committing. |
| user-invokable | true |
Run this after completing a feature, fixing a bug, or before committing. Catches broken code before it lands.
cd /workspace/woozy-dev-infra/obviously-the-best-hello-world-app
python -m py_compile main.py
If the project grows to use mypy or ruff:
ruff check .
mypy --strict .
cd /workspace/woozy-dev-infra/obviously-the-best-hello-world-app
python -m pytest tests/ -v
Check for failures and regressions. All tests must pass.
docker compose build hello-world
Ensures the Dockerfile is valid and dependencies install correctly.
# Start the service
docker compose up -d hello-world
# Test endpoints
curl -s http://localhost:8000/api | jq .
curl -s -X POST http://localhost:8000/api/hit | jq .
curl -s -X POST http://localhost:8000/api/reset | jq .
Verify all endpoints return valid JSON with the expected hits field.
git diff --stat
Review each changed file for:
response_model= on new endpointsAfter running all phases, produce:
VERIFICATION REPORT
==================
Compile: [PASS/FAIL]
Tests: [PASS/FAIL] (X/Y passed)
Build: [PASS/FAIL]
Smoke: [PASS/FAIL]
Diff: [X files changed]
Overall: [READY/NOT READY] to commit
Issues to Fix:
1. ...
| Phase | Fix |
|---|---|
| Compile | Fix syntax or type errors |
| Tests | Fix failing test or update test if behavior changed intentionally |
| Build | Fix Dockerfile or requirements |
| Smoke | Check container logs: docker compose logs hello-world |
Create a new database migration for PostgreSQL. Covers file naming, SQL patterns, running, and updating dependent code.
Baseline code quality enforcer — naming conventions, import hygiene, type safety, and style rules for a FastAPI + asyncpg + PostgreSQL Python backend.
Database schema reference for the hello-world app's PostgreSQL instance. Use when writing queries, creating migrations, or debugging data issues.
Docker patterns for this project — DooD (Docker-outside-of-Docker), compose conventions, container lifecycle, and dev-box workflow.
Step-by-step checklist for adding a new API endpoint to a FastAPI + asyncpg app. Covers schema, query, route, and verification.
Project file tree and layout conventions. Use when navigating the codebase, finding where files belong, or understanding the project layout.