Engineering

Rationale Encoding in Practice

How to embed intent, purpose, and design rationale into systems through constraints, declarative policies, environmental traces, and documentation — and why it decays.

7 modules

What Systems Are For

The philosophical foundations of rationale, intent, and purpose in software artifacts

Encoding Intent Through Structure

How invariants, interfaces, and fitness functions carry design purpose forward

Declarative Systems and Intent Preservation

How intent-based architectures close the gap between what you mean and what your system does

Coordination Without a Room

How stigmergy explains the way codebases, repositories, and open-source projects guide behavior through traces — not directives

Explicit Capture Tools for Design Rationale

A field guide to the methods built to record the why — and why most of them failed

Decay and Sustainability

Why encoded rationale degrades — and what a durable knowledge practice actually looks like

Synthesis and Practice

Designing layered rationale encoding strategies for real systems and teams

How this plan was made

Each plan on learnings is built by a hand-crafted agentic pipeline: research agents gather primary sources, a claim reviewer verifies facts against them, and a sequencer orders modules for how people actually learn. The curation — topic selection, framing, editorial standards — is Nicolas's. The research and writing is AI-assembled.