Skip to content

docs(website): refresh llms.txt for post-publish reality#151

Merged
blove merged 3 commits into
mainfrom
chore/website-post-publish-update
May 1, 2026
Merged

docs(website): refresh llms.txt for post-publish reality#151
blove merged 3 commits into
mainfrom
chore/website-post-publish-update

Conversation

@blove
Copy link
Copy Markdown
Contributor

@blove blove commented May 1, 2026

The `llms.txt` that AI assistants scrape was significantly stale post-publish. Surgical refresh in this PR; broader strategic content rewrite (hero positioning, AG-UI library doc pages, four-tier landing) is deferred.

Changes

`apps/website/src/app/llms.txt/route.ts` rewritten:

  • Version `0.1.0` → `0.0.1` (matches the currently published packages)
  • Old framing "streaming library for LangChain/LangGraph" → runtime-neutral chat SDK
  • Add full package list (7 published `@ngaf/*` packages with one-line descriptions)
  • Replace stale `AgentRef.status: 'idle'|'loading'|'resolved'|'error'` with current Agent contract surface
  • Two minimal examples: one for LangGraph, one for AG-UI
  • Drop `npx @ngaf/langgraph-mcp` references (mcp package is private/deferred)
  • Mention MIT license

`apps/website/src/app/llms-full.txt/route.ts`: drop the `## MCP server` section (same reason).

Out of scope (separate PR if/when needed)

  • Hero copy / headline positioning ("for LangChain/Angular" doesn't reflect the new AG-UI adapter)
  • Adding `@ngaf/ag-ui` to `TheStack` and other 3-pillar landing components (would need design updates)
  • Full library doc pages for `@ngaf/ag-ui`
  • Email `brian@cacheplane.io` references in API routes (separate concern)

Test Plan

  • `nx build website` passes locally
  • Visit `/llms.txt` after deploy, confirm content renders

🤖 Generated with Claude Code

The llms.txt that LLMs scrape was wildly stale:
- Version 0.1.0 → 0.0.1 (matches current published version)
- Old framing as "streaming library for LangChain/LangGraph" → runtime-
  neutral chat SDK with LangGraph and AG-UI adapters
- Drop @ngaf/langgraph-mcp references (mcp package is private/deferred)
- Add list of all 7 published @ngaf/* packages with descriptions
- Replace stale 'AgentRef.status: idle|loading|resolved|error' with
  current Agent contract surface (signals + events$ + submit/stop)
- Show install + minimal example for both LangGraph and AG-UI paths
- Mention MIT license

Also drop the 'MCP server' section from llms-full.txt (mcp not published).

Strategic repositioning of hero/landing copy and full library docs for
@ngaf/ag-ui are out of scope for this PR — separate work.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

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

Project Deployment Actions Updated (UTC)
cacheplane Ready Ready Preview, Comment May 1, 2026 2:50am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
cacheplane-minting-service Skipped Skipped May 1, 2026 2:50am

Request Review

Beyond the prior llms.txt fix in this PR, this commit tackles the
broader doc rot:

1. Hero positioning (HeroTwoCol):
   - Headline: "for LangChain and Angular" → "for Angular" (drops
     LangChain framing now that the framework is multi-runtime)
   - Subtitle: "Signal-native streaming for LangGraph" → "Signal-native
     chat UI for any agent runtime — LangGraph, AG-UI, or your own
     backend"
   - Add AG-UI badge alongside LangChain + Angular
   - Setup snippet shows both adapter paths (provideAgent +
     provideAgUiAgent)

2. TheStack landing component: add AG-UI as a 4th library card.
   Update headline ("Three libraries" → "Four libraries") and subtitle
   ("Your LangGraph agent" → "Whatever your agent runtime").

3. RenderStackSiblings: add AG-UI link.

4. AG-UI library docs: register in docsConfig (LibraryId 'ag-ui',
   getting-started section with introduction/quickstart/installation
   pages). Write all three MDX pages covering install, quickstart, and
   what's in/out of scope for the first release.

5. Email preview placeholder: brian@cacheplane.io →
   demo@example.com (clearly placeholder).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- 'Three libraries' → 'Four libraries' assertion (TheStack now has AG-UI)
- Pricing page test: drop Developer Seat / App Deployment (removed during
  MIT relicense; only Open Source and Enterprise tiers remain)
- Docs landing page test: also assert AG-UI library card

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel vercel Bot temporarily deployed to Preview – cacheplane-minting-service May 1, 2026 02:48 Inactive
@blove blove merged commit ca02bc9 into main May 1, 2026
15 checks passed
@blove blove deleted the chore/website-post-publish-update branch May 7, 2026 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant