my prefect server setup
prefect-metrics.waow.tech
python
orchestration
add CLAUDE.md with project invariants
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+12
+12
CLAUDE.md
+12
CLAUDE.md
···
1
+
this file is a set of notes for us:
2
+
3
+
- never use `pip` or `uv pip` — use `uv add`, `uv sync`, or `uv run --with`
4
+
- use `jq` for JSON processing, not python
5
+
- prefect docs are on disk at `~/github.com/prefecthq/prefect/docs` — read before guessing
6
+
- use justfile recipes instead of ad-hoc commands
7
+
- push to both remotes: `origin` (tangled.org) and `github` (github mirror)
8
+
- after server restart, re-fetch kubeconfig with `just kubeconfig`
9
+
- flow code never goes in worker images or ConfigMaps — it's pulled at runtime via `git_clone`
10
+
- worker image is `prefecthq/prefect:3-python3.11-kubernetes` (the `-kubernetes` tag matters)
11
+
- `PREFECT_INTEGRATIONS_KUBERNETES_OBSERVER_NAMESPACES=prefect` is what makes namespace-scoped RBAC work
12
+
- kubernetes work pool base job template defaults namespace to `default` — must be `prefect`