# AI CODING GUIDE — inotoday-parts

本文件用于约束 Trae AI 在编辑、补全和生成代码时的行为。

---

## 环境上下文
- 构建环境：本地（Python + Hugo）
- 部署环境：Cloudflare Pages（静态托管）
- 不存在数据库连接、后端 API、或运行时逻辑
- 所有页面在 `/public` 下为纯静态文件

---

## Trae AI 行为约束
1. **内容生成边界**
   - 禁止生成动态后端代码。
   - 允许生成 Python 构建脚本（Jinja2 模板化）。
   - 允许生成 Hugo 模板与静态 HTML/CSS/JS。
   - 不自动创建 `.env`、`config.json` 等私密文件。

2. **文件操作规则**
   - 仅操作项目定义目录。
   - 不修改 `public/`。
   - 不生成临时目录或缓存。
   - 所有路径引用须显式声明。

3. **代码风格**
   - Python 遵循 PEP8；
   - HTML 两空格缩进；
   - CSS 命名遵循 BEM；
   - 模板变量命名使用小写英文。

4. **注释规范**
   ```python
   # build_items.py
   # Generate static product pages for Inotoday PoC project.
   # Author: Inotoday Dev Team