From d83edccc794a042412b6315cc9bbf46ee91a93a0 Mon Sep 17 00:00:00 2001 From: Lucas Winther Date: Wed, 2 Sep 2026 21:56:59 +0200 Subject: [PATCH] docs: move the long-form docs into docs/, without the superpowers nesting ARCHITECTURE, PRODUCT and TODO move out of the repository root, and docs/superpowers/{specs,plans} flattens to docs/{specs,plans}: "superpowers" names the tool that wrote those documents, not a kind of document. No content changes. This commit is the move, plus the roughly thirty cross-references the move invalidated. Co-Authored-By: Claude Opus 5 (1M context) --- AGENTS.md | 8 ++++---- CLAUDE.md | 8 ++++---- README.md | 4 ++-- ARCHITECTURE.md => docs/ARCHITECTURE.md | 8 ++++---- PRODUCT.md => docs/PRODUCT.md | 0 TODO.md => docs/TODO.md | 8 ++++---- docs/{superpowers => }/plans/2026-09-01-budget-app.md | 8 ++++---- .../plans/2026-09-02-versioned-allocation-rules.md | 2 +- .../specs/2026-09-01-budget-app-design.md | 4 ++-- .../specs/2026-09-02-design-foundation-design.md | 2 +- .../specs/2026-09-02-fast-entry-refinements-design.md | 0 .../specs/2026-09-02-month-view-design.md | 4 ++-- .../specs/2026-09-02-versioned-allocation-rules-design.md | 0 scripts/demo-data.ts | 4 ++-- scripts/fetch-fonts.ts | 2 +- scripts/screenshot.ts | 2 +- src/cssPairs.test.ts | 0 src/domain/types.ts | 0 src/index.css | 0 src/store/actions.ts | 0 src/ui/components/RuleHistory.tsx | 0 21 files changed, 32 insertions(+), 32 deletions(-) mode change 100644 => 100755 AGENTS.md mode change 100644 => 100755 CLAUDE.md mode change 100644 => 100755 README.md rename ARCHITECTURE.md => docs/ARCHITECTURE.md (96%) mode change 100644 => 100755 rename PRODUCT.md => docs/PRODUCT.md (100%) mode change 100644 => 100755 rename TODO.md => docs/TODO.md (97%) mode change 100644 => 100755 rename docs/{superpowers => }/plans/2026-09-01-budget-app.md (99%) mode change 100644 => 100755 rename docs/{superpowers => }/plans/2026-09-02-versioned-allocation-rules.md (99%) mode change 100644 => 100755 rename docs/{superpowers => }/specs/2026-09-01-budget-app-design.md (99%) mode change 100644 => 100755 rename docs/{superpowers => }/specs/2026-09-02-design-foundation-design.md (98%) mode change 100644 => 100755 rename docs/{superpowers => }/specs/2026-09-02-fast-entry-refinements-design.md (100%) mode change 100644 => 100755 rename docs/{superpowers => }/specs/2026-09-02-month-view-design.md (98%) mode change 100644 => 100755 rename docs/{superpowers => }/specs/2026-09-02-versioned-allocation-rules-design.md (100%) mode change 100644 => 100755 mode change 100644 => 100755 scripts/demo-data.ts mode change 100644 => 100755 scripts/fetch-fonts.ts mode change 100644 => 100755 scripts/screenshot.ts mode change 100644 => 100755 src/cssPairs.test.ts mode change 100644 => 100755 src/domain/types.ts mode change 100644 => 100755 src/index.css mode change 100644 => 100755 src/store/actions.ts mode change 100644 => 100755 src/ui/components/RuleHistory.tsx diff --git a/AGENTS.md b/AGENTS.md old mode 100644 new mode 100755 index d935c21..e002bc6 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,13 +6,13 @@ validation this codebase deliberately does not perform. Then, depending on what you are doing: -- **Changing anything structural** → `ARCHITECTURE.md` (layers, data flow, and +- **Changing anything structural** → `docs/ARCHITECTURE.md` (layers, data flow, and why the non-obvious choices are what they are). -- **Picking up queued work** → `TODO.md` (ordered, each item carrying the +- **Picking up queued work** → `docs/TODO.md` (ordered, each item carrying the reasoning already settled). -- **Making a product decision** → `PRODUCT.md` (who this is for, what must never +- **Making a product decision** → `docs/PRODUCT.md` (who this is for, what must never break, and what must not be invented). -- **Wondering why something is the way it is** → `docs/superpowers/specs/` +- **Wondering why something is the way it is** → `docs/specs/` records the decisions *and the alternatives that were rejected*. Two rules worth knowing before your first edit: diff --git a/CLAUDE.md b/CLAUDE.md old mode 100644 new mode 100755 index aa36d43..cc5cfbb --- a/CLAUDE.md +++ b/CLAUDE.md @@ -144,11 +144,11 @@ For more information, read the Bun API docs in `node_modules/bun-types/docs/**.m ## Start here -- `ARCHITECTURE.md` — layers, data flow, and why the non-obvious choices are +- `docs/ARCHITECTURE.md` — layers, data flow, and why the non-obvious choices are what they are. Read it before changing anything structural. -- `TODO.md` — queued work, each item carrying the reasoning already settled. -- `PRODUCT.md` — who this is for and what must never break. -- `docs/superpowers/specs/` — design decisions, including alternatives rejected. +- `docs/TODO.md` — queued work, each item carrying the reasoning already settled. +- `docs/PRODUCT.md` — who this is for and what must never break. +- `docs/specs/` — design decisions, including alternatives rejected. ## Gotchas that cost real bugs diff --git a/README.md b/README.md old mode 100644 new mode 100755 index 93d2f19..6915d59 --- a/README.md +++ b/README.md @@ -53,5 +53,5 @@ your current data first. ## Documentation -- Design: `docs/superpowers/specs/2026-09-01-budget-app-design.md` -- Implementation plan: `docs/superpowers/plans/2026-09-01-budget-app.md` +- Design: `docs/specs/2026-09-01-budget-app-design.md` +- Implementation plan: `docs/plans/2026-09-01-budget-app.md` diff --git a/ARCHITECTURE.md b/docs/ARCHITECTURE.md old mode 100644 new mode 100755 similarity index 96% rename from ARCHITECTURE.md rename to docs/ARCHITECTURE.md index 9c1ae98..58a02f0 --- a/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -175,7 +175,7 @@ timing that happy-dom does not reproduce. ## Where the reasoning lives -- `PRODUCT.md` — durable product truth: who it is for, what must never break. -- `TODO.md` — queued work, with the reasoning behind each decision already made. -- `docs/superpowers/specs/` — design decisions and the alternatives rejected. -- `docs/superpowers/plans/` — task-by-task implementation plans. +- `docs/PRODUCT.md` — durable product truth: who it is for, what must never break. +- `docs/TODO.md` — queued work, with the reasoning behind each decision already made. +- `docs/specs/` — design decisions and the alternatives rejected. +- `docs/plans/` — task-by-task implementation plans. diff --git a/PRODUCT.md b/docs/PRODUCT.md old mode 100644 new mode 100755 similarity index 100% rename from PRODUCT.md rename to docs/PRODUCT.md diff --git a/TODO.md b/docs/TODO.md old mode 100644 new mode 100755 similarity index 97% rename from TODO.md rename to docs/TODO.md index abdc56e..1121292 --- a/TODO.md +++ b/docs/TODO.md @@ -17,8 +17,8 @@ behaviour-preserving by construction and tested as such. ## 1. ~~Time-versioned allocation rules~~ — DONE, all six tasks -**Spec:** `docs/superpowers/specs/2026-09-02-versioned-allocation-rules-design.md` -**Plan:** `docs/superpowers/plans/2026-09-02-versioned-allocation-rules.md` +**Spec:** `docs/specs/2026-09-02-versioned-allocation-rules-design.md` +**Plan:** `docs/plans/2026-09-02-versioned-allocation-rules.md` **Ledger + extracted briefs:** `.superpowers/sdd/2026-09-02-versioned-allocation-rules/` | Task | What | Commit | @@ -68,7 +68,7 @@ sleek, modern, and nice to use."* Then, on scoping: both themes with a toggle, a full rethink of every screen, purchases compact and grouped by date, ship a webfont — and *"override everything you want for this step."* -**Spec:** `docs/superpowers/specs/2026-09-02-design-foundation-design.md` +**Spec:** `docs/specs/2026-09-02-design-foundation-design.md` **The diagnosis, which should shape the rest:** a design system already existed and was never wired up. `src/index.css` defined the paper/ink/teal palette with @@ -84,7 +84,7 @@ foundation last is how that happened; do not repeat it. | 4 | Dialogs and fast entry | untouched. Native `