Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

docs(agents): point the security guidance at the charts deployment paths (#122983)

Tom Piccirello9aad1950291a
diff --git a/.agents/security.md b/.agents/security.md
index f223befb1930..60c28297bf85 100644
--- a/.agents/security.md
+++ b/.agents/security.md
@@ -200,6 +200,20 @@ mitigated. A code path that bypasses the proxy, and a self-hosted deployment, do
control. A request that probes or trusts an attacker-controlled server is always in scope. The
SSRF rule in `.agents/skills/security-audit/SKILL.md` says which control is load-bearing.
+## Deployment config
+
+PostHog/charts holds the deployment config for PostHog Cloud. A review of PostHog/posthog-private
+gets a read-only copy of it at `$CONTEXT_DIR/related/PostHog/charts`; a review of this public
+repository does not. When the copy is there, start with these paths:
+
+- `argocd/posthog-django/` and `apps/posthog-*-django/`: the Django web, worker, query and report
+ deployments.
+- `shared/posthog-django/`: values that every Django deployment shares.
+- `shared/cdp/`, `shared/ingestion/` and `argocd/ingestion/`: the Node CDP and ingestion services.
+- `argocd/contour-ingress/values/`: public routing.
+- `shared/smokescreen/`, `apps/smokescreen/` and `shared/infrastructure/`: the egress proxy and its
+ URL.
+
## Out-of-band interaction domains
`posthog/security/crosslang/oob_domains.json` lists the services that capture out-of-band