blog: What to Put in Your AGENTS.md So Your Agent Handles the Database Right - #8083
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Repository UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
🚧 Files skipped from review as they are similar to previous changes (1)
WalkthroughAdds a new MDX blog article with metadata, five database workflow rules for AI coding agents, a copyable ChangesDatabase agent workflow guide
Estimated code review effort: 2 (Simple) | ~10 minutes 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
|
The latest updates on your projects. Learn more about Argos notifications ↗︎
|
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 2
🧹 Nitpick comments (1)
apps/blog/content/blog/agents-md-for-databases/index.mdx (1)
112-112: 🔒 Security & Privacy | 🔵 Trivial | ⚡ Quick winClarify MCP authentication and workspace scope.
This paragraph lists privileged actions, but it should also state that the server authenticates with Prisma Console on first use and only accesses the workspace the user selects. Add that prerequisite and a brief reminder to review the chosen workspace before enabling it.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@apps/blog/content/blog/agents-md-for-databases/index.mdx` at line 112, Update the paragraph describing the Prisma MCP server to state that first use requires authentication with Prisma Console, access is limited to the workspace selected by the user, and users should review that workspace before enabling the server. Preserve the existing description of its tools and capabilities.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@apps/blog/content/blog/agents-md-for-databases/index.mdx`:
- Around line 43-49: Update the “Destructive commands require a human” guidance
to exclude Prisma’s guarded commands, especially prisma migrate reset, from the
throwaway-database exception. State that the exception applies only to
destructive SQL operations not covered by Prisma’s consent guardrail, while
preserving the requirement to obtain explicit human approval for guarded Prisma
commands.
- Line 39: Update the paragraph describing the create-db region behavior so it
states that omitting --region defaults to us-east-1. Remove the unsupported
claim that the CLI selects the nearest region, while preserving the explanation
of the six selectable regions.
---
Nitpick comments:
In `@apps/blog/content/blog/agents-md-for-databases/index.mdx`:
- Line 112: Update the paragraph describing the Prisma MCP server to state that
first use requires authentication with Prisma Console, access is limited to the
workspace selected by the user, and users should review that workspace before
enabling the server. Preserve the existing description of its tools and
capabilities.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: d7224fff-c298-4e88-a053-5e3af042d9a0
⛔ Files ignored due to path filters (2)
apps/blog/public/agents-md-for-databases/imgs/hero.svgis excluded by!**/*.svgapps/blog/public/agents-md-for-databases/imgs/meta.pngis excluded by!**/*.png
📒 Files selected for processing (1)
apps/blog/content/blog/agents-md-for-databases/index.mdx
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.
Summary
New blog post: five copy-pasteable AGENTS.md database rules for AI coding agents, covering scratch databases via
npx create-db --json, destructive-command policy (with the ORM 6.15.0 guardrails as the enforcement layer), migration rehearsal on throwaway databases,--jsonoutput, and connection-string hygiene. Works in Codex and Cursor natively and in Claude Code through a one-line@AGENTS.mdimport.Companion piece to Your AI Agent Needs a Database. Give It One in Five Seconds.
Includes hero.svg (Eclipse house style, embedded brand fonts) and meta.png (1200x630, 251 KB).
Verification
@AGENTS.mdimport confirmed in official Claude Code docs, AGENTS.md origin confirmed against agents.md.Note
The create-db docs page (
apps/docs/content/docs/postgres/npx-create-db.mdx) still claims the default region is us-east-1, but the shipped CLI geo-detects the closest region and only falls back to us-east-1. The post describes the real behavior; the docs fix is tracked separately.Summary by CodeRabbit