Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-backend

cxc-dev-backend

Flagged

Use 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
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall