Skip to content

skill(entry): tighten draft revision rules and extend promote gate - #17

Merged
dean-harel merged 1 commit into
mainfrom
skill/entry-promote-gate-and-voice-rules
Apr 26, 2026
Merged

skill(entry): tighten draft revision rules and extend promote gate#17
dean-harel merged 1 commit into
mainfrom
skill/entry-promote-gate-and-voice-rules

Conversation

@dean-harel

Copy link
Copy Markdown
Owner

Summary

  • Voice rules. Replace the misleading [reference] shorthand wording with inline [label](url) markdown links — what published entries actually do. Add rules for non-thematic word repetition and for bold/italic emphasis.
  • Revise Draft. Read the surrounding paragraphs before editing so revisions preserve flow, not just satisfy the request in isolation.
  • Promote gate. Extend the existing title check with URL validation and citation coverage. Both surface issues non-blockingly; the user can fix inline or proceed.

The principle behind the promote changes: the post-promotion pipeline is slow, costs money, and runs remotely. Anything checkable on local text moves before promotion. Stages 4–6 only catch what genuinely needs the audio.

Test plan

  • Run `/entry "rough idea"` and confirm research creation still works
  • Move-to-Draft, then Revise-Draft a passage and confirm the revise reads surrounding context
  • Promote a draft with a known dead link and confirm URL validation surfaces it
  • Promote a draft with an unsourced claim from research and confirm citation coverage surfaces it
  • Confirm voice.md anti-patterns still load via path glob on draft.md

🤖 Generated with Claude Code

Voice: rewrite citation guidance to match what published entries actually
do (inline `[label](url)` markdown links), and add rules for
non-thematic word repetition and bold/italic emphasis.

Entry skill: revise-draft now reads surrounding paragraphs before
editing so revisions preserve flow. Promote extends the existing title
gate with URL validation and citation coverage — both surface issues
non-blockingly, keeping the user in flow.

Shifts quality left: the post-promotion pipeline is slow, costs money,
and runs remotely, so anything checkable on local text gets caught here.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

✅ All review checks passed. When you're ready, apply the ready label to publish.

@dean-harel
dean-harel merged commit 0f8d4b0 into main Apr 26, 2026
2 checks passed
@dean-harel
dean-harel deleted the skill/entry-promote-gate-and-voice-rules branch April 26, 2026 19:34
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