orbit-oss/flask
4
4
Fork 2
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
flask/CLAUDE.md
Cioc Alexandru 0a3a12aec5 feat: add AI agent governance configs
2026-04-15 02:47:08 +02:00

1.4 KiB
Raw Blame History

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.