From e31d0d69cce479b005d3cdda89895fe4c7210b7b Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 10 Nov 2026 19:41:15 +0000 Subject: [PATCH 1/8] Thoughts instead of a blog, and a thought on a humans.md - /blog/ becomes /thoughts/: an archive of ideas with a status, starting points, sources, revisions and feedback. The old addresses redirect, and the feed is written to /thoughts/feed.xml and, for old readers, /blog/feed.xml. - New thought: "A humans.md for working with models", with six animated diagrams and the file HUMANS.md to download. - Animated diagrams (figure.anim) in site.js and site.css: drawing on screen, two-state switches, parts to tap, a running token with Pause, narrow drawings for phones. Reduced motion gets the end state. DESIGN.md describes them and the changed motion rule. - Skill adding-a-thought: from a link to a new thought, and how to revise one. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW --- .claude/skills/adding-a-thought/SKILL.md | 68 ++++ .gitignore | 1 + 404.html | 2 +- CLAUDE.md | 4 +- DESIGN.md | 8 +- README.md | 18 +- assets/site.css | 56 +++ assets/site.js | 101 +++++ blog/encrypted-patches/index.html | 434 +------------------- blog/index.html | 68 +--- index.html | 50 ++- projects/kleinbahn/index.html | 2 +- projects/wortzauber/index.html | 2 +- research/cve-2022-46166/index.html | 2 +- sitemap.xml | 5 +- thoughts/encrypted-patches/index.html | 452 +++++++++++++++++++++ thoughts/humans-md/HUMANS.md | 29 ++ thoughts/humans-md/index.html | 496 +++++++++++++++++++++++ thoughts/index.html | 78 ++++ tools/deploy.sh | 4 +- tools/gen-feeds.py | 27 +- tools/review/devserver.py | 5 +- tools/review/test_devserver.py | 17 +- 23 files changed, 1382 insertions(+), 547 deletions(-) create mode 100644 .claude/skills/adding-a-thought/SKILL.md create mode 100644 thoughts/encrypted-patches/index.html create mode 100644 thoughts/humans-md/HUMANS.md create mode 100644 thoughts/humans-md/index.html create mode 100644 thoughts/index.html diff --git a/.claude/skills/adding-a-thought/SKILL.md b/.claude/skills/adding-a-thought/SKILL.md new file mode 100644 index 0000000..9ea04e2 --- /dev/null +++ b/.claude/skills/adding-a-thought/SKILL.md @@ -0,0 +1,68 @@ +--- +name: adding-a-thought +description: Use when Tim gives a link (a web page, a tweet or X post, a paper, a repository, a video) or an idea and wants to think it through as a new thought on t7d.dev, when he wants to revise an existing thought, change its status, or add feedback that people gave on X or LinkedIn. Also for "new thought", "add this to my thoughts", "write a thought about". +--- + +# Adding a thought + +The thoughts in `thoughts//` are Tim's archive of ideas he works through and comes back to. Anyone can read them, but they are mostly for him: each keeps where it started, what it rests on, its status and how it changed. The reference page is `thoughts/humans-md/index.html`. + +## 1. Gather the starting point + +- Read what Tim gave you. For a web page use WebFetch, or the `web-fetch` agent. X often blocks fetches: try the post's URL, then a reader or embed URL (`https://publish.twitter.com/oembed?url=`), and if that fails, ask Tim to paste the text. Never guess what a post says. +- Note the author, the date and one sentence of what it claims. These go into "Starting points". + +## 2. Think it through with Tim before you write + +Ask 2 to 4 questions per round with AskUserQuestion, and wait for the answers. Tim wants to iterate on the idea, not get a finished report. Good questions: + +- What caught his interest: the claim, the method, or a use for his own work? +- His own practice today. The thought must be honest about it ("Mostly I go by feel" is fine, inventing a habit is not). +- Where he disagrees or is unsure. +- The form of the figures: what should move, what should be switchable. + +After a research round, share what you found with one or two more questions before you write. + +## 3. Research + +- Small: a few WebSearch and WebFetch calls yourself. +- Big, or when Tim asks for it: the `deep-research` workflow, with the refined question as args. While it runs, ask Tim the questions from step 2. +- Check every number and quote against a primary source. Mark what you could only see in a search snippet, and leave it out or paraphrase it. Name who coined a term only with a dated source (for example the first commit). + +## 4. Write + +The voice is DESIGN.md "Wording": first person, short sentences, plain words, no slogans. A thought is not a report: + +- Open with the question or the itch, in Tim's words. +- One section per step of the thinking. Headings name their content. +- Figures carry the ideas that are easier to see than to read. Use `figure.anim` (DESIGN.md "Animated diagram"): a drawing that plays once on screen, a two-state switch, parts to tap, a running token. Draw a narrow version (`.dg-n`) for phones. Use only the `.dg` classes, no colours, no `style` attributes. +- End with what Tim takes from it: a rule, a draft, a file, or open questions. + +## 5. The page + +Copy `thoughts/humans-md/index.html` and keep its structure: + +1. ``: title, description, canonical, `og:*`, `article:published_time` (the start date). The feeds and `llms.txt` are made from it at deploy time. +2. `.post-head`: crumb to `/thoughts/`, `h1`, `.sub`, a label with topics, and `.tmeta`: Status, Started, Last revised. +3. `.toc` with every `h2`. +4. The text, then in this order: Open questions (if any), Starting points, Sources (`ol.refs`, `id="s1"`...), Revisions (`ul.dates`), Feedback. + +Status is one of `Draft` (still forming), `Settled` (Tim stands by it) and `Changed my mind`. Set it only as Tim says; a new thought is `Draft`. + +Then: + +- Add it at the top of the list in `thoughts/index.html` (date, status, title, one sentence). +- Add it as the first `.proj` box in the Thoughts section of `index.html`, with an inline SVG cover. Keep two boxes there; the list holds the rest. Update the count in "Contents" in the title block. +- Add the URL to `sitemap.xml`. +- A file to download (like `HUMANS.md`) goes into the thought's folder. + +## 6. Check and ship + +Follow CLAUDE.md: serve the site (`python3 -m http.server 8000`), look at 1440, 390 and 320 px in both themes, no sideways scroll, no console errors. Click every switch and pick, and look at the narrow drawings. Commit on the session's branch and push. `tools/ship.sh ` merges and checks the live site when Tim asks for it. + +## Revising a thought + +- Change the text, set "Last revised", and add one line at the top of Revisions: the date and what changed, and why ("Changed the third rule after feedback on LinkedIn"). +- Change the status only as Tim says. +- Feedback: quote or summarise what people said, with a link to the post, and what it changed. If it changed nothing, say so. +- Keep the old start date in `article:published_time`. diff --git a/.gitignore b/.gitignore index 4b7681e..6624418 100644 --- a/.gitignore +++ b/.gitignore @@ -2,6 +2,7 @@ __pycache__/ # made by tools/gen-feeds.py at deploy time /llms.txt +/thoughts/feed.xml /blog/feed.xml .review/ .env diff --git a/404.html b/404.html index d913cbf..3dd7bd9 100644 --- a/404.html +++ b/404.html @@ -17,7 +17,7 @@ Tim Conrad