docs: update README to reflect flat root structure

Author: Rodriguespn

README.md

@@ -1,22 +1,41 @@
 # Supabase Plugin
 
-The official Supabase plugin for AI coding assistants. One plugin, distributed to all supported platforms simultaneously.
+The official Supabase plugin for AI coding assistants. One repo, distributed to all supported platforms simultaneously.
 
 ## Supported Platforms
 
-| Platform | Package | Install |
-|---|---|---|
-| [Claude Code](https://claude.ai/code) | [`packages/claude-code`](packages/claude-code) | — |
-| [Cursor](https://cursor.com) | [`packages/cursor`](packages/cursor) | — |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | [`packages/gemini`](packages/gemini) | `gemini extensions install https://github.com/supabase-community/supabase-plugin` |
-| [Codex](https://codex.openai.com) | [`packages/codex`](packages/codex) | — |
+| Platform | Install |
+|---|---|
+| [Claude Code](https://claude.ai/code) | See [docs/claude-code.md](docs/claude-code.md) |
+| [Cursor](https://cursor.com) | See [docs/cursor.md](docs/cursor.md) |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini extensions install https://github.com/supabase-community/supabase-plugin` |
+| [Codex](https://openai.com/codex) | See [docs/codex.md](docs/codex.md) |
 
 ## What's Included
 
-Each platform package contains:
+- **MCP Server** (`mcp.json`) — Remote connection to the [Supabase MCP server](https://supabase.com/mcp) for project management, SQL execution, migrations, and more
+- **Skills** (`skills/`) — Agent skills from [supabase/agent-skills](https://github.com/supabase/agent-skills):
+  - `supabase` — General Supabase guidance for Auth, Storage, Edge Functions, Realtime, and more
+  - `supabase-postgres-best-practices` — Postgres performance optimization and schema best practices
+- **Gemini Extension** (`gemini-extension.json`) — Gemini CLI extension manifest
+- **Context** (`SUPABASE.md`) — Shared context file loaded by Gemini and other platforms
 
-- **MCP Server** — Remote connection to the [Supabase MCP server](https://supabase.com/mcp) for project management, SQL execution, migrations, and more
-- **Skills** — Agent skills from [supabase/agent-skills](https://github.com/supabase/agent-skills) including `supabase` and `supabase-postgres-best-practices`
+## Repository Structure
+
+```
+supabase-plugin/
+├── mcp.json                    # MCP server config (mcpServers wrapper format)
+├── gemini-extension.json       # Gemini CLI extension manifest
+├── SUPABASE.md                 # Shared context loaded by Gemini
+├── assets/
+│   └── logo.svg
+├── skills/                     # Symlink → submodules/agent-skills/skills/supabase*
+│   ├── supabase/
+│   └── supabase-postgres-best-practices/
+├── submodules/
+│   └── agent-skills/           # git submodule: github.com/supabase/agent-skills
+└── docs/                       # Per-platform install guides
+```
 
 ## Development
 
@@ -25,6 +44,7 @@ This repo uses a git submodule for shared agent skills.
 After cloning, initialize the submodule:
 
 ```bash
+git clone https://github.com/supabase-community/supabase-plugin
 git submodule update --init --recursive
 ```
 
@@ -38,10 +58,10 @@ git commit -m "chore: update agent-skills submodule"
 
 ## Releasing
 
-This repo uses [Release Please](https://github.com/googleapis/release-please) for automated releases. A single release bumps the version in all four platform packages simultaneously.
+This repo uses [Release Please](https://github.com/googleapis/release-please) for automated releases.
 
-1. Merge commits with `feat:` or `fix:` prefixes to trigger a release
-2. Release Please opens a release PR with version bump and changelog
+1. Merge commits with `feat:` or `fix:` prefixes to trigger a release PR
+2. Release Please opens a PR with version bump and changelog
 3. Merge the release PR to publish
 4. Four platform archives are uploaded to the GitHub release:
    - `supabase-claude-code-plugin.tar.gz`