frappe-router

What this skill does

# Frappe Router

Route to the appropriate Frappe skill based on your task.

## When to use

- First step when starting any Frappe-related work
- To determine which specialized skill applies to your task

## Procedure

### 0) Identify task type

| Task | Skill |
|------|-------|
| Understand project structure, versions, apps | → `frappe-project-triage` |
| Scaffold new app, hooks, architecture, background jobs | → `frappe-app-development` |
| Create/modify DocTypes, fields, controllers | → `frappe-doctype-development` |
| Build REST/RPC APIs, webhooks, integrations | → `frappe-api-development` |
| Customize Desk UI, form scripts, list views, JS API | → `frappe-desk-customization` |
| Build Vue 3 frontends with Frappe UI, portals | → `frappe-frontend-development` |
| UI/UX patterns from CRM/Helpdesk/HRMS | → `frappe-ui-patterns` |
| Create print formats, email templates, Jinja, PDFs | → `frappe-printing-templates` |
| Build reports (Builder, Query, Script) | → `frappe-reports` |
| Create public web forms for data collection | → `frappe-web-forms` |
| Write or run tests | → `frappe-testing` |
| Set up dev environment with Docker/FM | → `frappe-manager` |
| Build CRM/Helpdesk/enterprise systems | → `frappe-enterprise-patterns` |

### 1) Run triage first (recommended)

Before deep work, run `frappe-project-triage` to understand:
- Project type (bench/FM/standalone)
- Frappe version
- Installed apps
- Available tooling

### 2) Combine skills as needed

Complex tasks may require multiple skills:
- New app = `frappe-app-development` + `frappe-doctype-development` + `frappe-api-development` + `frappe-testing`
- Feature with UI = `frappe-doctype-development` + `frappe-desk-customization` + `frappe-api-development`
- Custom frontend = `frappe-frontend-development` + `frappe-api-development`
- Document workflow = `frappe-doctype-development` + `frappe-printing-templates` + `frappe-reports`
- Enterprise app = `frappe-enterprise-patterns` + `frappe-doctype-development`

## Quick decision tree

```
Is this about understanding the project?
  → frappe-project-triage

Is this about creating a new app or app architecture?
  → frappe-app-development

Is this about data models or DocTypes?
  → frappe-doctype-development

Is this about APIs or external access?
  → frappe-api-development

Is this about Desk UI, form scripts, or client-side JS?
  → frappe-desk-customization

Is this about a Vue 3 frontend or portal?
  → frappe-frontend-development

Is this about UI/UX patterns or app design?
  → frappe-ui-patterns

Is this about print formats, PDFs, or Jinja templates?
  → frappe-printing-templates

Is this about reports or data analysis views?
  → frappe-reports

Is this about public web forms?
  → frappe-web-forms

Is this about testing?
  → frappe-testing

Is this about local dev environment?
  → frappe-manager

Is this a complex enterprise system?
  → frappe-enterprise-patterns
```

## Guardrails

- **Always run triage first** before making code changes to unknown projects
- **Check Frappe version** before recommending features (API availability varies significantly between v13, v14, v15, v16)
- **Don't assume ERPNext** - many projects use Frappe Framework without ERPNext
- **Verify site context** - commands like `bench migrate` affect specific sites

## Common Mistakes

| Mistake | Why It Fails | Fix |
|---------|--------------|-----|
| Skipping project triage | Applying wrong patterns for version | Always run triage first |
| Using ERPNext-specific code in Frappe-only projects | Module not found errors | Check installed apps first |
| Wrong skill for task | Incomplete implementation | Match task type to skill carefully |
| Ignoring version differences | Deprecated/missing APIs | Check version compatibility in skill references |
| Working on wrong site | Changes don't appear | Always specify `--site` flag |
| Using vanilla JS/jQuery for frontends | Ecosystem mismatch | Use Frappe UI (Vue 3) via `frappe-frontend-development` |
| Custom app shell for CRUD apps | Inconsistent UX | Follow CRM/Helpdesk patterns via `frappe-enterprise-patterns` |