fawkes

Architecture Decision Record template and quality checklist with DORA capability linkage. Use when documenting an architectural decision that agents must follow going forward.

Step-by-step OpenTelemetry and uFawkesObs setup: SDK init patterns for TypeScript, Python, Go; DORA metric spans; Grafana dashboard spec. Use when adding observability to a service.

Step-by-step guide to connect a uFawkesAI project to uFawkesPipe and fawkes platform: Dockerfile, ArgoCD manifest, DORA deployment spans. Use when setting up CI/CD for a new service.

Pre-merge security checklist covering secrets, dependencies, auth, data handling, and fawkes suite gates. Use when reviewing a PR for security issues or hardening a change before merge.

TDD patterns and language-specific test examples for TypeScript/Jest, Python/pytest, and Go. Use when writing tests, increasing coverage, or implementing test-driven development.

Add DORA metrics instrumentation to GitHub Actions workflows — job timestamps, deployment tracking, lead time calculation. Load when adding DORA logging to workflows.

GH Actions rules for Fawkes — pin SHA, timeout-minutes, path filtering. Load when editing workflows.

K8s manifest rules for Fawkes — labels, limits, security context. Load when editing platform/ or charts/.

OTEL integration for Fawkes — Python packages, FastAPI instrumentor, gen_ai spans, metric naming. Load when instrumenting services.

Run targeted pre-commit checks locally before commit — detect staged files, run only relevant layer(s), prevent commit on failure. Load when about to commit or when user asks to validate changes.

Create or modify GitHub reusable workflows — input/output contracts, caller patterns, secrets propagation. Load when creating workflows/ or modifying reusable-*.yml files.

Security checks for Fawkes — secrets, RBAC, container security. Load before security changes.

New service template for Fawkes — file structure, main.py, Dockerfile. Load when creating a service.

Terraform patterns for Fawkes — variables, backend, tags. Load when editing infra/.

Audit GitHub Actions workflows for security issues — secret handling, permissions, injection risks, action pinning. Load before merging workflow changes.