tele-mcp/.claude/rules/stack-and-commands.md

## Stack

- **Language:** Python (FastAPI MCP bridge) + Ansible/Helm/K8s deploy assets
- **Key deps:** FastAPI, uvicorn, httpx; kube-prometheus-stack, Loki, Promtail

## Dev Commands

```bash
# MCP bridge — local (no cluster)
make bridge-install   # once
make bridge-test      # pytest smoke tests
make bridge-run       # uvicorn on :8080

# Deploy observability stack (from repo root)
cd ansible && ansible-playbook -i inventories/local.ini playbook.yml

# Smoke (requires cluster access)
kubectl get pods -n monitoring
kubectl port-forward -n mcp svc/mcp-telemetry-bridge 8080:80
make bridge-smoke     # pytest + live curl against :8080
```