audit(specify): repair trailing brainstorm->specify doc drift

Follow-up to f775881. The architect's diff-scoped review missed four
prose references outside the cycle diff that the brainstorm shrink left
stale — the aspirational-marker and parse-gate machinery moved to specify
(it writes the spec and runs the gates), but these still said brainstorm:

- profile-schema.md aspirational-source section: "a later brainstorm
  tell aspirational content", "the brainstorm degrades", "consumed by
  the brainstorm skill", and the "Step-7 parse-every-block gate" number
  (specify's parse gate is Step 4, not Step 7).
- profile-schema.md spec_validation section: "The brainstorm parse-gate".
- README "Retrofitting spec_validation": "brainstorm Step 7 self-review"
  -> "specify Step 4 self-review".

Found by sweeping every brainstorm reference in the two files for ones
that describe spec-production rather than discovery. planner Step 5
self-review and the grounding-check pass references were already correct.
This commit is contained in:
2026-06-04 23:35:02 +02:00
parent f7758818ab
commit fd9d73c3b0
2 changed files with 6 additions and 6 deletions
+1 -1
View File
@@ -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
+5 -5
View File
@@ -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.