From 16ae938ad63422bc0c65dfca0e8cc98805794cf6 Mon Sep 17 00:00:00 2001
From: kualta <donkualta@gmail.com>
Date: Thu, 11 Jun 2026 08:57:30 -0600
Subject: [PATCH] document pre-push ci gate in claude instructions

---
 CLAUDE.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 39e84d7..a9482f9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -24,10 +24,16 @@ src/
 ## Commands
 
 ```bash
-bunx tsc --noEmit           # type-check
+bun run typecheck           # tsc --noEmit
+bun run lint                # biome check
+bun run check               # biome check --write (auto-fix lint + formatting)
 bun publish --access public # publish to npm
 ```
 
+### Before pushing: CI must pass
+
+CI runs the shared quality gate (`flow-industries/lint` ts-check workflow): `bun run lint` and `bun run typecheck`. Both must be clean before every push — run them locally and fix everything they surface (`bun run check` auto-fixes most lint/format issues). Never push with a failing gate.
+
 ## Conventions
 
 - No `@/` path aliases. All imports are relative within the package.