Skip to content

feat(refresh): seed the writing voice guide across boxes - #11

Merged
jcasimir merged 1 commit into
mainfrom
ce-refresh-seed-voice-guide
Jul 17, 2026
Merged

feat(refresh): seed the writing voice guide across boxes#11
jcasimir merged 1 commit into
mainfrom
ce-refresh-seed-voice-guide

Conversation

@jcasimir

Copy link
Copy Markdown
Member

What

/ce:refresh already syncs the writing personas (Perkins + the seven-voice panel) from ce-reviewers-jsl, but the voice-guide.md those reviewers judge prose against had no propagation path — the devbox entrypoint seed loop is .yaml-only. Boxes other than the author's fell back to first principles.

This adds seed-voice-guide.sh and a refresh step (Step 7) that fetches voice/voice-guide.md from the persona source repos (orchestrator config first, then reviewer) into ~/.config/compound-engineering/voice-guide.md.

Design

  • Single canonical source. Fetches from the same repos the personas come from (e.g. ce-reviewers-jsl), so there's no second copy to drift. No shell-config / server-admin change.
  • Seed-if-absent. The guide is a living document — the writing orchestrator's compound phase edits the local copy and commits the canonical version back to the source repo — so an existing local copy is never overwritten. To pull a newer canonical guide, delete the local copy and re-run /ce:refresh.
  • Graceful no-op. If no configured source repo hosts a voice guide, it does nothing and the reviewers fall back to first principles.
  • gh with a git fallback, matching sync-reviewers.sh.

Verification

Tested on tractor: seed-if-absent correctly skips an existing copy; with the copy removed it fetches the exact 232-line v4.1 guide from ce-reviewers-jsl@main (byte-identical to canonical), then restored.

No version bump (per contributor rules); no component-count change.

🤖 Generated with Claude Code

/ce:refresh already syncs the writing personas (Perkins + the seven-voice
panel) from ce-reviewers-jsl, but the voice-guide.md those reviewers judge
against had no propagation path — the devbox entrypoint seed loop is
.yaml-only. Boxes other than the author's fell back to first principles.

Add seed-voice-guide.sh + a refresh step that fetches voice/voice-guide.md
from the persona source repos (orchestrator config first, then reviewer)
into ~/.config/compound-engineering/voice-guide.md.

Seed-if-absent: the guide is a living document (the writing orchestrator's
compound phase edits the local copy and commits the canonical version back
to the source repo), so an existing local copy is never overwritten. No-op
if no source repo hosts a voice guide. No version bump (per contributor
rules); no component-count change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jcasimir
jcasimir merged commit c5ee4b6 into main Jul 17, 2026
2 checks passed
@jcasimir
jcasimir deleted the ce-refresh-seed-voice-guide branch July 17, 2026 14:29
@github-actions github-actions Bot mentioned this pull request Jul 17, 2026
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