BOOKS-DOCS-PLANNING-FIRST | accepted | books docs expose planning pages before general implementation docs | section users hit active planning context first |
BOOKS-HOMEPAGE-READER-FIRST | superseded | homepage reader was treated as the main reading surface, not a teaser | replaced by the dedicated reader route as the canonical runtime |
BOOKS-HOMEPAGE-READER-LAZY-MOUNT | superseded | homepage reader mounted only when the user explicitly asked for it | replaced by the homepage launch-surface approach |
BOOKS-HOMEPAGE-READER-BYTE-LOAD | accepted | embedded reader should load the .epub archive into memory before mounting react-reader | runtime behavior does not depend on browser MIME handling or URL-style EPUB fallback |
BOOKS-HOMEPAGE-LAUNCHPAD | accepted | homepage is the launch surface for books and routes into /books/<slug>/read for the stable session | the dedicated reader page is the canonical live reading runtime |
BOOKS-DEDICATED-READER-BOOK-SWITCHER | accepted | active reading sessions should expose book switching in the read-page header | readers can move between available books without leaving the reader route |
BOOKS-DEDICATED-READER-SPREADS | accepted | wide screens should use paginated two-page spreads when the viewport allows it | the reading surface can feel like an opened book as long as each emitted page shell stays compact enough to fit |
BOOKS-DEDICATED-READER-TOC-STYLING | accepted | TOC chrome and in-book TOC typography should feel designed, not default | navigation surfaces should look intentional even before content-specific polish |
BOOKS-DEDICATED-READER-STAGE-CLEARANCE | accepted | the spread needs extra left clearance from the TOC toggle chrome in reader mode | reading pages should not feel pinned under the hamburger button |
BOOKS-DEDICATED-READER-BOTTOM-NAV | accepted | dedicated reader navigation should live in a compact bottom strip with section title and page movement controls | reading navigation stays accessible without adding louder chrome to the header or page edges |
BOOKS-DEDICATED-READER-CUSTOM-TOC | accepted | the dedicated reader should use a custom collapsed contents panel instead of the built-in react-reader TOC chrome | the menu stays fully hidden until opened and no hidden TOC text bleeds into the reading stage |
BOOKS-LEAD-IMAGE-PAGES-CAN-SPLIT | superseded | on wider spreads, a lead-image story page can lay out with the figure on the left and the opening text beside it | replaced by the stricter single frame-shape rule for all illustrated pages |
BOOKS-IMAGE-FRAME-SHAPE-IS-FIXED | accepted | every illustrated page should use the same fixed frame shape as the placeholder slot, even if the image needs to crop | art presentation stays visually consistent and the page shell does not change shape based on source aspect ratio |
BOOKS-MANUSCRIPT-STRUCTURE-FIRST | accepted | books should be authored as structured manuscripts with chapter metadata and content pages, not as filename-driven display titles | the builder must derive paperback-style output from formal source structure instead of exposing raw page filenames |
BOOKS-STORY-PAGES-STAY-IN-SPINE | accepted | story pages can be hidden from the TOC but must stay in the EPUB spine | TOC cleanup must never remove the actual reading order from the built book |
BOOKS-EMIT-PAGE-SHELLS | accepted | EPUB generation should emit custom page wrappers with lead-image placement and bottom folios | the dedicated reader can treat source files like intentional printed pages instead of raw chapter fragments |
BOOKS-LEAD-IMAGES-LIFT-OUT-OF-PARAGRAPHS | superseded | builder should treat a leading inline image in the first paragraph as the page lead figure | replaced by the simpler fixed illustration slot rule for each authored page |
BOOKS-DEDICATED-READER-SINGLE-PAGE | superseded | the dedicated reader should always render one visible page at a time, even on wide screens | replaced by the compact-page-shell spread approach for wide screens |
BOOKS-PAGE-IMAGE-SLOT-REQUIRED | accepted | every emitted page should reserve a fixed illustration slot before the text body, falling back to placeholder art when no page image exists | page rhythm stays consistent across the manuscript and missing art does not collapse the layout |
BOOKS-MISSING-IMAGE-REFS-DO-NOT-SHIP | accepted | EPUB generation must strip book image refs when the source illustration file is missing | reader editions prefer missing art over broken asset errors |
BOOKS-REPO-SOURCE-OF-TRUTH | accepted | authored books under books/<slug>/ remain the publishing source of truth | updates must follow the repo content pipeline, not manual copies |
