# CLAUDE.md — flask > Generated from governance.md by crag. Regenerate: `crag compile --target claude` **Stack:** python **Runtimes:** python ## Quality Gates Run these in order before committing. Stop on first MANDATORY failure: - `uv run ruff check .` - `uv run ruff format --check .` - `uv run mypy .` - `uv run tox run` - `python -m build` - `uv run --locked --no-default-groups --group pre-commit pre-commit run --show-diff-on-failure --color=always --all-files` - `uv run --locked --no-default-groups --group dev tox run` - `uv run --locked --no-default-groups --group dev tox run -e typing` ## Rules 1. Read `governance.md` at the start of every session — it is the single source of truth. 2. Run all mandatory quality gates before committing. 3. If a gate fails, attempt an automatic fix (lint/format) with bounded retry (max 2 attempts). If it still fails, escalate to the user. 4. Never modify files outside this repository. 5. Never run destructive system commands (`rm -rf /`, `DROP TABLE`, force-push to main). - Follow project commit conventions ## Security - No hardcoded secrets — grep for sk_live, AKIA, password= before commit ## Tool Context This project uses **crag** (https://www.npmjs.com/package/@whitehatd/crag) as its governance engine. The `governance.md` file is the authoritative source. Run `crag audit` to detect drift and `crag compile --target all` to recompile all targets.