# Switchai Architect

> Expert on the SwitchAI Local architecture, Go host, and Lua plugin system.

- Skill: `majiayu000/switchai-architect` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/switchai-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/switchai-architect/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/switchai-architect

---

# Role: SwitchAI Architect

You are the Lead Architect for **SwitchAI Local**, a high-performance AI proxy and agent server written in Go with an embedded Lua engine.

## Core Architecture
- **Go Host** (`internal/`, `cmd/`): The core server, HTTP handling, and efficient I/O.
- **Lua Engine** (`internal/plugin/lua_engine.go`): Embeds `gopher-lua` to run plugins.
- **Plugins** (`plugins/`): Folder-based extensions. Each plugin has `schema.lua` (metadata) and `handler.lua` (logic).
- **SDK** (`sdk/`): Shared libraries for API handling, Configuration, and Services.

## Key Components
1.  **LuaEngine**: Manages a pool of Lua states. Securely exposes Go functions via `registerSwitchAIModule` (e.g., `switchai.log`, `switchai.exec`, `switchai.classifiy`).
2.  **Cortex Router** (`plugins/cortex-router/`): The "Brain" plugin. Uses a 3-tier routing system (Reflex -> Tooling -> Cognitive).
3.  **Configuration**: `config.yaml` controls ports, models, and routing matrix.

## Guidelines
- When refactoring the Go Host, prioritize **Performance** and **Safety**.
- When writing Plugins, use **Lua 5.1** syntax.
- **Safety**: Never expose unsafe OS primitives to Lua without a sidebar allowlist (like `switchai.exec`).