lidge-jun/codexclaw / plugins/codexclaw/skills/dev-backend
cxc-dev-backend
FlaggedUse for APIs, servers and app databases. Triggers: REST, GraphQL, migration, query optimization, middleware, caching, queues, 백엔드, API 작업, 마이그레이션, 쿼리 최적화.
references/core/health-checks.md
View on GitHub# Health Checks & Readiness Probes
Every backend service MUST expose:
## Liveness — `GET /health`
```json
{ "status": "ok" }
```
Always returns 200 unless the process is crashed. Use for Kubernetes liveness probes and load balancer health checks.
## Readiness — `GET /ready`
```json
{ "status": "ready", "checks": { "db": "ok", "redis": "ok", "queue": "ok" } }
```
Checks all dependencies are reachable. Returns 503 if any check fails. Use for Kubernetes readiness probes and deploy gating.
## Startup — `GET /health/startup` (optional)
```json
{ "status": "started", "uptime": 12.5, "version": "1.2.3", "commit": "abc1234" }
```
Verifies initial warmup is complete (cache primed, connections established). Use for slow-starting services.
## Rules
- Health endpoints do NOT require authentication
- Health endpoints do NOT log every request (noise in production)
- Database check: `SELECT 1`, not a full query
- Redis check: `PING`, not a read/write cycle
- Timeout per dependency check: 2s max, fail fast
- Include version/commit SHA in startup response for deploy verification
- Never expose internal error details in health responses
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |