Context
templates/go/CLAUDE.md documents GET /ping (liveness) and GET /health/check
(readiness — "real per-dependency probes") as required routes, and
knowledge:production-stability names "health checks (liveness vs readiness)" as
doctrine. But no skill delivers the concrete implementation contract, so every new
service re-derives the readiness "inspector" pattern from scratch — exactly the kind of
repeated machinery this kit exists to centralize.
Gap
There is no skill that owns the readiness inspector pattern:
- per-dependency probes (DB, repositories, caches, queues, external/AI APIs)
- isolation so one dead dependency never hangs or 500s the whole endpoint
- response shape (per-component status + overall)
- status-code rules (200 only when everything is healthy; a hardcoded
OK is unacceptable)
- auth rules for the endpoint
- cost-bounding of paid / rate-limited probes (cache the result and serve its age between refreshes)
- the required tests
production-stability is doctrine-level; the engineer and reviewer agents need the
concrete pattern to implement and to grade against.
Proposal
Add knowledge:health-check (cross-stack — the readiness contract is stack-agnostic
even when the wiring is Go or Dart). Keep production-stability as the doctrine and
health-check as the implementation contract, cross-linked. Wire it into the "context
to load first" lists of engineer.md and reviewer.md for network-facing / new-service
work.
Acceptance criteria
Context
templates/go/CLAUDE.mddocumentsGET /ping(liveness) andGET /health/check(readiness — "real per-dependency probes") as required routes, and
knowledge:production-stabilitynames "health checks (liveness vs readiness)" asdoctrine. But no skill delivers the concrete implementation contract, so every new
service re-derives the readiness "inspector" pattern from scratch — exactly the kind of
repeated machinery this kit exists to centralize.
Gap
There is no skill that owns the readiness inspector pattern:
OKis unacceptable)production-stabilityis doctrine-level; theengineerandrevieweragents need theconcrete pattern to implement and to grade against.
Proposal
Add
knowledge:health-check(cross-stack — the readiness contract is stack-agnosticeven when the wiring is Go or Dart). Keep
production-stabilityas the doctrine andhealth-checkas the implementation contract, cross-linked. Wire it into the "contextto load first" lists of
engineer.mdandreviewer.mdfor network-facing / new-servicework.
Acceptance criteria
plugins/knowledge/skills/health-check/SKILL.mdexists, description-matched loading.schema; 200-only-when-healthy; endpoint auth; cost bounds for paid probes (cache + age).
unhealthy while the endpoint still responds (no hang, no full 500).
engineer.mdandreviewer.mdreference the skill;templates/*/CLAUDE.mdpointto it instead of describing the pattern inline.
knowledgeplugin.jsonversion bumped.