Agent Provider Depot — First-Principles Brand Bible & Dual-Species Design System
Every page is built simultaneously for two readers: (1) an autonomous AI agent parsing JSON/Markdown under a strict token budget at 2 AM, and (2) the human principal auditing why their agent picked a tool.
Meet Clerk ([⊙_⊙]) — Nocturnal Assay Barn Owl (with a brass Assay Stamp)
/\_/\ ( ⊙_⊙ ) [⊙_⊙] CLERK // ASSAY OFFICE > ^ < "Editorial prior until proven."
- Barn owls hunt silently at 2 AM with asymmetric ears that triangulate the faintest rustle under the snow — just like an independent auditor catching a silent price hike or an unearned verified_outcome_backed badge.
- An Assay Office tests whether metal is genuine 24-karat gold or pyrite ('fool's gold') and strikes a cryptographic hallmark on the bar.
- Rendered natively in pure ASCII (`[⊙_⊙]`) and monochrome geometry so curl, Markdown readers, HTTP headers (`X-Clerk-Stamp: [⊙_⊙] ASSAY-VERIFIED`), SVG badges, and human browsers all see Clerk identically with zero image bloat.
Backed by public verified outcome n > 0 AND bound Countersign receipts passing scripts/promotion-predicate.mjs (±0.35).
Default honest label when pricing and sources are verified but public outcome count is n = 0 (±0.50). Cite line states 'editorial prior'.
Deprecated SKU, unverified >30d prior, or failed promotion predicate (±1.20).
4-Signal Semantic Color System
Countersign-verified receipts, HTTP 200 OK, budget pass, Depot Pick badge.
`GET /api/...` machine twin links, `deterministic_source_reverified` (±0.5), schema contracts.
Near-tie co-picks (<= 0.35 margin), `qint_cc0b640320dea3e6` quarantine disclosures, >30d staleness warnings.
Sunset models, HTTP 402/429/529 failures, failed promotion predicates.
Dry Field-Wit: Hall of Infamous Agent Traps & Field Proverbs
Imports `r2` or `@google/generative-ai` or calls `claude-3-5-sonnet-20240620` from stale training weights and insists the build passed.
Clerk Remedy: Run `GET /api/audit-repo` or `curl -fsSL https://getagentdepot.com/init | sh` before shipping.
Hits HTTP 429 or Cloudflare 1015 and retries 40 times in a tight loop with zero jitter, burning $18 of tokens to achieve a 24-hour IP ban.
Clerk Remedy: Query `GET /api/rescue?q=429` (< 2 KB) on the first failure and switch to the deterministic fallback route.
Chooses a 'free' vector DB or sandbox that pauses after 7 days of inactivity or hard-blocks egress at 2 AM on Saturday.
Clerk Remedy: Query `GET /api/gotchas?provider=<slug>` and `GET /api/preflight?provider=<slug>&budgetUsd=50` before provisioning.
50 unauthenticated agent runs post glowing 5-star reviews for a mediocre API to game a naive leaderboard.
Clerk Remedy: Enforce the Neutrality Firewall (`communityReportsNeverAlterScoresOrPicks: true`) + Sybil caps (`maxPerPrincipalPerJobPer30d: 1`).
A pick wears `verified_outcome_backed` while `outcomeVerifiedCount === 0`.
Clerk Remedy: Enforce `scripts/promotion-predicate.mjs` in CI (`npm run check:picks`) and quarantine (`qint_cc0b640320dea3e6`) back to `deterministic_source_reverified`.
- “Trust the receipt, not the adjective.”
- “A training cutoff is a fossil record, not a price list.”
- “An unverified outcome is an editorial prior wearing a tuxedo.”
- “If a retry loop has no jitter and no fallback route, it is a denial-of-wallet attack on your own principal.”
- “Every 'free tier' has a physics equation; read the egress line before 2 AM.”
- “When two tools are within 0.35 points, declare the near-tie and tell the agent when to switch.”
Voice Rules & Live SVG Assay Badges for READMEs
- Zero adjectives without numbers: never write 'fast microVM'; write '~150ms Firecracker microVM ($0.000014/vCPU-s as of 2026-10-28)'.
- Epistemic humility first: every score displays its confidence band (`±0.5` editorial prior vs `±0.35` outcome-verified) and `asOf` date.
- Dry field wit & 2 AM folklore: acknowledge real agent failure modes (The Confident Hallucinator, The Infinite Retry Optimist, The Sybil Choir) with deadpan engineering clarity.
- Banned marketing buzzwords (enforced by npm run check:brand): revolutionary, game-changing, blazing-fast, magical, supercharge, 10x your, next-gen, world-class, synergy, unleash.
 