|
3 | 3 | This document is a **reader's guide** to a change's `metadata.yaml` |
4 | 4 | (`.prospec/changes/{name}/metadata.yaml`). The file is **CLI-written, skill-read** (issue |
5 | 5 | #107): every mutation goes through a `prospec` command — `change story` (create), |
6 | | -`change scale`, `change status`, `change log` (quality_log append), `verify record`, |
| 6 | +`change scale`, `change auto-draft` (create), `change status`, `change log` (quality_log append), `verify record`, |
7 | 7 | `check --record-review` / `--record-tests`, `archive` — so skills never hand-serialize it. |
8 | 8 | What follows documents the shape those commands emit, so a skill reading the file (or |
9 | 9 | composing structured CLI input) knows what each field means. |
@@ -41,14 +41,14 @@ finds itself about to WRITE this shape by hand has taken a wrong turn — run th |
41 | 41 | | `name` | yes | `prospec change story` (create) | change dir name (kebab-case) | |
42 | 42 | | `created_at` | yes | `prospec change story` (create) | full ISO 8601 | |
43 | 43 | | `status` | yes | `prospec change plan/tasks/status` + `verify record` (S/A) + `archive` | one of the lifecycle values (`_status-lifecycle.md`), forward-only | |
44 | | -| `scale` | no (defaults `standard`) | `prospec change scale`, after user-confirmed assessment | one of the schema's `CHANGE_SCALES` values | |
45 | | -| `related_modules` | no | `prospec change story` (auto-match or `--related-module`) | bare module names | |
| 44 | +| `scale` | no (defaults `standard`) | `prospec change scale`, after user-confirmed assessment; also `change auto-draft` at create time, from the drift check that triggered it | one of the schema's `CHANGE_SCALES` values | |
| 45 | +| `related_modules` | no | `prospec change story` (auto-match or `--related-module`); `change auto-draft` writes the module it attributed, or nothing | bare module names | |
46 | 46 | | `description` | no | `prospec change story --description` | one line, plain text | |
47 | 47 | | `quality_log` | no | `prospec change log` (any station) + `verify record` (append) | gate trail — see below | |
48 | 48 | | `review_provenance` | no | `prospec check --record-review` at review | machine-written baseline | |
49 | 49 | | `test_provenance` | no | `prospec check --record-tests` at verify | machine-written test baseline — see below | |
50 | 50 | | `introduced_by` | no | `prospec change story --introduced-by` (bug-fix changes only) | escaped-defect registration | |
51 | | -| `issue` | no | `prospec change story --issue` | external-tracker registration — see below | |
| 51 | +| `issue` | no | `prospec change story --issue`, `prospec change auto-draft --issue` | external-tracker registration — see below | |
52 | 52 |
|
53 | 53 | ### `test_provenance` — the recorded test run |
54 | 54 |
|
|
0 commit comments