tianole/AGENTS.md

Tianole Agent Guide

这个文件是仓库内 agent 文档的入口。

文档位置

• 正式设计、路线图、架构说明放在 docs/
• 面向 agent 的任务、会话记录、检查单放在 docs/agents/

工作规则

• agent 修改代码前，先确认相关正式文档是否已经存在。
• agent 修改代码后，如果改动影响了架构边界、目录结构、构建方式、阶段计划或操作流程，必须同步更新 docs/ 或 docs/agents/。
• 纯粹的小修复如果不改变这些信息，可以不额外补文档。

推荐同步范围

• 结构变化：更新 docs/roadmap.md
• agent 协作约定变化：更新 docs/agents/README.md
• 阶段性实现记录：在 docs/agents/ 下新增对应笔记

当前约定

• 当前代码以“先做最小，但不把架构完全写死”为原则推进。
• arch/ 放架构相关实现。
• include/tianole/ 放尽量与具体架构无关的共享接口。