Skip to content

feat(copy): add the copy standards and the page-copy skill - #14

Merged
z4gunn merged 2 commits into
mainfrom
feat/copy-standards
Oct 4, 2026
Merged

z4gunn merged 2 commits into
mainfrom
feat/copy-standards

Conversation

@z4gunn

@z4gunn z4gunn commented Oct 4, 2026 •

Copy link
Copy Markdown
Owner

Area 6 of 11: copy standards and the page-copy skill

Discovery mined a user_vocabulary field nothing consumed, and the only copy standard covered UI strings. New reference .claude/references/copy-standards.md (page structure, headline and CTA formulas, the marketing phrase ban table, the structural AI-tell list with a severity note, the swap test, the fact rule mapped to [NEED] and needs-human-input) and new skill spgr-write-page-copy with a stdlib copy lint. Wired into the PM, frontend, and documentation agents and the README, release-notes, and listing skills. 16 lint tests.

Sources: coreyhaines31/marketingskills copywriting and cro, blader/humanizer.

Stacked PR: merge in order, this one after its base branch. Merge with a merge commit, as the earlier PRs were.

🤖 Generated with Claude Code

z4gunn and others added 2 commits October 4, 2026 15:55
…inistic copy lint

Springer had one copy standard, the interface section of design-quality.md,
and nothing for the prose an agent generates outside the interface: page
copy, README, docs, release notes, listing copy. Discovery recorded the
users' own vocabulary and no skill consumed it, so the build unit wrote the
page's words mid-implementation from whatever a model produces for a brief
of that shape.

copy-standards.md names the page structure, the headline and CTA shapes, the
banned phrases, the structural patterns that read as generated, a severity
split, the swap test, and the fact rule that turns a missing fact into a
[NEED] marker rather than an invention. spgr-write-page-copy gives a public
page a copy owner before markup exists, and copy_lint.py catches the subset
of the standard a regular expression can see, with a hermetic test per
pattern.

Patterns were adapted and rewritten from the copywriting and copy-editing
skills in https://github.com/coreyhaines31/marketingskills and the pattern
catalog in https://github.com/blader/humanizer, both MIT. No prose or
statistics were carried over.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…enerate prose

One sentence in each consumer: design-quality.md scopes its copy section to
the interface and points outward, the forum mining skill names
spgr-write-page-copy as the consumer of user_vocabulary, the PM agent writes
page copy on brochure before any build unit so [NEED] rows reach the intake
sweep, the frontend developer takes the page-copy artifact verbatim, and the
documentation agent and the README, release-notes, and app-store-listing
skills follow the reference and run the lint.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Base automatically changed from feat/seo-standards to main October 4, 2026 23:17
@z4gunn
z4gunn merged commit 129b063 into main Oct 4, 2026
1 check passed
@z4gunn
z4gunn deleted the feat/copy-standards branch October 4, 2026 23: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.

1 participant