agentleFS
ultimatileultimatile/development-skills/skills/authoritative-text-rules/SKILL.md

authoritative-text-rules

Skill0 starsChanged 32 days agoMITView on GitHub

Single source of truth for audit items covering text that an agent executes as instructions. Definitions live in items/<slug>.md; audit skills reference items by slug.

The file

Files
SKILL.md

Authoritative Text Rules (SSOT)

Skills that audit authoritative text apply these items by reference. A runner may carry a compressed mnemonic of an item, but never the item's full trigger, sweep, concern conditions, or N/A criterion — that copied detail is the manual-synchronization surface this rule removes — and the mnemonic is never the authority. The Items index below is the single source of truth for which items exist: runners derive their active item set by reading this index, never by hardcoding a parallel slug list.

Scope

Authoritative text is text an agent executes as instructions; applying a definition file by reference is executing it, no less than running a procedure step by step. That single property decides membership, and any file for which it holds qualifies in full — a body that also describes a separate artifact, such as a wrapped script or a co-located rule table, is still audited whole as instructions.

A claim about a separate artifact, made inside a qualifying file, has a referent, and checking the claim against that referent belongs to the code-quality rule set quality-list, on its items' own triggers. An item here whose sweep reaches such a claim still audits it and reports on its own concern conditions — case-space-totality's sweep is one that does.

Skill bodies — script-wrapping ones included — rule and item definition files, and repository-level agent-instruction files (CLAUDE.md, AGENTS.md, files under .claude/rules/, .claude/commands/, .claude/agents/, and the equivalents other tools define) are the recurring instances. The list is illustrative: the property above decides membership.

Source code is not authoritative text: a machine executes it. Prose that is read rather than executed — a README, an article, a design document, a docstring — is not authoritative text either.

Classify per file, not per directory. A skill directory can hold a skill body beside a package manifest, a lockfile, and scripts; the body is authoritative text and the rest is not.

A diff can carry both kinds. When it does, this rule set and the code-quality rule set the runner already applies both bind it in full — the classification is the set of surfaces present, not a partition. A change whose substance is code keeps its ordinary audit unchanged and gains these items for whatever authoritative text it also touches.

Ownership boundary

A statement left stranded by a qualification the diff introduces — a caveat that makes a previously unconditional documented behavior conditional, while the same behavior stays stated unconditionally elsewhere — belongs to quality-list's paired-artifact-drift item and its Qualification completeness sweep. No item here takes that case.

Items

Items carry no lane tag: every judgment below is available from the literal text of the audited files and the files they reference, so a runner splitting work between a fresh-context subagent and main context may send any item to either. A runner selects every item in this index whenever the rule set is active.

  • case-space-totality
  • single-reading
  • clause-composition
  • executor-fitness
  • consumer-closure

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.