Skip to content

Align every manifest description on one sentence and person-first wording - #7

Merged
aaddrick merged 1 commit into
mainfrom
manifest-descriptions
Aug 3, 2026
Merged

Align every manifest description on one sentence and person-first wording#7
aaddrick merged 1 commit into
mainfrom
manifest-descriptions

Conversation

@aaddrick

@aaddrick aaddrick commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Four manifests described the same style four different ways, and three wrote "an ADHD reader" where the README, the canonical file, and CONTRIBUTING all write "a reader with ADHD". A directory listing puts one of these strings next to the others, so the inconsistency is the first thing a stranger sees.

Every harness manifest now reads the same, with only the harness name changing:

Air traffic control discipline for <harness> output, written for a reader with ADHD: action first, one meaning per word, state restated every turn.

That is the framing .claude-plugin/marketplace.json already used at its top level, and the phrasing gemini-extension.json moved to in 344e813.

File Before After
.claude-plugin/plugin.json "Shape Claude Code output for an ADHD reader…" the sentence above
.codex-plugin/plugin.json "Shape Codex output for an ADHD reader…" the sentence above
.claude-plugin/marketplace.json (entry) "…for an ADHD reader and writes…" "…for a reader with ADHD and writes…"
.cursor/rules/attention-control.mdc "shaped for an ADHD reader." "shaped for a reader with ADHD."
output-styles/attention-control.md (frontmatter) "ATC discipline for an ADHD reader —" "ATC discipline for a reader with ADHD —"

Two of those are generated: the Cursor rule's description comes from CURSOR_FRONTMATTER in scripts/sync_style.py, so the source changed and the copy followed. The canonical file's frontmatter is what Claude Code shows in the /config picker.

One consequence worth stating: changing output-styles/attention-control.md changes its hash, and that hash is part of an eval run's comparability key. No frozen run compares against the current tree anyway — run 001 stopped comparing at 299d581.

No occurrence of "ADHD reader" remains in the tree. 73 tests pass, 8 configs parse, 5 generated files in sync.

…ding

Four manifests described the same style four ways, and three of them wrote "an
ADHD reader" where the README, the canonical file body, and CONTRIBUTING all
write "a reader with ADHD". A directory listing shows one of these strings
next to the others, so the inconsistency is visible to a stranger before
anything else is.

Every harness manifest now reads the same, with only the harness name
changing:

  Air traffic control discipline for <harness> output, written for a reader
  with ADHD: action first, one meaning per word, state restated every turn.

That is the framing .claude-plugin/marketplace.json already used at the top
level, and the phrasing gemini-extension.json moved to in 344e813.

Two of the six strings are generated. The Cursor rule's description comes from
CURSOR_FRONTMATTER in scripts/sync_style.py, so the source changed and the
copy followed. The canonical style file's own frontmatter description is what
Claude Code shows in the /config picker, so it changed too.

Changing output-styles/attention-control.md changes its hash, and the hash is
part of an eval run's comparability key. No frozen run compares against the
current tree anyway: run 001 stopped comparing at 299d581.
@aaddrick
aaddrick merged commit 439477d into main Aug 3, 2026
4 checks passed
@aaddrick
aaddrick deleted the manifest-descriptions branch August 3, 2026 12:26
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.

1 participant