opus-orchestrator-ai/docs/NONFICTION_FRAMEWORKS.md

Nonfiction Framework Library

Opus supports 100+ frameworks organized by content type.

Reader Purposes

Every nonfiction book serves a reader purpose - why someone reads it:

Purpose	Description	Example Frameworks
learn	Do something hands-on	Tutorial, How-To, Course
understand	Grasp a concept	Explainer, Socratic Method
transform	Change themselves	Self-Help, Memoir
decide	Make a decision	Big Idea, Case Study
reference	Look up information	Manual, Encyclopedia
inspire	Feel motivated	Manifesto, Story

Framework Categories

Tutorial/How-To

• Tutorial
• Howto
• Minimalist How-To
• Challenge-Response
• Reverse Engineering
• PAS (Problem-Agitation-Solution)

Explanation/Concept

• Concept Explainer
• Explainer (Pinker-style)
• Socratic Method
• Danish Philosopher
• Argumentative Essay
• Mental Models

Transformation/Self-Help

• Transformation Journey
• Mountain Structure
• Atomic Habits Style
• Loss and Gain
• Mistake → Learning

Decision/Business

• Big Idea (Jim Collins)
• Problem-Solution
• Case Study
• Blue Ocean Strategy
• The One Thing
• 4 Disciplines of Execution

Reference/Technical

• Technical Manual
• Quick Reference Guide
• Knowledge Base
• API Documentation
• Encyclopedia

Inspiration/Manifesto

• Visionary
• Manifesto
• Open Letter
• Biography
• Memoir

Textbook/Educational

Framework	Description
Comprehensive Textbook	Complete academic textbook
Textbook Chapter	Single modular chapter
Online Course / MOOC	Video-friendly course
Curriculum / Syllabus	Course planning document
Study Guide	Exam prep
Workbook	Interactive exercises

Academic Papers

Framework	Description
Empirical Paper	IMRAD research format
Theoretical Paper	Models, proofs
Methodology Paper	New methods
Case Study	Single case analysis
Survey Paper	Field overview
Position Paper	Argumentative stance
Policy Brief	Recommendations
Literature Review	Systematic synthesis
Thesis/Dissertation	Graduate research
Meta-Analysis	Statistical synthesis

Creative/Interactive

Framework	Description
Choose Your Own Adventure	Branching narrative
Gamebook	RPG-style adventure
Visual Novel	Anime-style script
Epistolary Novel	Letters/emails/texts
Found Documents	Discovered artifacts
Manifesto	Revolutionary call
Open Letter	Public letter
Infinite Story	Serial/neverending
Fractal Narrative	Self-similar structure
Podcast Script	Spoken audio
Screenplay	Film script
Stage Play	Theatrical script

RPG/Tabletop

Framework	Description
Core Rulebook	Main game system
Quickstart	Condensed intro
Game Master Guide	Running games
Adventure Module	Ready-to-run
Campaign Setting	World sourcebook
Player's Companion	New options
Monster Manual	Creatures catalog
Dungeon Crawl	Classic dungeon
Hex Crawl	Sandbox exploration
Worldbuilding Guide	How to build worlds
Solo Adventure	Single player
LARP Document	Live action

Usage

# List all frameworks
opus frameworks

# Generate with purpose
opus generate --book-type nonfiction --purpose learn "How to code in Python"

# Generate with category
opus generate --book-type nonfiction --category business --framework big_idea

# Specific framework
opus generate --book-type nonfiction --framework transformation_journey

Programmatic Usage

from opus_orchestrator.nonfiction import (
    determine_intake,
    suggest_framework_for_book,
    suggest_textbook_framework,
    suggest_academic_paper,
    suggest_creative_framework,
    suggest_rpg_framework,
)

# Auto-suggest framework
result = await determine_intake(
    concept="How to build an AI startup",
    purpose="learn",
    category="business"
)
# → Purpose: learn_hands_on
# → Framework: Tutorial / How-To

# Suggest for specific use case
framework = suggest_textbook_framework(
    use_case="online course",
    audience="beginners",
    length="medium"
)