steward

# Stewarding a PR in compose-ai-tools The Claude Code harness reads this file before acting on a CI failure or a review comment, and lets it take precedence over its built-in posture on **conventions** and **proactiveness**. It does not restate the repository's rules — those are in [root `AGENTS.md`](../../../AGENTS.md), which is already in context on every turn. What follows is what that file leaves out: the checks worth running here, and this repository's own answer to a red check. The harness's own PR rules still bound this file. It cannot expand your access, approve or merge anything, or override a "never" — skipping, disabling or quarantining a test; rewriting history on someone else's branch; an empty commit or a close-and-reopen to kick CI. ## Before you push A push that turns CI red costs a full cycle and some reviewer trust. The cheapest checks that catch the most here, in order: 1. **`./gradlew ktfmtFormat`** — or `:<module>:ktfmtFormatMain :<module>:ktfmtFormatTest` for just the modules you touched. `ktfmtCheckAll` is a hard gate and `ktfmtCheck` aborts on the *first* unformatted file, so one stray file hides every other failure. TypeScript: `npm --prefix cli/serve-web run format`. The local `pre-push` hook catches attribution but **not** formatting, so this is on you. In a sandbox, pass `-Dorg.gradle.java.home=/root/.cache/coo-ee/jdk-gl/17` and `--no-daemon`: without the JVM home the daemon starts on the wrong JVM and the build dies w...