[rfc] Simplifying the New Health Check

[theap06]

A clear and concise description of what you want to happen.

1. Add a scaffold tool:
   Introduce:
   bin/create_new_health_check.py <check_name>
   It generates/updates:
   gcm/health_checks/checks/check_.py (template)
   gcm/tests/health_checks_tests/test_check_.py (template)
   registration in gcm/health_checks/checks/init.py
   registration in gcm/health_checks/cli/health_checks.py
   docs stub under website/docs/GCM_Health_Checks/health_checks/
   checklist output for remaining manual steps (if any)

Optional flags:
--dry-run
--group (for grouped/subcommand checks)

2. Add shared boilerplate helper:
   Create a small utility for common check runtime setup:
   logger init
   telemetry/output context setup
   killswitch pattern
   standardized exit-code/message flow
   New checks should use this helper; existing checks migrate gradually.

Acceptance Criteria
Running create_new_health_check.py check_example produces a compilable check scaffold and test/docs stubs.
New check is auto-registered in CLI and checks package.
Generated check includes killswitch wiring and telemetry/output skeleton.
Script is idempotent (re-running does not duplicate entries).
Developer docs are updated with usage instructions.

Success Metrics
Fewer manual file edits per new check.
Reduced time-to-first-working-check.
Fewer review comments for missed registration/docs/killswitch steps.

A clear and concise description of any alternative solutions or features you've considered, if any.

No response

Additional context

No response

[luccabb]

1 Add a scaffold tool:

add these items as well:

• register here: https://github.com/facebookresearch/gcm/blob/main/gcm/schemas/health_check/health_check_name.py
• killswitch registration following the steps from: https://facebookresearch.github.io/gcm/docs/GCM_Health_Checks/adding_new_health_check/#6-add-the-killswitch-feature-flag

2. Add shared boilerplate helper:
   New checks should use this helper; existing checks migrate gradually.

IMO the refactor + migration of all existing checks can be done in the same PR. With comprehensive execution tests to ensure no breaking behavior

[gustcol]

Implementation PRs are up:

• Add HealthCheckRuntime context manager for shared boilerplate [1/2] #77 — HealthCheckRuntime context manager (shared boilerplate helper) [1/2]
• Add scaffold tool for creating new health checks [2/2] #78 — bin/create_new_health_check.py scaffold tool [2/2]

PR #78 depends on #77 — merge #77 first.