project-overview

This skill acts as an authoritative architectural map for the LobeHub repository. It is designed for developers, contributors, and technical researchers who need to navigate the monorepo, understand the complex dependency structure, and grasp the underlying data flow of the LobeHub AI Agent Workspace. By maintaining a deep index of the system's modular architecture, it helps users pinpoint specific logic, ranging from the core frontend SPA and tRPC routing to backend services, database repositories, and cloud-only business modules.

• Detailed architectural overview of the Next.js 16/React 19 monorepo structure.

• Mapping of core layers including Zustand stores, model-runtime, edge-config, and database schemas (Neon PostgreSQL/Drizzle).

• Guidance on locating files across specialized packages like agent-runtime, electron-client-ipc, and builtin-tool suites.

• Clarification of technical stacks such as antd-style, SWR, aHooks, and trpc.

• Contextual explanation of the project's data flow from UI actions through client services to server-side database models.

• Use this skill when you need to understand where specific features are implemented, such as the electron-bridge, web-crawler utilities, or authentication flows.

• Query the tool for help identifying the correct directory for new feature implementation or when troubleshooting dependency injection issues within the monorepo.

• Typical inputs include queries about 'where is the database schema', 'how is the desktop app structured', or 'explain the project architecture'.

• Outputs provide clear paths to relevant directories, file naming conventions, and technical stack utilization guides.