本文档由 g2rain-agent-runtime 的 docs/development/code-conventions.md 自动同步生成。

# 代码规范

• 保持 startup -> biz -> api 依赖方向；不以便利为由跨层引用实现。
• 领域状态、节点迁移和副作用必须使用明确类型表达，避免以散落字符串隐式约定。
• Controller 只完成协议适配；业务决策放在 Service/Domain；持久化隔离在 DAO。
• 新增运行时状态、事件、工具或恢复动作时，必须同步更新状态、事件或契约文档。
• 日志和异常信息应使用关联 ID，且不得输出提示词全文、密钥、Token 或工具敏感参数。