scaffold-archipy-health-checkslisted
Install: claude install-skill SyntaxArc/archipy-plugin
# Scaffold ArchiPy Health Checks
## Before writing files
1. Inspect package/config, current transports, app lifecycle, dependency adapters, DI wiring, deployment manifests, and
existing health endpoints.
2. Infer package name, transport, ports, and readiness dependencies from the repository.
3. Ask only for unresolved choices: dependencies to include, heartbeat deadlock detection, or Kubernetes YAML.
4. Preserve existing health routes and manifests; merge compatible additions instead of overwriting.
## Prefer ArchiPy
Health checks are app code. ArchiPy does not ship stock HTTP routes or a stock gRPC `Health` servicer.
**Probe semantics** (liveness vs readiness vs startup, K8s notes, common mistakes, FastAPI sketches): keep
`../archipy-docs/reference.md` § Health checks as the source of truth — do not invent alternate probe meanings or
duplicate endpoint sketches here.
```bash
uv add "archipy[fastapi]" # HTTP probes
uv add "archipy[grpc]" # gRPC server + grpcio-health-checking
```
Prefer existing app bootstrap:
```python
from archipy.helpers.utils.app_utils import AppUtils
from archipy.configs.base_config import BaseConfig
# FastAPI
app = AppUtils.create_fastapi_app()
app.include_router(create_health_v1_router(container))
# gRPC (sync)
server = AppUtils.create_grpc_app(BaseConfig.global_config())
# register domain servicers, then health:
register_health_servicer(server, container)
# gRPC (async)
server = AppUtils.create_async_grpc_app(BaseConfig.global_con