From 8a6110396a2d9d16a99ce629dcbcb9ccd5569053 Mon Sep 17 00:00:00 2001 From: Lucas Winther Date: Thu, 1 Oct 2026 04:09:57 +0200 Subject: [PATCH] docs: move PRODUCT and DESIGN into docs/ and list them in AGENTS They are reasoning for whoever touches the interface next, which is what docs/ holds, and the table in AGENTS.md is how an agent finds it. The design tooling resolves both from docs/ without configuration. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 2 ++ DESIGN.md => docs/DESIGN.md | 0 PRODUCT.md => docs/PRODUCT.md | 0 3 files changed, 2 insertions(+) rename DESIGN.md => docs/DESIGN.md (100%) rename PRODUCT.md => docs/PRODUCT.md (100%) diff --git a/AGENTS.md b/AGENTS.md index 29e12a5..a5bb455 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,6 +21,8 @@ between repairing a rule and rediscovering it the expensive way. | `docs/ARCHITECTURE.md` | Process shape, file layout, request paths, offline and update mechanics | Moving files, adding a route, or changing the service worker | | `docs/FEEDBACK.md` | What readers actually said about the first release, and the work it argues for | Deciding what to build next | | `docs/SOURCES.md` | Which sites publish a usable schedule for the games we still do not cover, and what is wrong with the ones that do not | Picking the next game to add, or assessing a source request | +| `docs/PRODUCT.md` | Who the product is for, its positioning, voice, brand commitments and the evidence on hand — the condensed product record design tooling reads | Design or copy work, or anything that claims something about users or the product | +| `docs/DESIGN.md` | The shipped visual system: both themes' tokens, the two colour axes, type roles, layout, depth, and the signature components. `.impeccable/design.json` is its generated sidecar | Changing anything a reader sees — colour, type, spacing, a component's look or motion | Two rules that follow from that: diff --git a/DESIGN.md b/docs/DESIGN.md similarity index 100% rename from DESIGN.md rename to docs/DESIGN.md diff --git a/PRODUCT.md b/docs/PRODUCT.md similarity index 100% rename from PRODUCT.md rename to docs/PRODUCT.md