@namewta/speculo 0.2.6 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -23,11 +23,18 @@ keywords: [specdev, 软件研发, 设计, spec, tickets, 寻路, TDD, 实现,
|
|
|
23
23
|
| 名称 | 路径 | 说明 |
|
|
24
24
|
|------|------|------|
|
|
25
25
|
| 状态索引 | `<Path>{roots.state}/specdev/status.json</Path>` | workflow 全局状态 |
|
|
26
|
+
| 工作流配置 | `<Path>{roots.state}/specdev/.config/</Path>` | 变更追踪、领域文档布局、状态标签映射等配置约定 |
|
|
26
27
|
| 活跃变更 | `<Path>{roots.state}/specdev/changes/</Path>` | 进行中的 change 产物（ADR、LOG、CONTEXT、spec、tickets、map 等） |
|
|
27
28
|
| 永久 ADR | `<Path>{roots.state}/specdev/adr/</Path>` | changes 中经确认后的 ADR 提升至此，始终反映当前架构决策现状 |
|
|
28
29
|
| 永久词汇表 | `<Path>{roots.state}/specdev/context/</Path>` | changes 中经确认后的 CONTEXT 提升至此，始终反映当前领域术语现状 |
|
|
29
30
|
| 变更归档 | `<Path>{roots.state}/specdev/archive/</Path>` | 已完成并归档的历史 change，按 YYYY-MM/<change>/ 组织 |
|
|
30
31
|
|
|
32
|
+
`.config/` 目录包含三个由 `I-init-setup` 生成的配置文件，定义 specdev 各 work 的持久化和行为约定：
|
|
33
|
+
|
|
34
|
+
- **`tracking.md`** — 变更追踪约定：变更目录的命名规范（`<YYYY-MM-DD>-<topic>`）、目录结构、`status.json` 机制、归档规则
|
|
35
|
+
- **`domain-layout.md`** — 领域文档布局：三文件模型（CONTEXT.md / ADR.md / LOG.md）的路径解析规则和读取顺序
|
|
36
|
+
- **`status-labels.md`** — 状态标签映射：五个标准角色（`needs-triage` / `needs-info` / `ready-for-agent` / `ready-for-human` / `wontfix`）的标签字符串、状态流转图和自定义方式
|
|
37
|
+
|
|
31
38
|
`status.json`、`changes/`、`archive/` 为固定骨架，由 `speculo init` 创建。`adr/` 和 `context/` 为确认后创建——当 changes 中的 ADR、CONTEXT 经确认符合当前现状后，提升到这两个目录，始终保持与项目当前状态一致。
|
|
32
39
|
|
|
33
40
|
## 启动协议
|