Skip to content

feat(routing): deprecate blog-post-writer and voice-orchestrator in favor of voice-writer#202

Merged
notque merged 3 commits intomainfrom
feat/deprecate-blog-post-writer-voice-orchestrator
Mar 28, 2026
Merged

feat(routing): deprecate blog-post-writer and voice-orchestrator in favor of voice-writer#202
notque merged 3 commits intomainfrom
feat/deprecate-blog-post-writer-voice-orchestrator

Conversation

@notque
Copy link
Copy Markdown
Owner

@notque notque commented Mar 28, 2026

Summary

  • Deprecates blog-post-writer and voice-orchestrator in favor of voice-writer (per ADR-068)
  • Expands voice-writer with 10 new routing triggers (20 total) to catch all content generation scenarios
  • Updates 27 files across the codebase to remove stale references that would route users to deprecated skills

What changed

Deprecated skills (kept on disk, triggers cleared, deprecated: true in frontmatter + INDEX):

  • blog-post-writer — 4-phase pipeline missing de-ai, joy-check, and voice validation
  • voice-orchestrator — predecessor to voice-writer, replaced by ADR-068

voice-writer trigger expansion (10 new triggers):
write blog, article about, publish post, content for blog, hugo post, write for website, long-form content, write piece, write essay, ghost write

Reference sweep (24 stale references fixed across 20+ files):

  • pairs_with arrays in 6 INDEX.json entries
  • Routing instructions in wordpress-uploader, article-evaluation-pipeline, research-to-article, create-voice, voice-validator, voice-calibrator, technical-journalist-writer
  • Documentation in for-knowledge-workers.md, for-ai-wizards.md, for-claude-code.md, REFERENCE.md, CLAUDE-soul-template.md, README.md
  • Shared patterns and internal references

Test plan

  • All 3 INDEX.json files validate (JSON parse check)
  • Zero remaining active routing references to deprecated skills (grep verified)
  • No trigger overlaps introduced (0 new duplicates)
  • conftest.py path to banned-words.md still valid (file exists on disk)
  • 3/3 review rounds passed

notque added 3 commits March 28, 2026 08:38
…avor of voice-writer

Per ADR-068, voice-writer (8-phase pipeline with de-ai, joy-check, voice
validation) supersedes both blog-post-writer (4-phase, no validation gates)
and voice-orchestrator (7-phase predecessor, lacks joy-check).

Changes:
- blog-post-writer: add deprecated/deprecated_by frontmatter, clear triggers,
  add deprecation notice at top of Instructions section
- voice-orchestrator: same pattern — deprecated in frontmatter, triggers
  cleared, deprecation notice added
- voice-writer: expand triggers with 10 additional phrases to catch all
  writing scenarios the deprecated skills previously handled
- skills/INDEX.json: mark both deprecated skills with deprecated/deprecated_by,
  clear their triggers arrays
- pipelines/INDEX.json: expand voice-writer triggers to match SKILL.md
- routing-tables.md: add deprecation notice in Content Creation and Voice
  sections, add routing examples for new trigger phrases
- joy-check/SKILL.md: update integration note to remove blog-post-writer ref
- docs/VOICE-SYSTEM.md: update integration section and file structure to
  reflect voice-writer as the active skill
…er and voice-orchestrator

Both skills are deprecated in favor of voice-writer. This updates all
pairs_with arrays, routing instructions, documentation prose, and
INDEX.json entries to reference voice-writer instead. Adds (deprecated)
annotations to skills/README.md entries.
@notque notque merged commit 8eeb40d into main Mar 28, 2026
4 checks passed
@notque notque deleted the feat/deprecate-blog-post-writer-voice-orchestrator branch March 28, 2026 15:54
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