Files
opus-orchestrator-ai/docs/NONFICTION_PIPELINE.md
T
mrhavens d98ef622d9 feat: Add nonfiction taxonomy - Purpose × Structure matrix
- Created nonfiction_taxonomy.py with:
  - ReaderPurpose enum (6 purposes)
  - StructuralPattern enum (7 patterns)
  - PURPOSE_STRUCTURE_MATRIX for intelligent selection
  - NONFICTION_FRAMEWORKS (14+ frameworks)
  - select_framework() function

- Created docs/NONFICTION_PIPELINE.md documenting the workflow

This is the foundation for Issue #16 (Nonfiction Underdeveloped)
2026-03-13 20:00:30 +00:00

90 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Nonfiction Generation Pipeline
# ==============================
# How the workflow CHANGES based on Purpose × Structure
## INPUT PHASE
## -----------
# User provides: concept, purpose (why read), category (subject), optional preferred framework
#
# Example inputs:
# - "Leadership for introverts" + PURPOSE=TRANSFORM + CATEGORY=LEADERSHIP
# - "How to code in Python" + PURPOSE=LEARN_HANDS_ON + CATEGORY=TECHNOLOGY
# - "Why nations fail" + PURPOSE=DECIDE + CATEGORY=HISTORY
## CLASSIFICATION PHASE (NEW)
## ---------------------------
# System maps: purpose → framework families → specific framework
#
# if PURPOSE == "learn_hands_on":
# framework = select("tutorial" or "howto")
# stages = ["prerequisites", "step 1", "step 2", ...]
#
# elif PURPOSE == "transform":
# framework = select("transformation_journey" or "mountain_structure")
# stages = ["wake-up", "denial", "dark night", ...]
#
# elif PURPOSE == "decide":
# framework = select("big_idea" or "problem_solution")
# stages = ["problem", "evidence", "solution", ...]
## SCAFFOLDING PHASE (CHANGES)
## ---------------------------
# Different STAGES based on framework
#
# TUTORIAL scaffold:
# - Introduction → Prerequisites → Step 1 → Step 2 → Step 3 → Completion → Next Steps
#
# TRANSFORMATION_JOURNEY scaffold:
# - Wake-Up → Denial → Dark Night → Realization → Path → Struggles → Breakthrough → New Normal
#
# BIG_IDEA scaffold:
# - Promise → Opposition → Evidence → Implications → Counter-Arguments → Conclusion
## DRAFTING PHASE (CHANGES)
## ------------------------
# Different AGENTS activated based on purpose
#
# if PURPOSE == "learn_hands_on":
# agent = "TutorialWriter" # Focus on clarity, exercises, checkpoints
# tone = "encouraging, clear, patient"
#
# elif PURPOSE == "transform":
# agent = "TransformationWriter" # Focus on emotion, narrative, inspiration
# tone = "empathetic, honest, motivational"
#
# elif PURPOSE == "decide":
# agent = "EvidenceWriter" # Focus on data, proof, credibility
# tone = "authoritative, data-driven, persuasive"
## CRITIQUE PHASE (CHANGES)
## ------------------------
# Different EVALUATION CRITERIA based on purpose
#
# if PURPOSE == "learn_hands_on":
# check: "Can a reader actually complete the steps?"
# check: "Are prerequisites clear?"
# check: "Is there a sense of progression?"
#
# elif PURPOSE == "transform":
# check: "Does it feel emotionally honest?"
# check: "Is the transformation arc believable?"
# check: "Would this inspire change?"
#
# elif PURPOSE == "decide":
# check: "Is the evidence credible?"
# check: "Are counter-arguments addressed?"
# check: "Does it lead to a clear recommendation?"
## OUTPUT PHASE (CHANGES)
## ----------------------
# Different FORMAT based on purpose
#
# if PURPOSE == "learn_hands_on":
# format = "markdown_with_code_blocks, exercises, checkpoints"
#
# elif PURPOSE == "transform":
# format = "narrative_chapters, emotional_arcs"
#
# elif PURPOSE == "reference":
# format = "indexed_sections, cross_references, searchable"