# 项目约定

本仓库包含两个独立项目，按目录分别管理代码、依赖、配置与运行命令。

- `miniprogram/`：Taro React 小程序。Node 配置、`package.json`、pnpm 锁文件、`node_modules/` 和 Taroify skill 均归属此目录。涉及小程序时，先读取 [小程序约定](miniprogram/AGENTS.md)，在该目录执行 pnpm 命令。
- `backend/`：Go + PostgreSQL 后端。Go 模块、Dockerfile、Compose、环境配置及开发脚本均归属此目录。使用 Go、Docker 和 shell 命令开发，不依赖 Node.js。

根目录仅保留版本控制、说明文档和通用仓库约定，不建立根级 Node 包或 pnpm workspace。

修改小程序后，在 `miniprogram/` 执行 `pnpm typecheck` 和 `pnpm build`。修改后端后，在 `backend/` 执行 `go vet ./...`、`go test -race ./...` 和 `go build -o bin/api ./cmd/server`；部署配置变更另需检查 Compose 和镜像构建。仅报告实际执行的验证。

## Agent skills

### Issue tracker

任务使用本地 Markdown 跟踪；读写事项或规格前，先读 `docs/agents/issue-tracker.md`。

### Triage labels

采用默认的五个分流标签；分流事项前，先读 `docs/agents/triage-labels.md`。

### Domain docs

采用 single-context 布局；探索代码库前，先读 `docs/agents/domain.md`。