41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
<!-- crag:auto-start -->
|
|
# 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.
|
|
|
|
<!-- crag:auto-end -->
|