Convention Scanner
Mechanically Enforce
Your Conventions.
Scans ~107 apps for compliance with global CLAUDE.md conventions.
Grades each app A-F, tracks scores over time, and gives agents
machine-readable remediation instructions.
View Dashboard
critical
Fail Fast: No PORT defaults
Detects os.environ.get('PORT', fallback) patterns that silently use wrong ports.
high
Health Endpoint
Every service must expose /api/health for monitoring and load balancer checks.
medium
CLAUDE.md Exists
Apps need agent-specific instructions so AI tools can work effectively.
high
No Bare except: pass
Swallowed exceptions make failures invisible to agents and humans alike.
Agent API
$ curl /api/violations/my-app
{
"violations": [{
"name": "No PORT fallback defaults",
"severity": "critical",
"remediation": "Replace environ.get('PORT', ...) with environ['PORT']"
}]
}