Add agent when-to-use guidance to llms.txt plus homepage/contact markdown twins

[RobbieTheWagner]

Part of the agent-readiness work (Is Agentic audit): tells agents when to use the site and gives them named, predictable entry points.

• llms.txt (and the for-llms page) now open with a "When To Use This Site" section naming best-fit jobs — find/quote episodes, transcripts, guest appearances, listening links — and how to fetch machine-readable content, plus an explicit "do not use for unrelated topics" line
• New "Developer Resources" section listing the OpenAPI spec, JSON APIs, sitemap, and RSS feed by name for discoverability
• New markdown twins: /index.html.md (homepage) and /contact.html.md, generated from config like the existing ones
• robots.txt mentions the OpenAPI spec and Accept-header markdown support

All content is generated from starpod.config.ts and the RSS feed — generic for every Starpod deployment.

Test plan

• Unit: expanded tests/unit/llms.test.ts for the new sections and generators
• E2E: tests/e2e/llms.spec.ts verifies llms.txt sections and both new markdown twins

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
starpod	Ready	Preview	Aug 23, 2026 2:57pm

[coderabbitai]

Warning

Review limit reached

@RobbieTheWagner, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 7 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 30648144-c53c-4af1-b28b-3616bd407898

📥 Commits

Reviewing files that changed from the base of the PR and between 80e49fe and 12ac7fd.

📒 Files selected for processing (6)

• src/lib/llms.ts
• src/pages/contact.html.md.ts
• src/pages/index.html.md.ts
• src/pages/robots.txt.ts
• tests/e2e/llms.spec.ts
• tests/unit/llms.test.ts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}