Skip to content

fix(authoritative-text-rules): single-property Scope membership - #201

Merged
ultimatile merged 3 commits into
mainfrom
fix/153-scope-predicate
Aug 15, 2026
Merged

ultimatile merged 3 commits into
mainfrom
fix/153-scope-predicate

Conversation

@ultimatile

Copy link
Copy Markdown
Owner

Summary

The Scope section of authoritative-text-rules defined authoritative text by two properties, and the second — "it describes no artifact separate from itself" — admitted a strict and a loose reading that disagree on script-wrapping skill bodies, leaving their membership undecided. Membership now turns on the first property alone: text an agent executes as instructions qualifies in full, wrapped-script describers included, and checking a claim about a separate artifact against its referent belongs to quality-list, on its items' own triggers. Closes #153

Changes

  • skills/authoritative-text-rules/SKILL.md, Scope section: membership is decided by the single executed-as-instructions property, with applying a definition file by reference counting as execution. Claims about a separate artifact route to quality-list, with an explicit carve-out for an authoritative-text-rules item whose own sweep reaches such a claim — case-space-totality's does. The source-code exclusion rests on "a machine executes it", the docstring exclusion on "read rather than executed", and the sentence listing the recurring instances now names script-wrapping skill bodies.
  • .claude-plugin/marketplace.json carries version 2026.8.7 (bumped once on the branch, per the squash-merge rule).

Impact

  • The consumer skills (done-check, todo-check, research, review-pipeline, finding-to-audit) apply the Scope section by reference and need no edits; their existing one-property paraphrases — done-check's "text an agent executes as instructions", finding-to-audit's "text the agent executes as instructions" — now match the predicate exactly.
  • The authoritative-text auditor done-check dispatches now unambiguously includes the script-wrapping skill bodies (stdlib-audit, gh-body-check, copilot-review) in scope.
  • research's rule-set baseline can no longer skip its read of the listed item bodies for changes touching those bodies, since that skip requires every touched surface to be excluded by the Scope section.

Verification

  • A fresh-context audit in done-check's auditor shape, applying every item in authoritative-text-rules' Items index to this diff, returned one row per indexed item and no concerns.
  • rg over the repository for verbatim substrings of the removed lines ("both of these properties", "describes no artifact", "no referent its claims") returns no hits outside the rewritten file.
  • The mdformat pre-commit hook passed on both commits.

Notes

…d-as-instructions property alone

The second Scope property (describes no separate artifact) excluded
script-wrapping skill bodies from every item despite their being
agent-executed instructions. Membership now turns on the first
property alone; claims describing a co-located artifact route to
claim-vs-referent items on their own triggers.

Refs #153
…cope

Review fixes on the new Scope text: state that applying a definition
file by reference is execution, mark the wrapped-script examples as
illustration, route referent checks to quality-list by name, attach
the separate-artifact clause to the claim rather than the file, and
state that an item whose sweep reaches such a claim still reports on
its own concern conditions.

Refs #153

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Clarifies the authoritative-text-rules Scope predicate to use a single membership property (“executed as instructions”), explicitly including script-wrapping skill bodies, and routes claim-vs-referent checks to quality-list based on its own triggers. Also bumps the plugin version to reflect the behavior-definition change.

Changes:

  • Redefines authoritative-text membership to depend solely on “agent executes it as instructions,” including definition-by-reference.
  • Clarifies that referent-checking for claims about separate artifacts belongs to quality-list, with a noted carve-out where an authoritative-text-rules item’s sweep reaches such claims.
  • Bumps .claude-plugin/marketplace.json version from 2026.8.6 to 2026.8.7.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
skills/authoritative-text-rules/SKILL.md Updates Scope definition and boundary text to use a single executed-as-instructions membership property and clarify routing to quality-list.
.claude-plugin/marketplace.json Version bump to 2026.8.7.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread skills/authoritative-text-rules/SKILL.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

@ultimatile
ultimatile merged commit 5003529 into main Aug 15, 2026
1 check passed
@ultimatile
ultimatile deleted the fix/153-scope-predicate branch August 16, 2026 02:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

authoritative-text-rules: the Scope predicate admits two readings that select different files

2 participants