Update LLMs.txt files with current docs and features#92
Conversation
✅ Deploy Preview for agent-native-fw ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
agent-native-calendar | 42e6851 | Commit Preview URL Branch Preview URL |
Mar 25 2026, 12:31 PM |
There was a problem hiding this comment.
Builder has reviewed your changes and found 2 potential issues.
Review Details
Code Review Summary
PR #92 updates llms.txt and llms-full.txt to reflect current framework state: Nitro backend, new Mail/Calendar templates, updated CLI harness table, new Deployment and File Sync sections, and corrected project structure. The intent is solid and the new content is significantly more accurate than what it replaces.
Risk: 🟢 Low — documentation-only changes, no runtime code affected.
Key Findings
Critical (Broken Rendering):
- 🔴 Two missing opening code fences — both
llms-full.txt(Installation) andllms.txt(Quick Start) have dangling closing```with no matching opening```bash. The install commands render as plain prose, and the stray fences corrupt subsequent code blocks. Found independently by both review passes.
Other Issues:
- 🟡 Harnesses doc link is the only entry in
llms.txtwithout a.mdsuffix, contradicting the sentence immediately above it that says to "append.mdto any docs URL" - 🟡 Architecture description mismatch — both files still describe the framework as "Files as database / All state lives in files" when the actual framework (
AGENTS.md) now uses SQL (SQLite/libsql withapplication_state,settings,oauth_tokenstables). LLMs consuming these files will be directed to build against JSON files instead of the SQL stores the framework provides. - 🟡 Missing closing code fence at EOF in
llms-full.txt— the Video template's```bashblock is opened but never closed before the file ends.
Found by running 2 parallel code-review agents with randomized file ordering.
Code review by Builder.io
| Create a new project: | ||
|
|
||
|
|
||
| npx @agent-native/core create my-app | ||
| ``` |
There was a problem hiding this comment.
🔴 Missing opening code fence — install command renders as prose
The npx @agent-native/core create my-app block has a closing ``` but no opening ```bash. The command renders as plain text, and the stray closing fence corrupts the "Or fork a specific template" block immediately after it.
How did I do? React with 👍 or 👎 to help me improve.
| cd my-app | ||
| pnpm install | ||
| pnpm dev | ||
| ``` | ||
|
|
||
| ## Templates | ||
|
|
There was a problem hiding this comment.
🔴 Missing opening code fence — Quick Start commands render as prose
The four install commands (npx … cd … pnpm install … pnpm dev) have a closing ``` but no opening ```bash. This is the first code example a reader sees in llms.txt and it will appear as unformatted text in every Markdown renderer.
How did I do? React with 👍 or 👎 to help me improve.
Summary
Updates both
llms.txtandllms-full.txtin the agent-native docs site to reflect the current state of the framework, including the backend change from Express to Nitro, new templates, updated CLI harness info, and deployment/file sync documentation.Problem
The existing
llms.txtandllms-full.txtfiles were outdated — they referenced Express backends, an incomplete template list, and missing sections on deployment, file sync, and routing. The CLI harness table and install flow also did not match the current Builder CLI naming and available options.Solution
Replaced the stale content in both LLM context files with accurate, up-to-date documentation reflecting the current framework architecture, templates, and install flow. Changes were kept minimal and targeted to avoid unnecessary churn.
Key Changes
ExpresstoNitroin both filesMailandCalendartemplates added to bothllms.txtandllms-full.txtBuilder.io(fusion) as a supported CLI alongside Claude Code, Codex, Gemini CLI, and OpenCode--templateflag exampleRoutingandDeploymentpages to the markdown docs index inllms.txtllms-full.txt): Added full deployment docs covering Node.js, Cloudflare Workers, SQLite/Turso/Neon/D1 database options, and environment variablesllms-full.txt): AddedcreateFileSync()docs covering Firestore, Supabase, and Convex adaptersllms-full.txt): Updated to reflect the current React Router / Nitro-based file layoutTo clone this PR locally use the Github CLI with command
gh pr checkout 92You can tag me at @BuilderIO for anything you want me to fix or change