diff --git a/README.md b/README.md index 802b1b1..4fa26ac 100644 --- a/README.md +++ b/README.md @@ -117,7 +117,7 @@ the tool that validates a spec code block of that kind. It powers the parse gates that stop a spec from shipping code blocks that do not parse against the live tool: -- `brainstorm` Step 7 self-review — the parse-every-block gate +- `specify` Step 4 self-review — the parse-every-block gate - `planner` Step 5 self-review — the parse-the-bytes-you-inline gate - the `grounding-check` agent's code-block parse pass diff --git a/docs/profile-schema.md b/docs/profile-schema.md index ec8c757..ccaad46 100644 --- a/docs/profile-schema.md +++ b/docs/profile-schema.md @@ -29,7 +29,7 @@ skip the corresponding step. Files under `design_models` (or an equivalent `RFCs` / `proposals` directory) commonly carry aspirational code — constructs written before the surface that would parse them -exists. To let a later brainstorm tell aspirational content from +exists. To let a later specify tell aspirational content from validated contract, projects are encouraged (not required) to give each such file a frontmatter marker: @@ -49,10 +49,10 @@ reading agent can mechanically tell which carry verified behaviour. When a file lacks the marker the signal is simply absent — the -brainstorm degrades to treating its content as unmarked, never -hard-failing. The marker is consumed by the brainstorm skill (see +specify skill degrades to treating its content as unmarked, never +hard-failing. The marker is consumed by the specify skill (see its Step 1 and Step 4): content lifted from an aspirational source -is flagged and must clear the Step-7 parse-every-block gate before +is flagged and must clear the Step-4 parse-every-block gate before it ships in a spec. ## `naming` @@ -86,7 +86,7 @@ take the next-higher number; deleted files retire their number. ## `spec_validation` Optional. A registry mapping each markdown fence label to the tool -that validates a spec code block of that kind. The brainstorm +that validates a spec code block of that kind. The specify parse-gate and the grounding-check code-block pass run these parsers so that spec code blocks are treated as hypotheses to verify, not as authoritative truth.