flask/.github/copilot-instructions.md
2026-04-15 02:47:08 +02:00

1.8 KiB

Copilot Instructions — flask

Generated from governance.md by crag. Regenerate: crag compile --target copilot

Stack: python

Runtimes

python

Quality Gates

When you propose changes, the following checks must pass before commit:

  • lint: uv run ruff check .
  • lint: uv run ruff format --check .
  • lint: uv run mypy .
  • test: uv run tox run
  • build: python -m build
  • ci (inferred from workflow): uv run --locked --no-default-groups --group pre-commit pre-commit run --show-diff-on-failure --color=always --all-files
  • ci (inferred from workflow): uv run --locked --no-default-groups --group dev tox run
  • ci (inferred from workflow): uv run --locked --no-default-groups --group dev tox run -e typing

Expectations for AI-Assisted Code

  1. Run gates before suggesting a commit. If you cannot run them (no shell access), explicitly remind the human to run them.
  2. Respect classifications. MANDATORY gates must pass. OPTIONAL gates should pass but may be overridden with a note. ADVISORY gates are informational only.
  3. Respect workspace paths. When a gate is scoped to a subdirectory, run it from that directory.
  4. No hardcoded secrets. - No hardcoded secrets — grep for sk_live, AKIA, password= before commit
  5. Follow project commit conventions.
  6. Conservative changes. Do not rewrite unrelated files. Do not add new dependencies without explaining why.

Tool Context

This project uses crag (https://www.npmjs.com/package/@whitehatd/crag) as its AI-agent governance layer. The governance.md file is the authoritative source. If you have shell access, run crag check to verify the infrastructure and crag diff to detect drift.