From a45f333b33a72296a091ed1023692a1015197886 Mon Sep 17 00:00:00 2001 From: "russell@unturf.com" Date: Fri, 13 Feb 2026 16:34:33 -0500 Subject: [PATCH] docs: Add Green Christmas Tree policy to CLAUDE.md Every failure stays visible until fixed. No skipping, no hiding. The goal is all green - iterate until we get there. Documents current known issues that need fixing. --- CLAUDE.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 849299b..af30154 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -73,6 +73,28 @@ On 2026-01-28, we discovered our "100% pass rate" was a lie: **Never**: `PASS (API issue)`, `PASS (timeout)`, `PASS (sandbox state)` +### Green Christmas Tree Policy + +**Every failure stays visible until fixed.** No skipping. No `allow_failure: true` to hide problems. No workarounds. + +The goal is a **green christmas tree** - all tests passing, all examples validating, all lights green. Until then: + +1. **Failures are features** - They tell us what to fix next +2. **Red stays red** - Don't mask failures to make CI "pass" +3. **Iterate until green** - Keep fixing until everything works +4. **Log errors loudly** - Show stderr, stdout, API errors on every failure + +When CI fails, the response is: +- ❌ NOT: "Let's skip this test" or "Let's allow this to fail" +- ✅ YES: "Let's fix this test" or "Let's fix the code" + +**Current known issues to fix (2026-02-13):** +- SDK client examples fail in sandbox (no credentials, no SDK installed) +- PHP examples have `