Juarrero Learning System

A beginner-first path through Alicia Juarrero’s work on constraints, context, coherence, and complex organization.

Built on top of the research archive in ../complexity/juarrero-research/ — but you do not start there.

Browse in the browser (recommended)

Local

cd juarrero-wiki
./run.sh
# → http://127.0.0.1:8765/

Or manually:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python serve.py --open

Options: --port 8765 · --host 127.0.0.1 · --open

Public (Cloudflare Pages)

Static export of the learning system (excludes personal 07-working-notes/).

# Build only → dist/
.venv/bin/python build.py

# Build + deploy (requires Cloudflare login once)
./deploy.sh

First deploy runs npx wrangler pages deploy and may open a browser to log in to Cloudflare.
Project name: juarrero-learning (override with CLOUDFLARE_PAGES_PROJECT=...).

After deploy, wrangler prints the public *.pages.dev URL.

Start here (files)

→ START-HERE.md → 00-start-here/welcome.md

If you want…	Open…
Orientation (15 min)	00-start-here/welcome.md
The learning path	01-path/M00-map.md
Progress checklist	01-path/_progress.md
Core claims	02-claims/_index.md
Glossary	03-concepts/_index.md
“So what?”	04-applications/_index.md
Talk playlist	06-sources/beginner-playlist.md

Design (why not “just a wiki”?)

Layer	Role
Path	Ordered absorption — use first
Claims	Mastery checkpoints
Concepts	On-demand glossary
Applications	Transfer & retention
Maps / sources	Navigation & depth

PATH → CLAIMS → CONCEPTS (as needed)
         ↓
    APPLICATIONS
         ↓
    SOURCES / REPORT (when ready)

Folder map

juarrero-wiki/
├── START-HERE.md
├── 00-start-here/     welcome, overview, how-to, FAQ
├── 01-path/           M00–M08 taught modules
├── 02-claims/         C001–C012
├── 03-concepts/       glossary pages
├── 04-applications/   orgs, design, cognition, …
├── 05-maps/           timelines, examples, dependencies
├── 06-sources/        curated depth (not full dumps)
├── 07-working-notes/  your answers & questions
└── 08-advanced/       optional (precursors, talk-forward)

Relation to the research corpus

Need	Where
Learn (beginner)	This folder
Full synthesis handbook	`../complexity/juarrero-research/REPORT-juarrero-complete-content.md`
Illustrated report	`../complexity/juarrero-research/html/REPORT-juarrero-complete-content.html`
Transcripts / book text	`../complexity/juarrero-research/`
Precursor PDFs	`../books/`

This system distills and sequences. The research folder stores and searches.

First-pass estimate

Block	Modules	~Time
A — Core theory	M01–M03	3–4 h
B — Structure	M04–M06	3–4 h
C — Transfer	M07–M08 + one application	2–3 h

Total: ~8–12 hours.

Naming

Concepts: kebab-case.md
Claims: C###-short-slug.md
Modules: M0N-title.md
Wikilinks: [enabling-constraint](/page/03-concepts/enabling-constraint) (Obsidian-friendly)