# AGENTS Rules

`localbox部署` 只负责本地部署和本地联调。`chatapp3` 的线上部署已经迁移到 `hy-app-monitor`。

## 仓库结构

- 仓库根目录保留统一入口 `./deploy.sh`
- 本地脚本和 compose 文件都放在仓库根目录
- `local-infra/` 只存放本地 MySQL / RocketMQ 初始化文件
- `.env.local` 放在仓库根目录
- `var/` 只存放本地缓存和构建产物，不提交到仓库
- 默认自动识别 `../../chatapp3/chatapp3-java` 和 `../../chatapp3/chatapp3-golang`；路径不同再用环境变量覆盖

## 必须遵守

- 只使用仓库根目录 `./deploy.sh` 作为推荐入口
- 本地构建依赖 `chatapp3-java` 和 `chatapp3-golang` sibling 仓库
- Java 私有 Maven 包只来自 `chatapp3-java/maven_private`
- 所有新增能力都必须服务于本地启动、本地构建、本地检查、本地重启或本地 Nacos 配置发布

## 禁止

- 禁止重新引入 `gitea/`、`tencent-prod/`、Jenkins、发布控制台、Harbor、远程部署、回滚、云侧同步相关代码
- 禁止重新引入 `.env.prod`、发布编排、线上 Nacos 发布、TAT、COS 等链路
- 禁止新增与本地部署无关的目录、脚本或入口