# dkm0315/frappe-agent architecture

> Architecture diagram of the GitHub repository dkm0315/frappe-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dkm0315/frappe-agent
- Repository: https://github.com/dkm0315/frappe-agent

## Overview

Frappe Agent is a set of Frappe-specific coding-assistant instructions, commands, and skills—not a standalone application runtime. A user asks a supported assistant for help; the assistant uses the repository’s guidance to provide Frappe-aware recommendations. The README documents assistant packaging and major skill areas, but no source excerpts were supplied, so internal dispatch and individual command-to-skill relationships cannot be verified.

Main entry points: [`skills`](https://github.com/dkm0315/frappe-agent/tree/main/skills) (Guidance Skills), [`commands`](https://github.com/dkm0315/frappe-agent/tree/main/commands) (Guidance Commands), [`skills/frappe-backend/SKILL.md`](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-backend/SKILL.md) (Backend), [`skills/frappe-frontend/SKILL.md`](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-frontend/SKILL.md) (Frontend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Assistant Interfaces"]
  node_assistant["Coding Assistant"]
  node_commands["Guidance Commands"]
  node_skills["Guidance Skills"]
end

subgraph group_core["Frappe Core Guidance"]
  node_backend["Backend<br/>[SKILL.md]"]
  node_frontend["Frontend<br/>[SKILL.md]"]
  node_bench["Bench Operations<br/>[SKILL.md]"]
  node_sql["SQL and ORM<br/>[SKILL.md]"]
  node_customization["Customization<br/>[SKILL.md]"]
  node_doctype["DocType Design<br/>[SKILL.md]"]
  node_search["Search<br/>[SKILL.md]"]
  node_fullstack["Full Stack<br/>[SKILL.md]"]
end

subgraph group_ecosystem["Ecosystem Guidance"]
  node_erpnext["ERPNext<br/>[SKILL.md]"]
  node_helpdesk["Helpdesk<br/>[SKILL.md]"]
  node_crm["CRM<br/>[SKILL.md]"]
  node_lms["LMS<br/>[SKILL.md]"]
  node_gameplan["Gameplan<br/>[SKILL.md]"]
  node_drive["Drive<br/>[SKILL.md]"]
  node_hrms["HRMS<br/>[SKILL.md]"]
  node_insights["Insights<br/>[SKILL.md]"]
  node_builder["Builder<br/>[SKILL.md]"]
  node_payments["Payments<br/>[SKILL.md]"]
end

subgraph group_platforms["Assistant Packages"]
  node_codex["Codex Package<br/>[plugin.json]"]
  node_claude["Claude Package<br/>[plugin.json]"]
  node_cursor["Cursor Guidance<br/>[frappe-agent.mdc]"]
  node_copilot["Copilot Guidance"]
end

node_user(("Developer"))

node_user -->|"asks for guidance"| node_assistant
node_assistant -->|"uses commands"| node_commands
node_assistant -->|"uses skills"| node_skills
node_skills -->|"covers"| node_backend
node_skills -->|"covers"| node_frontend
node_skills -->|"covers"| node_bench
node_skills -->|"covers"| node_sql
node_skills -->|"covers"| node_customization
node_skills -->|"covers"| node_doctype
node_skills -->|"covers"| node_search
node_skills -->|"covers"| node_fullstack
node_skills -->|"covers"| node_erpnext
node_skills -->|"covers"| node_helpdesk
node_skills -->|"covers"| node_crm
node_skills -->|"covers"| node_lms
node_skills -->|"covers"| node_gameplan
node_skills -->|"covers"| node_drive
node_skills -->|"covers"| node_hrms
node_skills -->|"covers"| node_insights
node_skills -->|"covers"| node_builder
node_skills -->|"covers"| node_payments
node_assistant -->|"supports"| node_codex
node_assistant -->|"supports"| node_claude
node_assistant -->|"supports"| node_cursor
node_assistant -->|"supports"| node_copilot

click node_commands "https://github.com/dkm0315/frappe-agent/tree/main/commands"
click node_skills "https://github.com/dkm0315/frappe-agent/tree/main/skills"
click node_backend "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-backend/SKILL.md"
click node_frontend "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-frontend/SKILL.md"
click node_bench "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-bench/SKILL.md"
click node_sql "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-sql/SKILL.md"
click node_customization "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-customization/SKILL.md"
click node_doctype "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-doctype-design/SKILL.md"
click node_search "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-search/SKILL.md"
click node_fullstack "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-fullstack/SKILL.md"
click node_erpnext "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-erpnext/SKILL.md"
click node_helpdesk "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-helpdesk/SKILL.md"
click node_crm "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-crm/SKILL.md"
click node_lms "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-lms/SKILL.md"
click node_gameplan "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-gameplan/SKILL.md"
click node_drive "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-drive/SKILL.md"
click node_hrms "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-hrms/SKILL.md"
click node_insights "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-insights/SKILL.md"
click node_builder "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-builder/SKILL.md"
click node_payments "https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-payments/SKILL.md"
click node_codex "https://github.com/dkm0315/frappe-agent/blob/main/.codex-plugin/plugin.json"
click node_claude "https://github.com/dkm0315/frappe-agent/blob/main/.claude-plugin/plugin.json"
click node_cursor "https://github.com/dkm0315/frappe-agent/blob/main/.cursor/rules/frappe-agent.mdc"
click node_copilot "https://github.com/dkm0315/frappe-agent/blob/main/.github/copilot-instructions.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_assistant,node_commands,node_skills toneBlue
class node_backend,node_frontend,node_bench,node_sql,node_customization,node_doctype,node_search,node_fullstack toneAmber
class node_erpnext,node_helpdesk,node_crm,node_lms,node_gameplan,node_drive,node_hrms,node_insights,node_builder,node_payments toneMint
class node_codex,node_claude,node_cursor,node_copilot toneRose
class node_user toneIndigo
```

## Components

### Assistant Interfaces

- **Coding Assistant**
- [Guidance Commands](https://github.com/dkm0315/frappe-agent/tree/main/commands): `commands`
- [Guidance Skills](https://github.com/dkm0315/frappe-agent/tree/main/skills): `skills`

### Frappe Core Guidance

- [Backend](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-backend/SKILL.md): `skills/frappe-backend/SKILL.md`
- [Frontend](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-frontend/SKILL.md): `skills/frappe-frontend/SKILL.md`
- [Bench Operations](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-bench/SKILL.md): `skills/frappe-bench/SKILL.md`
- [SQL and ORM](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-sql/SKILL.md): `skills/frappe-sql/SKILL.md`
- [Customization](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-customization/SKILL.md): `skills/frappe-customization/SKILL.md`
- [DocType Design](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-doctype-design/SKILL.md): `skills/frappe-doctype-design/SKILL.md`
- [Search](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-search/SKILL.md): `skills/frappe-search/SKILL.md`
- [Full Stack](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-fullstack/SKILL.md): `skills/frappe-fullstack/SKILL.md`

### Ecosystem Guidance

- [ERPNext](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-erpnext/SKILL.md): `skills/frappe-erpnext/SKILL.md`
- [Helpdesk](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-helpdesk/SKILL.md): `skills/frappe-helpdesk/SKILL.md`
- [CRM](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-crm/SKILL.md): `skills/frappe-crm/SKILL.md`
- [LMS](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-lms/SKILL.md): `skills/frappe-lms/SKILL.md`
- [Gameplan](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-gameplan/SKILL.md): `skills/frappe-gameplan/SKILL.md`
- [Drive](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-drive/SKILL.md): `skills/frappe-drive/SKILL.md`
- [HRMS](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-hrms/SKILL.md): `skills/frappe-hrms/SKILL.md`
- [Insights](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-insights/SKILL.md): `skills/frappe-insights/SKILL.md`
- [Builder](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-builder/SKILL.md): `skills/frappe-builder/SKILL.md`
- [Payments](https://github.com/dkm0315/frappe-agent/blob/main/skills/frappe-payments/SKILL.md): `skills/frappe-payments/SKILL.md`

### Assistant Packages

- [Codex Package](https://github.com/dkm0315/frappe-agent/blob/main/.codex-plugin/plugin.json): `.codex-plugin/plugin.json`
- [Claude Package](https://github.com/dkm0315/frappe-agent/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Cursor Guidance](https://github.com/dkm0315/frappe-agent/blob/main/.cursor/rules/frappe-agent.mdc): `.cursor/rules/frappe-agent.mdc`
- [Copilot Guidance](https://github.com/dkm0315/frappe-agent/blob/main/.github/copilot-instructions.md): `.github/copilot-instructions.md`

### Other components

- **Developer**

## Connections

- Developer → Coding Assistant: asks for guidance (evidence: `README.md`)
- Coding Assistant → Guidance Commands: uses commands (evidence: `README.md`)
- Coding Assistant → Guidance Skills: uses skills (evidence: `README.md`)
- Guidance Skills → Backend: covers (evidence: `README.md`)
- Guidance Skills → Frontend: covers (evidence: `README.md`)
- Guidance Skills → Bench Operations: covers (evidence: `README.md`)
- Guidance Skills → SQL and ORM: covers (evidence: `README.md`)
- Guidance Skills → Customization: covers (evidence: `README.md`)
- Guidance Skills → DocType Design: covers (evidence: `README.md`)
- Guidance Skills → Search: covers (evidence: `README.md`)
- Guidance Skills → Full Stack: covers (evidence: `README.md`)
- Guidance Skills → ERPNext: covers (evidence: `README.md`)
- Guidance Skills → Helpdesk: covers (evidence: `README.md`)
- Guidance Skills → CRM: covers (evidence: `README.md`)
- Guidance Skills → LMS: covers (evidence: `README.md`)
- Guidance Skills → Gameplan: covers (evidence: `README.md`)
- Guidance Skills → Drive: covers (evidence: `README.md`)
- Guidance Skills → HRMS: covers (evidence: `README.md`)
- Guidance Skills → Insights: covers (evidence: `README.md`)
- Guidance Skills → Builder: covers (evidence: `README.md`)
- Guidance Skills → Payments: covers (evidence: `README.md`)
- Coding Assistant → Codex Package: supports (evidence: `README.md`)
- Coding Assistant → Claude Package: supports (evidence: `README.md`)
- Coding Assistant → Cursor Guidance: supports (evidence: `README.md`)
- Coding Assistant → Copilot Guidance: supports (evidence: `README.md`)
