References
Cached reference material that agents (and humans) consult instead of repeatedly hitting external APIs, re-clicking through live sites, or re-running expensive lookups. Each subdirectory is a frozen-but-refreshable catalog of something otherwise expensive to access.
What's here
| Path | Purpose |
|---|---|
cartesia-voices/ | Catalog of all 725 Cartesia TTS voices with metadata + ~100 pre-sampled English voices. Zero-cost voice-agent provisioning — agents pick from the catalog instead of calling Cartesia TTS to audition. See its own README for the serial-only MCP rule. |
screenshots/ | Weekly Playwright snapshots of every public portfolio surface (churchwiseai.com, pewsearch.com, illustratetheword.com, docs.churchwiseai.com). Refreshed Sundays 02:00 UTC by .github/workflows/refresh-screenshots.yml. |
voice-agent-sources.md | Pointer list to external research on voice-agent quality, latency, pastoral-care voice-AI benchmarks. Not comprehensive — updated when a new source is genuinely useful. |
How to add a new reference set
Drop a new subdirectory with:
- A
README.mdexplaining what's cached, when it was last refreshed, and how to regenerate (script reference or manual instructions). - The cached material in a format agents can query structurally (JSON index is ideal; large media files in subdirectories).
- A frontmatter
last-verified:date on the README.
If the reference involves an external API, prefer a script at scripts/build-<name>-catalog.ts that can be re-run to refresh the cache. Commit the output; regenerate only when the upstream changes.
Related
../reference/(singular) — currently empty. Historical placeholder; not currently used. Usereferences/(plural) for new additions.- Agent memory lives outside this repo (per-Claude-Code install under
.claude/memory/). Narrow scope — user preferences, incident recall. References/ (here) is for portable, version-controlled catalogs. ../runbooks/content-ops/— operator procedures that may regenerate some reference material (illustration bulk content, sermon prep fixtures).