Next
Next
What to do next in this repo, written so a fresh session (human or AI) can pick this up
cold. See changelog.md for the dated history of what's already shipped.
Four active, deliberately separate work streams — don't conflate them. Each has a GitHub issue linking to its vision/plan doc:
- #1 Concept wiki — the concept-first index. Priority.
- #2 Annotatable reading layer — showing + adding annotations on rendered book text. Separate from the concept wiki.
- #3 People index — like the concept wiki, but for people Wilber engages with (Habermas, Campbell, etc.). Active now, not someday.
- #4 Finer-grained indexing — largely subsumed by #3 in practice; the general "concepts by location" version stays someday.
Important correction from this session
The concept wiki's first pass (7 pages under concepts/) was built from the site
owner's own reading notes (library/1995-sex-ecology-spirituality.md), not the actual
book. That was a mistake made early in the session, before the full text was available
here — going forward, source concept and people pages from the actual book text,
now at library/1995-sex-ecology-spirituality-full-text.md (15,232 lines, originally
converted EPUB→Markdown in a separate private repo, now copied straight into this one —
no ongoing dependency on that other repo; see the file's own header for provenance).
The existing 7 concept pages aren't wrong, just under-sourced — revisit them against
the full text rather than starting over.
Per the site owner: don't worry about copyright/excerpt-length for now — the site isn't meaningfully public yet. Use whatever excerpting works; that policy can be revisited later if this ever becomes a genuinely public/promoted site.
This repo is now self-contained for all four work streams below — no need to go check another repo to pick this up.
For Rufus
This is
- Skim
people/habermas.md— first example of a "people" page built from the real book text (chapter-cited, not notes-cited). If the shape's right, the remaining 6 people already researched inlibrary/1995-sex-ecology-spirituality-people-source.md(Joseph Campbell, Piaget, Freud & Jung, Foucault, Plotinus, Hegel) can be ported the same way.
FEEDBACK 2026-08-23: many more quotes we want at least 3-5 if we can and perhaps dozens would be fine per person. more like whta we have for concept.
docs/annotation-system.mdhas the annotation-system research and recommendation (Recogitotext-annotator-js+ Hypothes.is fallback) — independently corroborated by a second research pass this session, so reasonably high confidence. Nothing built yet. that's fine go for it.
For the AI (next session)
Preliminaries
- Read this file, then the relevant GitHub issue(s) and the doc(s) they link to, before doing anything. Everything needed is in this repo already.
- When you run
fl .(or any Flowershow publish) you'll publish library b/c it doesn't respect excludes but do NOT worry about this as this is a just preview url for teesting and main actual site running off git respects excludes.
Actual work
- Concept wiki (#1): re-derive/extend the 7 existing
concepts/*.mdpages againstlibrary/1995-sex-ecology-spirituality-full-text.mdinstead of the old notes file.- Try to then make a fullish concepts list at concepts/index.md (obviously linking to concepts that have an entry in obvious with with wikilink or whatever)
- then pick the next 5/10/15 (or whatever) concepts that would seem valuable and do them
- People index (#3): port the remaining 6 entries from
library/1995-sex-ecology-spirituality-people-source.mdintopeople/*.mdhere, followingpeople/habermas.md's shape (short synthesis in your own words + a couple of short verbatim quotes, chapter-cited — that source file's quotes run longer than what actually belongs on a public page, don't copy them wholesale). Addpeople/index.md(mirrorconcepts/index.md), cross-link fromconcepts/andworks/1995-sex-ecology-spirituality.md, and add a card to rootindex.md.- Then built a full list / index of potential people and have that list in people/index.md linking to the ones that are actually live
- implement another 10 (or more oif more to be done)
Come to this if you have time.
- Annotation system (#2):
docs/annotation-system.mdalready has a clear recommendation and two-phase build plan — read it and either start Phase 1 or write a short design update todocs/annotatable-reading-layer-vision.mdreflecting the chosen approach before building.