ح
Holistic Health AI

Preview · Proposed Structure · Awaiting Approval

Living Library Construction Manual — v1.0 (Table of Contents)

Status: APPROVED & FROZEN — Living Library Construction Manual v1.0. Table of Contents approved. Structure frozen as the official v1.0 baseline on 2026-07-27. Chapter 1 drafting is underway; no later chapter may begin until Chapter 1 completes the full validation workflow and is formally approved. No further structural changes may be made outside the Part VIII governance / versioning process.

Scope: defines how Living Library guides are constructed. Independent of how users enter the product (Library, Hakim, Companion, or future surfaces).

Preface — Purpose of this Manual

This is a construction manual, not a style guide. A style guide tells a writer how a sentence should sound. This manual defines how a Living Library guide is conceived, built, validated, frozen, published, and improved — the full life of a guide from the first decision that it deserves to exist to the moment a future revision retires part of it.

It is the canonical construction standard for all Living Library guides. Every guide in the Living Library — present and future — is built, validated, frozen, published, and revised under the rules recorded here. No parallel standard, house preference, or one-off workflow overrides it.

It exists so the next guide does not have to relearn what Mission Saffron already taught. Saffron was the first guide taken through every stage of Living Library construction — teaching intent, medium selection, zero-cost photography, human validation, and freeze. Those documented lessons are captured here as permanent standards so every future guide begins where Saffron finished instead of repeating the same mistakes.

Every future revision of this manual must be justified by documented evidence — real guides built, real readers tested, real failures observed — routed through the manual versioning process in Part VIII. The manual evolves intentionally through experience, not opinion. It does not change through drift, preference, or convenience.

If a rule in this manual gets in the way of a specific guide, the answer is not to bend the rule quietly. The answer is to complete the guide under the current rule, record what the rule cost, and bring that evidence to the next scheduled retrospective. That is how v1.1 will be earned.

Architectural freeze vs. chapter approval. The Living Library Construction Manual v1.0 freezes the architecture of the system — its structure, workflow, governance, and standards. Individual chapters are not considered frozen until each chapter has successfully completed the full validation workflow and received formal approval. The architecture is stable from day one; the content earns its freeze one chapter at a time, under the same discipline this manual requires of every future Living Library guide.

Universal Validation Principle

The validation workflow is universal, but the validation instrument is document-specific.

The same approval sequence applies to every artifact in the Living Library ecosystem:

AI Advisory Pre-Check → Editorial Review → Image Review (if applicable) → Licensing Review (if applicable) → Uncoached First-Time Human Validation → Final Approval → Freeze.

However, the validation questions must match the artifact being tested:

  • Living Library Guides use the Guide Validation Kit to verify that readers understand the health topic, retain the important lessons, and can apply what they learned.
  • Construction manuals, governance documents, and editorial standards use the Manual Validation Kit to verify that first-time readers can correctly understand and execute the documented process without coaching.

The workflow never changes. Only the evaluation instrument changes to match the purpose of the document. This manual is validated under the Manual Validation Kit; guides are validated under the Guide Validation Kit.

#### Purpose of Validation

The purpose of validation is not to confirm that the author believes the work is correct.

The purpose of validation is to reduce publication risk through independent evidence.

Validation exists to answer one question:

"Is there sufficient objective evidence to publish with confidence?"

Confidence is never evidence.

Familiarity is never evidence.

Creator judgment is never evidence.

Independent validation is the evidence.

Every stage of the Living Library workflow — AI advisory review, editorial review, image verification, licensing verification, uncoached first-time human validation, and final approval — exists to reduce uncertainty before publication.

This principle applies equally to guides, construction manuals, governance documents, editorial standards, validation kits, and every future Living Library artifact.

This clarification strengthens the philosophy of the manual but does not modify its structure, workflow, governance, validation sequence, or approval requirements. The Living Library Construction Manual remains Version 1.0.

Part I — Foundations

1.Purpose of the Living Library

2.What a Guide Is (and Is Not)

3.Editorial Constitution & Voice Standards

4.Roles & Editorial Ownership

5.Architecture Assumption (new)

  • This manual defines guide construction only. Navigation surfaces may evolve without changing these standards.

6.The Integrated Editorial System (new — permanent)

  • Guide construction is governed by one continuous workflow of three linked standards. They are never applied independently.

```text

Teaching Before Writing

↓

Determines what deserves to exist.

↓

Every Element Must Earn Its Place

↓

Verifies every chapter, paragraph, sentence, image, diagram,

interaction, and feature still deserves to exist after construction.

↓

Stop Rules

↓

Defines when enough OBJECTIVE evidence exists to freeze v1.0

and move forward. Freeze authority = human validation gate,

never the creator's self-assessment.

```

Part II — Guide Architecture

7.The Gold Standard Engine (configuration + content only, no custom rendering)

8.Chapter Model: Hero → Menu → Chapters → Close

9.Reader Mode vs Editorial Mode (dual presentation)

10.Accessibility & Reading Levels

11.Metadata, SEO, and Trust Surfaces

Part III — Content Standards

12.Teaching Before Writing (Standard 1 of the integrated system)

  • Decide the lesson before a single word, image, or interaction is chosen.
  • Nothing enters a guide that does not teach.
  • Permanent Chapter Blueprint Template. Every chapter blueprint must contain, in this order: (1) Teaching Objective · (2) Seven-Question Architectural Review · (3) Why This Chapter Cannot Be Deleted · (4) Success Criteria · (5) Blueprint Approval Declaration · (6) Blueprint Approval. All six sections must be approved before drafting is authorized.
  • Success Criteria are written before drafting begins and are objective and measurable. Validation later determines whether those criteria were achieved; the criteria themselves are never rewritten to match the draft. This prevents rewriting toward a moving target.
  • Blueprint Approval Declaration (permanent). Before signing the Blueprint Approval gate, the approver must explicitly confirm: Teaching Objective complete; Seven-Question Architectural Review complete; chapter deserves to exist; Success Criteria objective, measurable, and achievable through the defined validation workflow; no additional planning required. On approval, the chapter's purpose, scope, architecture, and Success Criteria are locked. Drafting may improve clarity, wording, organization, examples, and presentation only; drafting may NOT change purpose, scope, architecture, or Success Criteria. Any such change requires reopening the Blueprint through the Living Library governance and versioning process before drafting continues.
  • Per-chapter sequence (permanent): Blueprint → Blueprint Review → Blueprint Approval → Draft → Editorial Review → Image Review (if applicable) → Licensing Review (if applicable) → AI Advisory Pre-Check → Uncoached First-Time Human Validation → Final Approval → Freeze → Begin the next chapter.

13.The Kitchen Table Test (Teach, Don't Translate)

14.Hakim Voice Standards

15.Safety, Contraindications & Evidence Levels

16.Citations & Source Discipline

17.Cultural Authenticity Rules

Part IV — Visual Teaching Principles (new)

18.Choose the Teaching Medium Before the Image

  • Authentic photograph
  • Historical document
  • Historical artifact
  • Diagram
  • Comparison graphic
  • Timeline
  • Illustration (only when appropriate)

19.Worked Examples from Mission Saffron

  • Blooming Sequence → diagram may outperform a single photograph
  • Real vs Fake → requires a true comparison image
  • Silk Road → historical artifacts over modern photography
  • Storage → authentic photography is strongest

20.When No Suitable Medium Exists Yet (defer, don't improvise)

Part V — Photography & Asset Policy

21.No AI Photography in Published Guides (permanent)

22.Zero-Cost First — Free When Equally Effective (default rule)

23.Budget & Asset Strategy (new)

  • Per-guide photography budget policy
  • Written justification required before any paid or commissioned photography
  • Three-question spending test

24.When No Authentic Image Exists Within Budget (new)

  • Documented options: wait · commission · diagram · publish without photograph
  • Decision must follow policy, never improvisation

25.Licensing Workflow & Attribution Compliance

26.Asset Reuse Across Guides

Part VI — Every Element Must Earn Its Place (Standard 2 of the integrated system)

27.The Earn-Its-Place Audit

  • After construction, re-examine every chapter, paragraph, sentence, image, diagram, interaction, and feature.
  • Remove anything that does not measurably teach.

28.Internal AI Pre-Check (advisory only)

29.Editorial Review

30.Image Verification

31.Licensing Verification

32.Uncoached First-Time Human Reader Testing (mandatory gate)

33.Refinement

34.Final Approval

35.Publication

Permanent rule: AI review can NEVER replace first-time human validation.

Part VII — Stop Rules (Standard 3 of the integrated system)

36.When to Freeze Version 1.0

  • Freeze only on OBJECTIVE evidence, never on the creator's belief the guide is finished.
  • Any Stop Rule that relies on judgment ("no objectively better source exists", "comprehension no longer improves", "further revisions are cosmetic rather than educational") MUST be resolved through the Part VI validation workflow, in this permanent order:

1. AI pre-check (advisory only)

2. Editorial review

3. Licensing verification

4. Uncoached first-time human reader testing

5. Freeze decision

  • The human validation gate is the final authority. No self-certification.

37.Publishing Gates & Freeze Criteria

38.Content Freshness & Staleness Review

39.Corrections, Retractions & Revision History

Part VIII — Governance

40.Lessons Learned from Mission Saffron (canonical record)

41.Manual Versioning (new)

  • After every three completed Living Library guides, conduct a structured retrospective.
  • Update the manual only when documented lessons justify a new version.
  • The manual evolves intentionally — never through undocumented changes.

42.Change Log

  • v1.0 — 2026-07-27 — Official baseline. Table of Contents approved and frozen. Preface ("Purpose of this Manual") added. Structure locked; no further structural changes without a governed version bump. Chapter 1 drafting authorized; no later chapter may begin until Chapter 1 completes the full Part VI validation workflow and is formally approved.
  • v1.0 — 2026-07-27 — Universal Validation Principle recorded. Preface expanded to (a) distinguish architectural freeze from chapter approval and (b) codify the Universal Validation Principle: one universal workflow, document-specific instrument (Guide Validation Kit for guides; Manual Validation Kit for manuals, governance, and standards). Appendix C split into C1 (Guide Validation Kit) and C2 (Manual Validation Kit). No structural change to Parts I–VIII.
  • v1.0 — 2026-07-27 — "Purpose of Validation" clarification added. Preface subsection appended to the Universal Validation Principle to state that validation reduces publication risk through independent evidence, not author confidence. No structural change to Parts I–VIII.
  • v1.0 — 2026-07-27 — Blueprint discipline clarified. Part III §12 (Teaching Before Writing) updated to require the permanent field "Why this chapter cannot be deleted" on every chapter blueprint, and to record the permanent per-chapter sequence: Blueprint → Blueprint Review → Blueprint Approval → Draft → Editorial Review → Image Review (if applicable) → Licensing Review (if applicable) → AI Advisory Pre-Check → Uncoached First-Time Human Validation → Final Approval → Freeze → Begin the next chapter. Clarification only; no structural change to Parts I–VIII.
  • v1.0 — 2026-07-27 — Permanent Chapter Blueprint Template recorded. Part III §12 updated to require the five-section blueprint template on every chapter: (1) Teaching Objective, (2) Seven-Question Architectural Review, (3) Why This Chapter Cannot Be Deleted, (4) Success Criteria, (5) Blueprint Approval. Success Criteria are objective, measurable, and frozen before drafting; validation later determines whether they were achieved. Methodology clarification only; no structural change to Parts I–VIII.
  • v1.0 — 2026-07-27 — Blueprint Approval Declaration added. Part III §12 updated to expand the permanent Chapter Blueprint Template from five to six sections by inserting Blueprint Approval Declaration between Success Criteria and Blueprint Approval. The declaration is the approver's explicit, itemized commitment that Teaching Objective, Seven-Question Architectural Review, "Why this chapter cannot be deleted", and Success Criteria are complete and that no additional planning is required. On approval, purpose, scope, architecture, and Success Criteria are locked; drafting may improve clarity, wording, organization, examples, and presentation only, and may not change purpose, scope, architecture, or Success Criteria. Any such change requires reopening the Blueprint through governance and versioning. Applies to every future Living Library chapter and every future Living Library guide blueprint. Methodology clarification only; no structural change to Parts I–VIII.
  • v1.0 — 2026-07-27 — Published Preview Verification Rule recorded. New permanent methodology clarification: no blueprint, chapter, review packet, validation packet, checklist, or manual artifact may be marked Complete, Ready for Review, Awaiting Approval, Approved, or Published until its published preview URL has been independently verified to load successfully in a clean session (HTTP 200) and the complete artifact has been confirmed to render correctly. A broken or inaccessible preview is a failed validation, not a completed deliverable. Applies to every future Living Library artifact, without exception. Methodology clarification only; no structural change to Parts I–VIII.

Appendices

  • A. Guide Configuration Reference
  • B. Editorial Checklists (per phase)
  • C. Human Reader Test Kit (Observer Checklist + Reader Questionnaire)
  • C1. Guide Validation Kit (for Living Library guides)
  • C2. Manual Validation Kit (for construction manuals, governance, and editorial standards)
  • D. Licensing Worksheet Template
  • E. Attribution Format Reference
  • F. Glossary

Why each new section was added

  • The Integrated Editorial System (Part I §6): the three permanent standards — Teaching Before Writing, Every Element Must Earn Its Place, and Stop Rules — are one continuous workflow, not three separate philosophies. Standard 1 decides what deserves to exist. Standard 2 verifies that everything constructed still deserves to exist. Standard 3 defines when objective evidence permits a freeze. Documenting the linkage prevents future contributors from applying any one standard in isolation.
  • Stop Rules routed through validation (Part VII §36): every judgment-based freeze criterion must pass the Part VI workflow — AI pre-check (advisory) → editorial review → licensing verification → uncoached first-time human reader testing → freeze decision. This closes the self-certification loophole: a guide can never be frozen because its creator believes it is finished; the human validation gate is the final authority.
  • Architecture Assumption (Part I §5): protects guide construction from being coupled to shifting navigation (Library / Hakim / Companion / future surfaces). Prevents future rewrites when entry points change.
  • Visual Teaching Principles (Part IV): Saffron proved that forcing photography onto every chapter degrades teaching. The medium must be chosen for educational effectiveness before an image is selected.
  • Budget & Asset Strategy (Part V §21): Saffron ran on a $100 cap and closed at $0 spent. That discipline must be codified, not repeated ad hoc.
  • When No Authentic Image Exists Within Budget (Part V §22): the Saffron sprint repeatedly hit this fork. A documented decision path (wait · commission · diagram · publish without) removes improvisation.
  • Every Element Must Earn Its Place / Validation Workflow (Part VI): the Saffron pre-check made explicit that AI review is advisory only. Encoding the full sequence — with uncoached first-time human testing as the mandatory gate — prevents skipping straight from AI review to publication, and forces every constructed element to re-justify its existence before publication.
  • Manual Versioning (Part VIII §37): locks in a cadence (every three guides) so this document evolves through evidence, not drift.

Preserved from existing standards (unchanged, not weakened)

  • No AI photography in published guides
  • Editorial ownership and voice
  • Licensing workflow and attribution
  • Human validation as the final gate
  • Publishing gates and freeze criteria
  • Mission Saffron lessons kept as a canonical record

Confirmation

This is the approved Living Library Construction Manual v1.0 structure, frozen as the official v1.0 baseline. From this point forward, chapters are drafted one at a time and validated fully before the next chapter begins. Chapter 1 is in draft; Chapter 2 will not begin until Chapter 1 has completed editorial review, image review (if applicable), licensing review (if applicable), AI advisory pre-check, uncoached first-time human validation, and final approval.