Add setup instructions and additional tools for Supabase database administrator agent

[stephschofield]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, or chat mode with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

---

Description

The Supabase Database Administrator agent fills a specialized niche for Supabase-specific database development and administration.

1. MCP Server Integration Pioneer

• One of the first agents demonstrating comprehensive integration with an MCP (Model Context Protocol) server
• Shows how to leverage 20+ specialized MCP tools for real-time database operations
• Provides a clear template for other MCP-based agents

2. Production-Ready Database Management

• Goes beyond basic SQL assistance to include enterprise concerns:
  • Row Level Security (RLS) policy design and auditing
  • Migration management with safety protocols
  • Cost estimation and confirmation workflows
  • Security vulnerability assessment frameworks
  • Performance optimization strategies

3. Guided Onboarding Workflow

• Includes a sophisticated initial project check that prevents assumptions
• Handles three user scenarios: existing project, new project creation, or no-database mode
• Walks users through complete MCP server setup with exact configuration

4. Dual-Mode Operation

• Supabase Mode: Full database operations via MCP
• JSONL Mode: File-based alternative for prototyping without infrastructure
• Provides migration paths from JSONL to Supabase when users are ready

5. Security-First Approach

• Comprehensive security review framework with checklists
• Templated RLS policies, secure functions, and audit logging
• Risk-tiered recommendations (Critical/High/Medium/Low)
• Real-world patterns for preventing SQL injection and data exposure

6. Domain Expertise Embodiment

• Specialized knowledge of PostgreSQL, Supabase platform specifics, and database security
• Not a generic database agent—deeply tailored to Supabase's ecosystem and best practices
• Includes Supabase-specific extensions (pg_vector, PostGIS, pg_cron)

7. Developer Experience Focus

• TypeScript type generation support
• Clear cost transparency before creating billable resources
• Migration safety protocols (test locally first, reversible changes)
• Explicit confirmation for destructive operations

Gap It Fills

This agent addresses developers who:

• Build applications on Supabase (a growing PostgreSQL-based BaaS platform)
• Need expert guidance on RLS policies (a Supabase strength but complex feature)
• Want to leverage Supabase's MCP server for agent-assisted database work
• Require security auditing capabilities for their database schemas
• Are exploring Supabase but need hand-holding through setup

Unlike generic database or SQL agents in the repository, this agent:

• Requires external setup (MCP server) but provides much deeper capabilities
• Operates as a specialized consultant rather than a general assistant
• Includes operational workflows (cost confirmation, migration safety) beyond just code generation
• Bridges the gap between development and database administration roles

---

Type of Contribution

• New instruction file.
• New prompt file.
• New chat mode file.
• New collection file.
• Update to existing instruction, prompt, chat mode, or collection.
• Other (please specify):

---

Additional Notes

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[Copilot]

Pull request overview

This pull request adds a comprehensive Supabase database administrator agent with detailed setup instructions and MCP server integration guidance. The agent provides extensive capabilities for database development, security auditing, and migration management.

• Adds a new agent file with extensive documentation for Supabase database administration
• Includes setup instructions for the Supabase MCP server
• Provides alternative JSONL-based data storage mode for projects without a database
• Updates the README to include the new agent in the agents list

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
agents/supabase-dba.agent.md	New comprehensive agent file for Supabase database administration with MCP server integration, security frameworks, and JSONL fallback mode
docs/README.agents.md	Adds new entry for Supabase database administrator agent in alphabetical order

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.