| name | system-integration-validator |
| description | Validates system integration before deployment. Use when checking ports, database connections, frontend-backend APIs, or debugging blocked/stuck workflows. Detects dead ends, bottlenecks, circular dependencies. |
System Integration Validator
Validates system integration before deployment.
When to Use
- Pre-deployment validation
- Checking port availability
- Verifying database connections
- Debugging stuck workflows
- Detecting dead ends or circular dependencies
Workflow
Step 1: Check Ports
Verify all required ports are free.
Step 2: Verify Databases
Test PostgreSQL and Redis connections.
Step 3: Validate API Contracts
Ensure frontend ↔ backend match.
Step 4: Analyze Data Flow
Detect dead ends, orphan inputs, bottlenecks.
Pre-Deployment Checklist
- Ports - All required ports free
- Database - Connection, pool, migrations OK
- API Contract - Frontend ↔ Backend match
- Data Flow - No dead ends or loops
Port Check
for port in 3000 3001 5432 6379 8080; do
lsof -i :$port > /dev/null 2>&1 && echo "⚠️ $port IN USE" || echo "✅ $port free"
done
Database Check
pg_isready -h localhost -p 5432 && echo "✅ PostgreSQL OK"
redis-cli ping && echo "✅ Redis OK"
Flow Analysis
Look for:
- Dead ends: Output never consumed
- Orphan inputs: Input never provided
- Bottlenecks: High in-degree (>3 inputs)
- Circular deps: A → B → A
Common Blocks
// ❌ No timeout
await fetch(url)
// ✓ With timeout
const ctrl = new AbortController()
setTimeout(() => ctrl.abort(), 5000)
await fetch(url, { signal: ctrl.signal })