From 244fbb82545851614088c9e5f580b1d22e21c741 Mon Sep 17 00:00:00 2001 From: Jaime Henriques Date: Tue, 21 Jul 2026 01:14:28 +0100 Subject: [PATCH] docs: add Health Stack section to pin /health to the fast path gstack has no tsconfig/biome/knip/shellcheck, and the full `bun test` script spawns browser integration tests that hang in non-interactive agent shells. Document the fast deterministic tier plus slop-scan so /health completes and targets the real quality gates. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01BV2RsGpwAdbDid7yAHBtXK Co-authored-by: Orca --- CLAUDE.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 984844902..877b7c72a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -81,6 +81,21 @@ bun run test:evals # run before shipping — paid, diff-based (~$4/run max) integration tests. `bun run test:evals` runs LLM-judge quality evals and E2E tests via `claude -p`. Both must pass before creating a PR. +## Health Stack + +The `/health` skill auto-detects nothing useful here: there's no `tsconfig.json` +(Bun runs TypeScript directly), no biome/eslint, no knip, and shellcheck usually +isn't installed. The real quality gates are the test suite and slop-scan. The full +`bun test` script also spawns browser integration tests that hang in non-interactive +agent shells, so `/health` targets the fast deterministic tier instead. slop-scan is +this repo's linter (see the Slop-scan section below). + +- test: bun test test/skill-validation.test.ts test/gen-skill-docs.test.ts test/hermetic-wiring.test.ts +- lint: npx slop-scan scan . + +Run the full `bun test` yourself in a real terminal before a PR — the `/health` entry +above is the subset that completes without a browser, not a replacement for it. + ## Project structure ```