Skip to content
constructionism logo

Constructionism

constructionism

Educational philosophy — learn by building inspectable things

SKILL.md

Full skill instructions

Constructionism

"If you can build it, you can understand it. If you can inspect it, you can trust it."

Seymour Papert's educational philosophy: you learn best by building things you can inspect and modify. Not passive consumption. Not abstract explanation. Construction.

The Tradition

Logo Microworlds — Children don't learn geometry from textbooks. They teach a turtle to draw shapes:

The child:

  1. Builds the procedure
  2. Runs it and sees results
  3. Debugs when it's wrong
  4. Understands geometry through construction

MOOLLM as Microworld

LogoMOOLLM
TurtleAgent/​Character
CanvasRoom floor
ProceduresSkills
VariablesYAML state
DrawingFile creation

Everything is inspectable. Open ROOM.yml — see the state. Read session-log.md — see the history. Modify character.yml — change the world.

Core Principles

Low Floor

Easy to start — no setup, just explore:

> LOOK
You are in the workshop.
> EXAMINE hammer
A simple claw hammer.

High Ceiling

Unlimited complexity — build custom skills, complex pipelines, new protocols.

Wide Walls

Many paths to many goals — adventure games, workflow automation, knowledge organization.

Learning by Doing

The Debug Cycle

  1. Try something — it doesn't work
  2. Inspect state — see what happened
  3. Hypothesize — "maybe the path is wrong"
  4. Modify and retry — test the hypothesis
  5. Understand — now you know how it works

Cheating is Learning

From Don's Logo Adventure:

Type PRINT :ITEMS to see where everything is. Type MAKE "RNUM 5 to teleport to the treasure room. If you cheat, you win by learning Logo.

"Cheating" in MOOLLM:

> Open character.yml directly
> Add "magic_sword" to inventory
> You've learned YAML and file structure!

The system rewards curiosity with knowledge.

Micropolis: The Dream

Don's Micropolis for OLPC applied the same philosophy to SimCity:

  • Open source simulation
  • Scriptable in Python
  • Kids can modify the rules
  • The city IS the curriculum

MOOLLM applies this to LLM agents:

  • Open file state
  • Scriptable in any language
  • Users can modify the rules
  • The filesystem IS the microworld

Embed Micropolis in MOOLLM

cities/​downtown/
├── ROOM.yml           # Room metadata
├── city.save          # Micropolis save file
├── state.yml          # Extracted game state
├── newspaper/         # Generated stories
├── advisors/          # Expert cards
└── session-log.md

LLM reads state, plays the game, summons advisors.

PLAY-LEARN-LIFT

Constructionism in action:

  1. PLAY — Explore manually, make messes
  2. LEARN — Notice patterns, understand
  3. LIFT — Extract principles, create skills

You don't design skills in the abstract. You build them from experience.


Drescher's Schema Mechanism

Gary Drescher's Made-Up Minds (1991) extends constructionism into a computational theory of how minds learn causal models. Drescher was a student of Minsky at MIT.

See: ../​schema-mechanism/ for the full treatment.

The Core Idea

A schema is a causal unit: Context → Action → Result

The agent discovers schemas through experience, refining them via marginal attribution -- tracking which conditions correlate with success.

Connection to PLAY-LEARN-LIFT

Schema MechanismPLAY-LEARN-LIFT
ACT + OBSERVEPLAY
ATTRIBUTE (marginal attribution)LEARN
SPIN OFF (refine schemas)LIFT

Why LLMs Complete Drescher

AspectDeterministicLLM + YAML Jazz
ItemsOpaque tokensGrounded meanings
PatternsStatistical correlationSemantic understanding
Spin-offsMechanicalCreative generalization
ExplanationsNoneNatural language

"The YAML provides the skeleton; the LLM provides the soul."


The Insight

"If you can build it, you can understand it." "If you can inspect it, you can trust it." "The filesystem IS the microworld."

See also: schema-mechanism for Drescher's computational extension.

More Productivity & Planning skills

brainstorming logo
Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K
View
ui-ux-pro-max logo
Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K
View
writing-plans logo
Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K
View
using-superpowers logo
Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K
View
executing-plans logo
Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K
View
dispatching-parallel-agents logo
Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View
using-git-worktrees logo
Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K
View
webapp-testing logo
Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K
View
content-strategy logo
Productivity & Planning

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
repo-intake-and-plan logo
Productivity & Planning

repo-intake-and-plan

README-first repository scanner that extracts commands and classifies reproduction candidates without executing them.

497 139.6K
View
marketing-ideas logo
Productivity & Planning

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
site-architecture logo
Productivity & Planning

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View

Productivity AI tools

Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
SaveDay logo
Productivity

SaveDay

Capture, organize, and utilize your knowledge effortlessly.

Free
View
A
Productivity

Any Summary

Instant Summaries of Audio & Video Interviews with AnySummary

Freemium
View
M
Productivity

Map This

Transform PDFs into engaging mind maps.

Freemium
View
ChatPDF logo
Productivity

ChatPDF

Chat with any PDF instantly

Free
View
I
Productivity

intellisay

Create an optimal daily plan using your voice

Paid
View
A
Productivity

Aurora AI

A productivity platform to centralize organizational knowledge and workflows with contextual AI assistance.

Paid
View
AskYourPDF logo
Productivity

AskYourPDF

AskYourPDF Pricing Plans: Tailored to Your Needs

Free
View