Files
claude-engineering-plugin/plugins/compound-engineering/skills/john-voice/references/revision-checklist.md
John Lamb a7b15298e0
Some checks failed
CI / pr-title (push) Has been cancelled
CI / test (push) Has been cancelled
Release PR / release-pr (push) Has been cancelled
Release PR / publish-cli (push) Has been cancelled
Merge step (b): carry in local-only files at original paths
Brings 47 local-only files from backup-local-main into the merge-upstream
branch at their pre-rename paths. Subsequent steps will rename these to
the ce-* convention and port shared-file merges.

Includes:
- Custom skills: john-voice, jira-ticket-writer, hugo-blog-publisher,
  weekly-shipped, proof-push, ship-it, story-lens, sync-confluence,
  excalidraw-png-export, python-package-writer, fastapi-style,
  upstream-merge
- Custom agents: design-conformance-reviewer, tiangolo-fastapi-reviewer,
  zip-agent-validator, python-package-readme-writer, lint
- Custom commands: essay-edit, essay-outline, pr-comments-to-todos,
  resolve_todo_parallel, workflows/{plan,review,work}
- Local mods to ce-review/SKILL.md + review-output-template.md (will be
  ported to ce-code-review in a later step)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 12:40:27 -05:00

1.1 KiB

Revision Checklist

Run before finishing any piece. Each "yes" requires a rewrite.

Voice

  • Does any sentence use an em-dash? → Use parentheses or split the sentence.
  • Does any abstract noun carry a sentence? ("value," "conviction," "impact," "transformation") → Make it concrete or cut it.
  • Does any claim dissolve when drilled into? → Add the logic or cut the claim.
  • Does any hedge weaken without adding nuance? ("somewhat," "in some ways," "it's worth noting") → Cut it.

Structure

  • Does the opening start with an abstract thesis or definition? → Rewrite to open on a concrete scene.
  • Does the conclusion restate or summarize? → Replace with a question, quiet observation, or callback.
  • Do any paragraphs merely follow each other rather than cause each other? → Reorder or cut.

Momentum

  • Does any paragraph feel like it's trudging? → Rewrite until it moves.
  • Are there runs of similarly-structured sentences? → Break the pattern.
  • Does the last sentence of each paragraph land or pull forward? → Rewrite if it just stops.