docs: refresh AGENTS and readme structure

workflow/AGENTS.md

@@ -1,30 +1,43 @@
 # Workflow 目录 Agent 指南
 
-## 目录用途
+`workflow/` 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。
 
-`workflow/` 存放可复用的工作流模板，用于自动化开发流程。
+## 目录结构（当前）
 
-## 目录结构
-
-```
+```text
 workflow/
-├── auto-dev-loop/       # 自动开发循环工作流
-└── canvas-dev/          # Canvas白板驱动开发工作流
+├── AGENTS.md                         # 本文件（目录级行为准则）
+├── README.md                         # workflow 总览
+├── auto-dev-loop/                    # 全自动开发闭环（五步状态机）
+│   ├── README.md
+│   ├── CHANGELOG.md
+│   ├── step1_需求输入.jsonl
+│   ├── step2_执行计划.jsonl
+│   ├── step3_实施变更.jsonl
+│   ├── step4_验证发布.jsonl
+│   ├── step5_总控与循环.jsonl
+│   ├── .kiro/                        # Kiro 集成配置
+│   ├── workflow_engine/              # 轻量状态机引擎（state + hook）
+│   └── workflow-orchestrator/        # 编排技能文档与规范
+└── canvas-dev/                       # Canvas 白板驱动开发工作流
+    ├── README.md
+    ├── prompts/
+    ├── templates/
+    └── examples/
 ```
 
 ## 操作规范
 
 ### 允许
-- 新增工作流模板
-- 修改现有工作流配置
-- 添加工作流文档说明
+- 新增工作流模板（新建 `<workflow-name>/` 子目录）
+- 迭代现有工作流的 `README.md`、提示词/模板/脚本
+- 为工作流补齐最小可运行路径（输入 → 执行 → 产物）
 
-### 禁止
-- 删除现有工作流（除非明确要求）
+### 禁止 / 不推荐
+- 破坏现有工作流的“入口约定”（例如把 `README.md` / 关键提示词文件移走）
+- 在脚本中写死个人环境路径（优先相对路径或通过参数注入）
 
-## 工作流规范
+## 工作流落地标准（建议）
 
-每个工作流应包含：
-- `README.md` - 使用说明
-- 配置文件或脚本
-- 示例/模板文件（可选）
+- 必有：`README.md`（一页讲清：目的、输入输出、如何运行、失败怎么排）
+- 有状态机/脚本的工作流：必须明确 **唯一状态入口文件**（例如 `state/current_step.json`）与产物落盘目录（例如 `artifacts/`）