feature: development workflows references

[Rodriguespn]

Summary

Adds 7 development reference files that define how agents should interact with Supabase instances — which tools to use, correct workflows for local and remote development, and clear boundaries between CLI, psql, MCP, and the SDK. Restructures SKILL.md to load development guidance first.

Development References (7 files)

File	Purpose
dev-getting-started.md	New project setup, CLI install, Docker prerequisites, first-time init
dev-local-workflow.md	Local development cycle: CLI migrations, db reset, psql debugging, type generation
dev-remote-workflow.md	Remote project interaction: MCP queries/logs/advisors, CLI for deployment
dev-cli-vs-mcp.md	Tool role decision guide — when to use CLI, psql, MCP, or the SDK
dev-cli-reference.md	CLI command details, key flags, pitfalls, and decision guides (pull vs diff, push vs up)
dev-mcp-setup.md	Supabase remote MCP server configuration, URL parameters, authentication, security rules
dev-mcp-tools.md	execute_sql, apply_migration, get_logs, get_advisors — usage, gotchas, and the apply_migration last-resort rule

Tool Role Model

The references establish three distinct tool roles:

• CLI (npx supabase) — all schema changes, project management, and deployment
• psql (local) / MCP (remote) — agent database access for debugging and inspection only
• supabase-js SDK — application database client (all DB interaction in the user's app code)

Schema changes always go through CLI migrations. psql and MCP are never used for DDL or in application code.

SKILL.md Restructuring

• Development Guidance is now the first section in the body, before the resource tables
• Points agents to the correct reference file for each decision instead of restating rules inline
• Development is the first resource section, marked with "(read first)" and a strong directive
• Every other section (Auth, Database, Edge Functions, etc.) now has a "when to read" intro line
• description field updated to trigger on development workflow context

[Rodriguespn]

@sweatybridge commented on closed PR

just some minor comments. I wonder if we can include supabase test db as one of the skills?

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (2)

• !master
• !main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/mcp-agent-references

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}