chore(rebar): Pier_T_rebar 작업 폴더 초기 구성 및 외부 의존 파일 통합

- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-28 11:20:18 +09:00
commit 964a841de1
@@ -0,0 +1,143 @@
+---
+name: bkend-quickstart
+classification: capability
+classification-reason: Pattern guidance may overlap with model's built-in knowledge as it improves
+deprecation-risk: medium
+description: |
+  bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project.
+  Triggers: bkend quickstart, onboarding, setup, MCP, 시작하기, 온보딩.
+user-invocable: false
+agent: hmcmkit:bkend-expert
+allowed-tools:
+  - Read
+  - WebFetch
+  - mcp__bkend__*
+imports:
+  - ${PLUGIN_ROOT}/templates/shared/bkend-patterns.md
+---
+
+# bkend.ai Quick Start Guide
+
+## What is bkend.ai
+
+MCP-based BaaS platform providing Database, Authentication, and Storage services.
+Manage backend via natural language from AI tools (Antigravity Platform, Cursor).
+
+## Resource Hierarchy
+
+```
+Organization (team/billing) -> Project (service unit) -> Environment (dev/staging/prod, data isolation)
+```
+
+## Tenant vs User
+
+- **Tenant**: Service builder (OAuth 2.1 auth, MCP/Management API access)
+- **User**: App end-user (JWT auth, Service API access)
+- One person can have both roles
+
+## MCP Setup (Antigravity Platform)
+
+### Quick Setup (One Command)
+
+```bash
+ai-agent mcp add bkend --transport http https://api.bkend.ai/mcp
+```
+
+### Step-by-Step Guide
+
+1. **Prerequisites**: bkend.ai account (signup at https://console.bkend.ai)
+2. **Run setup command**: `ai-agent mcp add bkend --transport http https://api.bkend.ai/mcp`
+3. **OAuth authentication**: Browser auto-opens for OAuth 2.1 + PKCE auth (no API key needed)
+4. **Verify connection**: Ask "Show my connected bkend projects" or use `get_context` MCP tool
+5. **Create .mcp.json** (optional, for team sharing):
+   ```json
+   {
+     "mcpServers": {
+       "bkend": {
+         "type": "http",
+         "url": "https://api.bkend.ai/mcp"
+       }
+     }
+   }
+   ```
+
+### Troubleshooting MCP Connection
+
+| Problem | Solution |
+|---------|----------|
+| OAuth popup not appearing | Check browser popup blocker |
+| MCP tools not visible | Run `ai-agent mcp list` to verify, re-add if needed |
+| Connection lost | Re-authenticate (automatic on next MCP call) |
+| Wrong project/env | Use `get_context` to check current session |
+
+## MCP Fixed Tools
+
+| Tool | Purpose |
+|------|---------|
+| `get_context` | Session context (org/project/env, API endpoint) |
+| `search_docs` | Search bkend documentation |
+| `get_operation_schema` | Get tool input/output schema |
+
+## Searchable Guides (via search_docs)
+
+| Doc ID | Content |
+|--------|---------|
+| `1_concepts` | BSON schema, permissions, hierarchy |
+| `2_tutorial` | Project~table creation tutorial |
+
+## MCP Project Management Tools
+
+| Tool | Purpose | Key Parameters |
+|------|---------|----------------|
+| `backend_org_list` | List organizations | None |
+| `backend_project_list` | List projects | organizationId |
+| `backend_project_get` | Get project detail | organizationId, projectId |
+| `backend_project_create` | Create project | organizationId, name, description? |
+| `backend_project_update` | Update project | organizationId, projectId, name?, description? |
+| `backend_project_delete` | Delete project (irreversible!) | organizationId, projectId |
+| `backend_env_list` | List environments | organizationId, projectId |
+| `backend_env_get` | Get environment detail | organizationId, projectId, environmentId |
+| `backend_env_create` | Create environment | organizationId, projectId, name |
+
+## MCP Resources (Read-Only)
+
+Lightweight, cached (60s TTL) read-only queries via bkend:// URI:
+
+| URI | Description |
+|-----|-------------|
+| `bkend://orgs` | Organization list |
+| `bkend://orgs/{orgId}/projects` | Project list |
+| `bkend://orgs/{orgId}/projects/{pId}/environments` | Environment list |
+| `bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tables` | Table list with schema |
+
+**Tip**: Prefer Resources over Tools for listing operations (lighter, cached).
+
+## First Project Checklist
+
+1. Sign up at bkend.ai -> Create Organization
+2. Create Project -> dev environment auto-created
+3. Connect MCP -> `ai-agent mcp add bkend`
+4. Create first table -> "Create a users table"
+5. Start data operations -> CRUD via natural language
+
+## Console URL
+
+```
+https://console.bkend.ai
+```
+
+## Next Steps
+
+- Database operations: refer to bkend-data skill
+- Authentication: refer to bkend-auth skill
+- File storage: refer to bkend-storage skill
+- Practical tutorials: refer to bkend-cookbook skill
+
+## Official Documentation (Live Reference)
+
+For the latest bkend documentation, use WebFetch:
+- Quick Start: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/02-quick-start.md
+- Core Concepts: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/03-core-concepts.md
+- Antigravity Platform Setup: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/ai-tools/04-ai-agent-code-setup.md
+- MCP Overview: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/01-overview.md
+- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md