Increase neon init awareness#4676
Draft
jeff-at-neon wants to merge 9 commits into
Draft
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Updates existing prompts across 35 frameworks/ORMs and adds 4 new prompts (bun, knex, node, remix) to improve AI-assisted Neon integration guidance. Co-authored-by: Isaac
Updates 39 guides across all supported frameworks and ORMs to reference the updated quick-prompt files for AI-assisted Neon integration. Co-authored-by: Isaac
Adds two new comparison docs and registers them in navigation alongside the existing Neon and Lakebase entry. Also adds TanStack Start to the frameworks section of navigation. Co-authored-by: Isaac
Adds neon init tip admonitions to connect, signing-up, and get-started pages. Updates the Supabase migration guide with an auth migration section. References Neon Auth in ai-intro, serverless driver, and frameworks pages. Updates the AI skills getting-started reference. Co-authored-by: Isaac
Adds agentInstructions block to llms-index-config with guidance on neon init, Neon Auth, and platform comparisons. Updates tagline to mention Neon Auth and Data API. Includes agentInstructions in both the index and full llms.txt generators. Co-authored-by: Isaac
Fixes tab hydration flicker by deferring active-tab derivation until mount. Adds TOC awareness of tab context so headings inside inactive tabs are handled correctly. Adds error handling to the copy-markdown action for failed fetches and unexpected HTML responses. Co-authored-by: Isaac
jeff-at-neon
force-pushed
the
increase-neon-init-awareness
branch
from
20b8305 to
126054b
Compare
Replaces lock-landscape (unsupported in TechCards) with auth icon. Co-authored-by: Isaac
Agent evals showed that agents mentioned neon init but bypassed it
when scaffolding projects, manually installing packages instead.
This changes all agent-facing surfaces from advisory language
("recommended", "try", "offer to") to prescriptive directives
("MUST execute", "REQUIRED", "do not manually install") so agents
actually run the command rather than just being aware of it.
Eval results showed agents see neon init in docs but still scaffold manually with create-next-app and install third-party auth (next-auth). Changes: - Add "Common mistakes to avoid" anti-patterns to SKILL.md, llms.txt agent instructions, and all framework prompt "Do Not" sections - Explicitly forbid: scaffolding before init, manual Neon package installs, using next-auth/Auth.js instead of Neon Auth - Change Admonitions on auth/overview, connect-neon, connect-from-any-app from type="tip" to type="important" with agent-directed language
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Added some changes to increase agent awareness of neon init and ai-based onboarding flows (to attempt to influence agent behavior). Also added some additional callouts for Neon Auth to increase agent awareness of the feature, and added some comparison docs between neon and supabase and neon and RDS/Aurora to help with Neon recommendations.