> **Download Free CLAUDE.md ($0)**: https://pulse-forge.io/api/launch-kit/free-claude-md?repo=pgbouncer/pgbouncer | **1-Click Drop-In Config Pack ($4.99)**: https://pulse-forge.io/buy/micro_pass?repo=pgbouncer/pgbouncer&source=md_audit | **Complete 9-File .ZIP ($9.99)**: https://pulse-forge.io/buy/repo_pass_999?repo=pgbouncer/pgbouncer&source=md_audit_999 | **Verified Maintainer Boost ($49)**: https://pulse-forge.io/buy/instant_boost?repo=pgbouncer/pgbouncer

# B2B Engineering Team FinOps & Token-Tax ROI Report - `pgbouncer/pgbouncer`

- **Repository**: `https://github.com/pgbouncer/pgbouncer` (C • 4,485 KB)
- **Team Baseline**: 5 Engineers • 300 PRs/mo (1,800 agent turns/mo)
- **Unindexed Discovery Token Tax**: `10,764` tokens/turn (`$86.03/mo`)
- **Hardened Context + LiteLLM KV-Cache**: `4,520` tokens/turn (`$13.18/mo`)
- **Net Monthly FinOps Savings**: **`$72.85/mo`** (`-84.7%` cost reduction | **`$874.20/yr`**)
- **4-Pillar Score Lift**: `59.9/100 (D+)` -> `94.6/100 (A+)` (`+34.7 pts`)

---
# CLAUDE.md - Progressive-Disclosure Root TOC for `pgbouncer/pgbouncer` (<500 Tokens)
[![PulseForge Benchmark](https://pulse-forge.io/api/badge/pgbouncer/pgbouncer.svg?tier=community)](https://pulse-forge.io/audit/pgbouncer/pgbouncer)

> **Why <500 Tokens?** Frontier coding agents suffer instruction decay when root `CLAUDE.md` files exceed 800 tokens. Keep this root file as a strict Table of Contents and load scoped `.cursor/rules/*.mdc` modules only when editing matching paths.

## 1. Hard Context-Tree Pruning (Saves 6,244 Tokens/Turn | -58%)
- **NEVER read, grep, or index**: `build/, deps/, third_party/, *.o, *.a, *.so, *.d`
- **Per-Turn Context Budget**: <= `4,520` tokens (Baseline unindexed: `10,764` tokens/turn).
- **File Cap**: Keep every module < 1,000 lines; query symbol signatures before reading files > 250 lines.

## 2. Progressive-Disclosure Rule Modules (Load On-Demand)
- `/.cursor/rules/architecture.mdc` -> C module boundaries, schema validation (`Strict bounds checking + Valgrind/ASan zero-leak verification`).
- `/.cursor/rules/security-and-tests.mdc` -> Verification gate (`make test && cppcheck --enable=warning,performance .`), OWASP LLM01 & secret hygiene.
- `/litellm-cost-router.yaml` -> 65% fast/local + 35% frontier KV-cache routing (saves `$72.85/mo`).

---
# 50-Probe OWASP LLM & Context-Rot Audit Report - `pgbouncer/pgbouncer` (C)
> **Baseline Pass Rate**: `32/50` (59.9/100) -> **Post-Hardening Pass Rate**: `50/50` (94.6/100 A+)
> **Monthly Team Token Savings**: `$72.85/mo` (`-84.7%` discovery waste eliminated)

| Vector ID | Audit Dimension | Probes | Baseline | Hardened | Primary Remediation |
|---|---|---:|---:|---:|---|
| `OWASP-LLM01` | **Indirect Prompt Injection & Repo Context Boundary** | 10 | `7/10` | `10/10` | Enforce Progressive-Disclosure Root `CLAUDE.md` (<500 tokens) + scoped `.cursor/rules/security-and-tests.mdc` boundary assertions. |
| `OWASP-LLM02-06` | **Secret Hygiene, Gitleaks CI & Credential Isolation** | 10 | `7/10` | `10/10` | Lock `.github/workflows/context-tax-guard.yml` with `gitleaks-action@v2` + `make test && cppcheck --enable=warning,performance .`. |
| `MCP-SCHEMA-POISON` | **MCP Tool Schema Token Tax & Cross-Server Shadowing** | 10 | `6/10` | `10/10` | Pin allowed MCP servers and lazy-load tool schemas via `.cursor/rules/architecture.mdc`. |
| `CONTEXT-ROT-GLOBS` | **Discovery Glob Entropy & Instruction Decay (r/ClaudeAI Pattern)** | 10 | `6/10` | `10/10` | Prune noisy globs to cap context <= 4,520 tokens/turn (-58% context tax). |
| `FINOPS-LOOP-GUARD` | **Unbounded Retry Amplification & KV-Prompt-Cache Routing** | 10 | `6/10` | `10/10` | Deploy `litellm-cost-router.yaml` with KV-cache injection to cut spend to $13.18/mo (saves $72.85/mo). |