From 35c84cf943e16aeb20000ddc2d7c3590752303ae Mon Sep 17 00:00:00 2001 From: Julien Calixte Date: Wed, 17 Jun 2026 08:50:52 +0200 Subject: [PATCH] docs: reword the Macroplan definition to be less flat Lead with the promise-vs-reality tension ("keeps the receipts") instead of the limp "learning-oriented record of what we committed to deliver". --- CONTEXT.md | 4 ++-- README.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTEXT.md b/CONTEXT.md index 01137b4..ea1b538 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -1,11 +1,11 @@ # Macroplan -A **Macroplan** is a week-granular view of the features we've committed to deliver — a simpler cousin of a Gantt chart whose purpose is not just scheduling but *learning* from how our estimates held up over time. +A **Macroplan** is a week-by-week plan that keeps the receipts: what we promised to deliver, when it actually landed, and what the gap taught us — a simpler cousin of a Gantt chart whose purpose is not just scheduling but *learning*. ## Language **Macroplan**: -A week-granular plan of the **Features** we've committed to deliver, read as a record of how estimates held against reality. +A week-by-week plan that keeps the receipts on the **Features** we promised: when each actually landed, and what the gap taught us. _Avoid_: Gantt, roadmap, timeline **Feature**: diff --git a/README.md b/README.md index 5ce2a9c..2fc5ce5 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Macroplan -A week-granular, **learning-oriented** view of the features a team has committed to deliver — a simpler cousin of a Gantt chart whose point is not just scheduling but learning from *how our estimates held up over time*. +A week-by-week plan that keeps the receipts on what a team promised to deliver — a simpler cousin of a Gantt chart whose point is not just scheduling but learning from *how our estimates held up over time*. Each feature reads left-to-right as a story: where it started, what we first promised, every time it slipped, and when it actually shipped — judged honestly against the **first** estimate, never a moved goalpost.