Skip to content

Holocron v1.1.0

Choose a tag to compare

@github-actions github-actions released this 11 May 02:41
· 10 commits to main since this release

New entry-point command: /holocron:adopt. Writers arriving with an existing draft (a .md file or a .docx) can now bring their work into Holocron without manually populating every wizard slot themselves. Adopt wraps the existing six-phase /holocron:new wizard with two new phases:

  • Before the wizard: extract era, premise, theme, characters, world, outline, and voice from the draft; populate the wizard's questions with those values as recommended defaults the writer can accept / edit / skip.
  • After the wizard: dispatch the writer agent to rewrite the existing chapters in the project's voice and craft rules — one chapter at a time, with an approval gate between each — so the writer can continue from any approved chapter using the rest of the Holocron toolkit.

The resulting project is indistinguishable from one created by /holocron:new — same files in the same places — but seeded from the writer's existing material instead of a blank page.

Added

  • skills/adopt/skill.md — new entry-point skill /holocron:adopt [path to draft.md or draft.docx]. Mirrors /holocron:new's frontmatter and dispatch model. Body documents the four-phase user experience (Import → Extract → Wizard with pre-fill → Rewrite gate), the pandoc preflight (reused from /holocron:build for .docx input), the project-folder scaffold, the chapter-heading splitting rules, the extractor handoff, the wizard handoff in adoption mode, and the per-chapter rewrite approval loop. Resumable via /holocron:go.
  • agents/draft-extractor.md — new specialist agent. Coordinates reader-digest (careful mode) and voice-analyzer in parallel against imports/original-split/*.md, then synthesises a single .holocron-adoption.json at the project root holding the wizard's slot values for every phase plus confidence flags. Also writes craft/tone.md directly from the voice profile (preserving the writer's existing voice rather than imposing a plugin-default register). Schema-version 1; opus-model; tools: Read, Glob, Write, Task.

Changed

  • agents/new-project.md — adds an "Adoption mode" section near the top, before Phase 0. The wizard agent now detects .holocron-adoption.json at the project root and uses its values as pre-filled defaults at each phase, honouring per-field confidence flags (high → lead with the extracted value; medium → acknowledge uncertainty; low → ask openly as if no extraction had happened). Specialist dispatch rules (architect, character-developer, outliner, lore-researcher, world-builder) are unchanged — deep work still happens, it just starts from a populated draft instead of a blank one. Phase 0 is skipped in adoption mode because /holocron:adopt owns the scaffold + draft import. craft/tone.md is honoured as authored by the extractor (preserves the writer's voice).
  • README.md — Commands table now includes /holocron:adopt. Status block updated for the 1.1.0 release. Current-version marker bumped.
  • .claude-plugin/plugin.json, .claude-plugin/marketplace.json — version bumped to 1.1.0.

Notes

  • Single-document input only in v1.1.0. One .md or one .docx. Folder-of-files input mode is deferred; writers with a folder should concatenate first. Future v1.2.0 could add the folder mode if real-world drafts demand it.
  • Voice extraction preserves the writer's voice. craft/tone.md is populated from voice-analyzer's output — the writer's existing style — not from a Karpyshyn / Stover / Zahn template. The writer agent then applies plugin-level craft rules (no filter words, audiobook awareness, scene structure) on top of the writer's voice during the rewrite phase. The intent is "match my voice, sharpen my craft," not "rewrite me into a different writer."
  • Originals are preserved. imports/original.{md,docx} and imports/original-split/*.md are never overwritten or deleted. The rewritten output lives under chapters/ per Holocron convention. The writer can diff at any time.
  • Rewrite is gated chapter-by-chapter. Never batch. Prevents voice drift compounding before the writer sees it. The writer can bail at any chapter; the rest of imports/ waits for a future resume.
  • Era mismatch is surfaced, not silenced. If the extractor flags non-OR-detected, Phase 1 of the wizard asks the writer explicitly whether to relocate to Old Republic or proceed off-piste. No silent transposition.
  • No new entry-point in commands/. Holocron has been on skills-only dispatch since 1.0.0 (commands/ is empty); /holocron:adopt follows the same convention.