Skip to content

Reconcile operator copy contorted to dodge the now-removed banned words (D-225) #170

@StarshipSuperjam

Description

@StarshipSuperjam

Design spec landed (engine-planning): decision-log.md D-225 ends banned-word-lists — the right word for the operator's need is the right word.

Problem

Operator-facing strings were written to avoid words the _FORBIDDEN tuples banned (e.g. structural / precedence / schema), sometimes at the cost of clarity. With the lists removed (see the word-ban-removal issue), restore the clearest wording.

Files (seed set — sweep for others)

  • .engine/tools/tune.py_REFUSE_STRUCTURAL, _REASSURANCE, and any operator string shaped to dodge a removed word.
  • Any other operator-facing string contorted to avoid a now-allowed word.

Conforming target

Restore the clearest wording — the right word, plainly used, and explained where it carries weight the operator needs. Both edges of the operator-communication law apply: clarity over avoidance (substance), but never shorthand over substance — do not over-rotate into terse jargon just because the word-bans are gone. Conforming models in-repo: README.md, .engine/conduct/defaults.md ("You're technically literate, so I won't dumb things down").

Reference: engine-planning decision-log.md D-225, glossary.md operator-communication law.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationengineOpened by the engine about its own health (not your product).

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions