Book Genesis Universal Core
Book Genesis is Felipe's portable book-production pipeline for Claude Code, Codex, Kimi Code, and other file-aware agents. This folder is the canonical workflow. Platform adapters install the same files without changing editorial rules. OpenClaw and Hermes Agent can load this same package. Resolve references/ relative to this skill directory and skills/<name>/ against sibling installed skills. The repository Python helper is optional; when it is unavailable, use the host agent's file tools to maintain the documented project tree.
Use this skill for:
- fiction, memoir, nonfiction, or hybrid book projects
- turning a rough idea into a structured book
- drafting full manuscripts chapter by chapter
- auditing AI-written prose and narrative structure
- producing Genesis Score evaluations
- creating synopses, cover briefs, launch/editorial packages, and formatting handoff notes
Do not use the legacy V4 17-phase workflow as the default. It is copied only for historical reference in references/legacy-v4-book-genesis.md.
Core Rule
Persist important decisions to files. A Book Genesis run should leave a durable project tree, not just chat output.
Commercial-length is a hard contract, not a preference. A manuscript cannot be called complete, final-scored as publication-ready, or packaged for a bestseller/public launch unless it either:
- meets the genre/audience
target_floor_words recorded in PROJECT_STATE.yaml, or
- is explicitly positioned from intake as a novella, short novel, or serial installment.
If no explicit short-form positioning exists, default to full-length commercial book standards.
Default project layout:
<project>/
PROJECT_STATE.yaml
ASSUMPTIONS.md
artifacts/
manuscript/
chapters/
evaluations/
delivery/
Canonical Pipeline
Load references/pipeline/manifest.yaml before starting or advancing phases.
- Phase 0: Intake
- Phase 1: Foundation
- Phase 2: Architecture
- Phase 3: Drafting
- Phase 4: Adversarial Audit
- Phase 5: Literary Barrier Revision Loop
- Phase 6: Final Score
- Phase 7: Editorial Package
Use references/pipeline/phases.md for the compact phase overview.
Phase References
Read only the prompt for the active phase:
- Intake:
references/prompts/intake.md
- Foundation:
references/prompts/foundation.md
- Architecture:
references/prompts/architecture.md
- Drafting:
references/prompts/drafting.md
- Adversarial Audit:
references/prompts/adversarial-audit.md
- Literary Barrier Revision Loop:
references/prompts/literary-barrier-loop.md
- Final Score:
references/scoring/genesis-score-codex.md
- Editorial Package:
references/prompts/editorial-package.md
Before any independent or final score, read references/scoring/evaluator-protocol.md and record the achieved independence grade.
references/prompts/orchestrator.md contains the portable orchestration rules.
Operating Loop
Read references/pipeline/host-contract.md at start and resume. It defines installed-path resolution, native-host capabilities, progress, checkpoint recovery, and bounded retries. Use the bundled references/pipeline/project-state.yaml when initializing without the optional Python helper.
- Identify or create the project directory.
- Read
PROJECT_STATE.yaml if it exists. If not, initialize it from the manifest phases and user idea.
- Read
ASSUMPTIONS.md if it exists. If not, create it and mark inferred assumptions clearly.
- Confirm or infer the commercial-length contract before architecture or drafting:
target_range_words
target_floor_words
target_ceiling_words
positioning: full-length novel, novella, short novel, serial, nonfiction, etc.
chapter_count_planned
average_words_per_chapter_planned
- Load the current phase prompt and produce only that phase's required outputs.
- Update
PROJECT_STATE.yaml after every phase, chapter block, audit, or score.
- record cumulative manuscript word count
- record planned vs actual word count by chapter/block
- record whether the length gate is
PASS, FLAG, or BLOCK
- Do not skip Phase 4. Audit before final scoring.
- When drafting, write in chapter files under
manuscript/chapters/ and keep the state synchronized.
- When user feedback changes direction, record it in project files before continuing.
- If the user asks to break a quality threshold such as 8.5, activate the Literary Barrier loop after the adversarial audit. Respect the host contract's retry and no-progress bounds; stop at a saved checkpoint when the threshold cannot be supported, rather than looping until an evaluator agrees.
- If the manuscript is below
target_floor_words, run expansion/re-architecture before any final score or editorial package claims publication readiness.
Quality Policy
- Prefer fewer constraints during drafting; evaluate and repair afterward.
- Separate drafting, audit, scoring, and editorial judgment in the workflow.
- Keep writer, revision editor, and final evaluator in isolated contexts when the runtime supports subagents.
- Use the Genesis Score floor principle: the book is only as strong as its weakest major dimension.
- Treat internal literary scores as inflated until calibrated. Apply the score calibration rules in the scoring reference before claiming a threshold was reached.
- Do not optimize prose to satisfy rubrics while drafting. The writer writes; the critic and editor operate after text exists.
- For Portuguese books, write artifacts and prose in Portuguese unless the user requests otherwise.
- If a task is only editing, scoring, or packaging an existing manuscript, start from the matching phase instead of forcing a full restart.
- Do not let literary quality hide product incompleteness. A brilliant 46k-word draft is not a full-length adult thriller unless the project explicitly chose short-form positioning.
- Bestseller/public-launch readiness requires both craft strength and product fit: length, package, target reader, cover/copy, metadata, and launch plan.
Complementary Skills
Use these only when relevant and already available:
copy-editing for prose-level cleanup
book-swarm-panel for MiroFish-style simulated reader swarms, niche-risk scouting, public-opinion tests, heatmaps, interviews, and revision tickets
humanizer for less synthetic phrasing
launch-strategy or content-strategy for go-to-market assets when separately installed
imagegen or cover-specific workflows for cover ideation
1---2name: book-genesis3description: Use when the user wants to create, plan, draft, evaluate, revise, package, or run a complete AI-assisted book pipeline. Book Genesis turns a one-line idea into a book project with intake, foundation, architecture, drafting, adversarial audit, Genesis Score, and editorial package artifacts.4---56# Book Genesis Universal Core78Book Genesis is Felipe's portable book-production pipeline for Claude Code, Codex, Kimi Code, and other file-aware agents. This folder is the canonical workflow. Platform adapters install the same files without changing editorial rules. OpenClaw and Hermes Agent can load this same package. Resolve `references/` relative to this skill directory and `skills/<name>/` against sibling installed skills. The repository Python helper is optional; when it is unavailable, use the host agent's file tools to maintain the documented project tree.910Use this skill for:1112- fiction, memoir, nonfiction, or hybrid book projects13- turning a rough idea into a structured book14- drafting full manuscripts chapter by chapter15- auditing AI-written prose and narrative structure16- producing Genesis Score evaluations17- creating synopses, cover briefs, launch/editorial packages, and formatting handoff notes1819Do not use the legacy V4 17-phase workflow as the default. It is copied only for historical reference in `references/legacy-v4-book-genesis.md`.2021## Core Rule2223Persist important decisions to files. A Book Genesis run should leave a durable project tree, not just chat output.2425Commercial-length is a hard contract, not a preference. A manuscript cannot be called complete, final-scored as publication-ready, or packaged for a bestseller/public launch unless it either:2627- meets the genre/audience `target_floor_words` recorded in `PROJECT_STATE.yaml`, or28- is explicitly positioned from intake as a novella, short novel, or serial installment.2930If no explicit short-form positioning exists, default to full-length commercial book standards.3132Default project layout:3334```text35<project>/36 PROJECT_STATE.yaml37 ASSUMPTIONS.md38 artifacts/39 manuscript/40 chapters/41 evaluations/42 delivery/43```4445## Canonical Pipeline4647Load `references/pipeline/manifest.yaml` before starting or advancing phases.48491. Phase 0: Intake502. Phase 1: Foundation513. Phase 2: Architecture524. Phase 3: Drafting535. Phase 4: Adversarial Audit546. Phase 5: Literary Barrier Revision Loop557. Phase 6: Final Score568. Phase 7: Editorial Package5758Use `references/pipeline/phases.md` for the compact phase overview.5960## Phase References6162Read only the prompt for the active phase:6364- Intake: `references/prompts/intake.md`65- Foundation: `references/prompts/foundation.md`66- Architecture: `references/prompts/architecture.md`67- Drafting: `references/prompts/drafting.md`68- Adversarial Audit: `references/prompts/adversarial-audit.md`69- Literary Barrier Revision Loop: `references/prompts/literary-barrier-loop.md`70- Final Score: `references/scoring/genesis-score-codex.md`71- Editorial Package: `references/prompts/editorial-package.md`7273Before any independent or final score, read `references/scoring/evaluator-protocol.md` and record the achieved independence grade.7475`references/prompts/orchestrator.md` contains the portable orchestration rules.7677## Operating Loop7879Read `references/pipeline/host-contract.md` at start and resume. It defines installed-path resolution, native-host capabilities, progress, checkpoint recovery, and bounded retries. Use the bundled `references/pipeline/project-state.yaml` when initializing without the optional Python helper.80811. Identify or create the project directory.822. Read `PROJECT_STATE.yaml` if it exists. If not, initialize it from the manifest phases and user idea.833. Read `ASSUMPTIONS.md` if it exists. If not, create it and mark inferred assumptions clearly.844. Confirm or infer the commercial-length contract before architecture or drafting:85 - `target_range_words`86 - `target_floor_words`87 - `target_ceiling_words`88 - `positioning`: full-length novel, novella, short novel, serial, nonfiction, etc.89 - `chapter_count_planned`90 - `average_words_per_chapter_planned`915. Load the current phase prompt and produce only that phase's required outputs.926. Update `PROJECT_STATE.yaml` after every phase, chapter block, audit, or score.93 - record cumulative manuscript word count94 - record planned vs actual word count by chapter/block95 - record whether the length gate is `PASS`, `FLAG`, or `BLOCK`967. Do not skip Phase 4. Audit before final scoring.978. When drafting, write in chapter files under `manuscript/chapters/` and keep the state synchronized.989. When user feedback changes direction, record it in project files before continuing.9910. If the user asks to break a quality threshold such as 8.5, activate the Literary Barrier loop after the adversarial audit. Respect the host contract's retry and no-progress bounds; stop at a saved checkpoint when the threshold cannot be supported, rather than looping until an evaluator agrees.10011. If the manuscript is below `target_floor_words`, run expansion/re-architecture before any final score or editorial package claims publication readiness.101102## Quality Policy103104- Prefer fewer constraints during drafting; evaluate and repair afterward.105- Separate drafting, audit, scoring, and editorial judgment in the workflow.106- Keep writer, revision editor, and final evaluator in isolated contexts when the runtime supports subagents.107- Use the Genesis Score floor principle: the book is only as strong as its weakest major dimension.108- Treat internal literary scores as inflated until calibrated. Apply the score calibration rules in the scoring reference before claiming a threshold was reached.109- Do not optimize prose to satisfy rubrics while drafting. The writer writes; the critic and editor operate after text exists.110- For Portuguese books, write artifacts and prose in Portuguese unless the user requests otherwise.111- If a task is only editing, scoring, or packaging an existing manuscript, start from the matching phase instead of forcing a full restart.112- Do not let literary quality hide product incompleteness. A brilliant 46k-word draft is not a full-length adult thriller unless the project explicitly chose short-form positioning.113- Bestseller/public-launch readiness requires both craft strength and product fit: length, package, target reader, cover/copy, metadata, and launch plan.114115## Complementary Skills116117Use these only when relevant and already available:118119- `copy-editing` for prose-level cleanup120- `book-swarm-panel` for MiroFish-style simulated reader swarms, niche-risk scouting, public-opinion tests, heatmaps, interviews, and revision tickets121- `humanizer` for less synthetic phrasing122- `launch-strategy` or `content-strategy` for go-to-market assets when separately installed123- `imagegen` or cover-specific workflows for cover ideation