Lovrabet Development Workflow (Routing Guide)

Lovrabet is known as Yuntoo in Chinese, often written as yuntoo. This document is a Routing Guide that tells you which tool/document to use in which scenario.

For detailed SDK usage and parameter examples, prioritize reading

./guides/*.md

; if you need the latest public documentation, use Context7 for queries instead of treating the rules file as a complete SDK manual.

Mandatory Reading Rules (Cannot Be Skipped)

In the following cases, you must first use the Read tool to read the corresponding file. It is prohibited to answer or execute directly relying on memory:

Trigger Condition	File to Be Read
Create / Modify / Save SQL	`./guides/02-mcp-sql-workflow.md`
Involves SQL local storage, directory specifications	`./guides/07-sql-creation-workflow.md`
Create / Modify / Save BFF Script	`./guides/08-bff-creation-workflow.md`
Involves BFF local storage, directory specifications	`./guides/05-backend-function.md`
Encounters conflict prompts / blocked / confirmationRequired	`./guides/09-conflict-detection.md`
Use TypeScript SDK / filter / sql.execute	`./guides/01-typescript-sdk.md`
Data interface design, multi-table association, performance optimization	`./guides/06-data-api-guidelines.md`
Error reporting, abnormal behavior, unable to determine the cause	`./guides/04-troubleshooting.md`

Execution Sequence: Read the corresponding guide → Call MCP tool → Answer the user.

Local Draft Directory (Custom SQL / BFF)

SQL: Maintain
```
.sql
```
files under the project src/custom_sql/
directory by business function. After saving, use the content for MCP verification and storage; see
```
02-mcp-sql-workflow.md
```
and
```
07-sql-creation-workflow.md
```
for details.
BFF: Store under the project src/backend-function/
directory according to
```
05-backend-function.md
```
(ENDPOINT in
```
endpoint/
```
, HOOK in table name subdirectories); synchronize to the platform after saving; see
```
05-backend-function.md
```
and
```
08-bff-creation-workflow.md
```
for details.
It is recommended to include the above business directories in Git.

Precondition Detection

Detect if MCP is Available (Required)

Detection method: Try to call any Lovrabet-related MCP tool
- Look for MCP tools with tool names containing "lovrabet" or "dataset"
- Common tools: get_auth_status, list_datasets, get_dataset_detail
- ✅ Found → MCP is available, continue
- ❌ Not found → Prompt user: lovrabet mcp install

Note: The MCP server name may be customized and not necessarily called

lovrabet-dataset

Tool Routing Rules

Query and Analysis → Use MCP Tools

Scenario	MCP Tool to Use
List all datasets	`list_datasets`
Search datasets	`search_datasets`
Get dataset details	`get_dataset_detail`
Execute saved SQL	`execute_custom_sql`
List SQL queries	`list_sql_queries`
List BFF scripts	`list_bff_scripts`
Get BFF details	`get_bff_script_info`
Generate SDK code	`generate_sdk_code`
Generate SQL code	`generate_sql_code`

Rule: Call MCP tools directly, do not generate scripts

Verification and Saving → Use MCP Tools (Including Conflict Detection)

Scenario	MCP Tool to Use	Description
Validate SQL syntax	`validate_sql_content`	Static syntax + optional schema validation
Save SQL	`save_or_update_custom_sql`	Via toolbox, automatic conflict detection
Save BFF	`save_or_update_bff_script`	Via toolbox, automatic conflict detection

Conflict Handling: When the save tool returns

blocked: true

(e.g., another user is the last submitter), inform the user to handle it manually on the platform. Do not automatically retry the same save. Fields like

confirmationRequired

nextAction

shall be subject to the tool's return; see

09-conflict-detection.md

for details.

BFF Write MCP: If

list_bff_scripts

save_or_update_bff_script

are not visible, add

--enable-bff-save

to the dataset MCP startup parameters; the old name

--dangerously-bff-save

is still available; see "Platform Synchronization and Collaboration Quick Reference" in

08-bff-creation-workflow.md

for details.

Quick Decision Tree

User Request
    │
    ├─ Query data?
    │   └─ Use MCP: execute_custom_sql / generate_sql_code
    │
    ├─ Create/modify SQL?
    │   ├─ 0. Read ./guides/02-mcp-sql-workflow.md (Required)
    │   ├─ 1. Use MCP: get_dataset_detail (Understand structure)
    │   ├─ 2. Generate SQL code
    │   ├─ 3. Use MCP: validate_sql_content (Validate)
    │   ├─ 4. Use MCP: save_or_update_custom_sql (Save, including conflict detection)
    │   └─ 5. Use MCP: execute_custom_sql (Test)
    │
    ├─ Create/modify BFF?
    │   ├─ 0. Read ./guides/08-bff-creation-workflow.md (Required)
    │   ├─ 1. Generate BFF code
    │   └─ 2. Use MCP: save_or_update_bff_script (Save, including conflict detection)
    │
    ├─ Generate SDK code?
    │   └─ Use MCP: generate_sdk_code
    │
    └─ Unsure?
        └─ Read `./guides/04-troubleshooting.md`

Complete Guides Index

It is recommended to install via
npx skills add lovrabet/lovrabet-skill
, after which the guides are in the
./guides/
directory at the same level as this document. If the team switches to using Lovrabet CLI to install from the company CDN, the actual path shall be subject to the CLI storage location (see the project's README).

User Requirement	Reference Guide Document
Use TypeScript SDK	`./guides/01-typescript-sdk.md`
Create custom SQL (MCP mode)	`./guides/02-mcp-sql-workflow.md`
React frontend development	`./guides/03-frontend-development.md`
Troubleshooting	`./guides/04-troubleshooting.md`
Create BFF scripts	`./guides/05-backend-function.md`
Data interface specifications	`./guides/06-data-api-guidelines.md`
SQL creation workflow	`./guides/07-sql-creation-workflow.md`
BFF creation, synchronization and collaboration	`./guides/08-bff-creation-workflow.md`
Conflict detection and handling	`./guides/09-conflict-detection.md`
Team collaboration best practices	`./guides/10-best-practices.md`

Configuration File Location

Guides Directory:
```
./guides/
```

lovrabet

NPX Install

Tags

SKILL.md Content (Chinese)