Macro is a document and collaboration app with a Rust backend and a web frontend.
This file is the shared entry point: `AGENTS.md` symlinks to `CLAUDE.md`. Edit
`CLAUDE.md` and preserve
CLAUDE.md — Kiro Crew dashboard (frontend)
**`website/AGENTS.md` is the single source of truth for frontend work in
`website/`.** Read it before any UI change; it is imported below
frontend 模块文档
[← 根目录](../CLAUDE.md)
## 模块职责
Vue 3 + Vuetify 3 Web 管理界面:渠道配置、能力测试、模型列表查询、拖拽排序、监控面板、主题切换。
## 启动命令
```bash
bun run dev # 开发服务器
bun run build # 生产构建
bun run preview
local full/E2E runs share a machine lock, so do not kill a queued run.
- Frontend validation runs through Turborepo from the repo root, with affected-package filters during iteration. Package
Frontend
React SPA using Vite, TanStack Router/Query, Tailwind, shadcn/ui, XState Store, and Zod. Root `CLAUDE.md` owns compatibility and delivery; this file adds web conventions.
## Ownership and Contracts
- Domain features live
keep indentation ≤3 levels and functions single-purpose.
- Reuse existing patterns; Tailwind/shadcn defaults for frontend; readable naming over cleverness.
- Comments only when intent is non-obvious; keep them short.
- Enforce
configs/mcp-gateway.yaml
go run cmd/mock-server/main.go
# Configuration testing
go run cmd/mcp-gateway/main.go test -c configs/mcp-gateway.yaml
```
### Web Frontend
```bash
cd web/
pnpm run dev # development server
pnpm run build # production build
pnpm run lint
team)
- `publish: true` (only if template should appear in dashboard)
### Visual and Content Requirements
- **Frontend Component**: Must have visual UI that clearly demonstrates functionality
- **Preview Image**: Required 16:9 aspect
Apps Component Framework (PCF)
Each PCF control is a self-contained project with TypeScript/React frontend and MSBuild packaging.
**Basic Commands:**
```bash
cd component-framework/[ControlName]
# Install dependencies
npm install
# Build
Project Guidelines
1. All code comments must be written in English.
2. Frontend changes must consider internationalization and include both Chinese and English user-facing text where applicable.
3. When
Frontend Instructions
- When the user asks for UI changes, capture screenshots of the updated UI after implementation and verification.
- At the end, offer to open those screenshots for the user
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.