Development record
04-scope defines operator-internal verbs, rules and spec among them, as wiring with no commands/ file; itd-146 says operator_internal only means 'needs no surface chapter' and treats rules as user-facing.
04-scope defines operator-internal verbs, rules and spec among them, as wiring with no commands/ file; itd-146 says operator_internal only means 'needs no surface chapter' and treats rules as user-facing.
A terminology drift (severity minor) found by the cross-document consistency pass.
- End A:
.abcd/development/intents/shipped/itd-146-abcd-s-help-renders-in-labelled-command.md:75— "record-lint.jsonmeans needs no surface chapter, which is a lint" - End B:
.abcd/development/brief/01-product/04-scope.md:19— "the class is defined by the absence of acommands/file rather than by the presence of one"
04-scope lists rules and spec among the operator-internal verbs, as wiring rather than user-facing surface, and says 'the class is defined by the absence of a commands/ file rather than by the presence of one'. itd-146 says the operator_internal key in 'record-lint.json means needs no surface chapter, which is a lint' exemption rather than a verdict on user visibility, and keeps rules listed because the marker block tells every managed repository to run it. The term operator-internal has two definitions, and they disagree on whether rules is user-facing.
Evidence: .abcd/work/reviews/2026-10-26-consistency/00-summary.md, finding 203.
Grounds
- declined: Closed in the 2026-10-27 triage (dcn-2610271112330536): a later record already settles which end holds. internal/surface/cli/helpgroups.go files rules and spec under the agents block, and the lint config comment defines operator_internal as exempt from a surface file; the two definitions coincide today.
Frontmatter
| id | iss-2610262031582207 |
|---|---|
| type | issue |
| lifecycle | wontfix |
| severity | minor |
.abcd/work/issues/wontfix/iss-2610262031582207-04-scope-defines-operator-internal-verbs.md
open on GitHub ↗ · commit history ↗
References1
- itd-146abcd's help renders in labelled command groups, and the grouping is gated like every other surface claimrelated
mentions1
- dcn-26102711123305362026-10-27 — The product thinker accepted on 2026-10-27 the triage of the 1301 records the 2026-10-26 consistency pass filed. The duplicates, the records a later record already settles, the ones that are no contradiction and the one already fixed are closed with each reader's reason. Every other record gets its fix as its remedy, the rulings' accepted answers included, so a drain can take it. The 45 major records left open are deferred past v0.15.1, because the brief's single-home rewrite rewrites or removes most of the passages they quote. The person ruled the major rulings one at a time; the minor rulings take their recommended answers.