Repository navigation
Thoughts instead of a blog, the humans.md thought, and leaner agent instructions - #28
Merged
Merged
Conversation
- /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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
tools/preview-artifact.py turns a page into an artifact bundle (relative assets, no own skeleton or CSP). CLAUDE.md and the skill adding-a-thought say to use it for Tim's review. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
METR's 2025 numbers are out of date; adds later studies, the gap between felt and measured, and a section with an animated figure on measuring from what Claude Code transcripts and git already record. Rule 7 of HUMANS.md changes to match. Notes which sources were read only through summaries. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
- The review-notes flow moves from CLAUDE.md into the skill handling-review-notes; a SessionStart hook prints the number of open notes. - CLAUDE.md points to adding-a-thought instead of repeating it, drops the 'Read first' section (DESIGN.md and README.md are in the project map with when to read them), scopes ship.sh to Tim's ask, and says which review channel is for what. - tools/check.py checks CSP rules and the sitemap; CI runs it on pull requests and before each deploy. - Rename leftovers in DESIGN.md, README's design section points to DESIGN.md, missing skills listed, the reels skill checks 320 px and both themes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
From the research run on current Claude Code guidance: the check command comes first, the file layout the agent can read from the repo goes (the gotchas stay as rules), the reels and timeline blocks go because their skills start from their own descriptions, and the new-page rules move to .claude/rules/pages.md with a paths filter. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
New section with an animated figure (76 to 61 to 33 lines), two sources, a new step and log entry in HUMANS.md, and an updated open question. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFxuEuiQ8gLmh8xHfJyLFW
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
/blog/becomes/thoughts/: each thought has a status, starting points, sources, revisions and feedback. The old addresses redirect, and the feed is written to/thoughts/feed.xmland/blog/feed.xml.HUMANS.mdcan be downloaded.figure.anim) insite.jsandsite.css; DESIGN.md describes them and the changed motion rule.adding-a-thoughtandhandling-review-notes; a SessionStart hook counts open review notes.tools/check.pychecks CSP rules and the sitemap; CI runs it on pull requests and before each deploy.tools/preview-artifact.pybuilds a page as a Claude artifact for review..claude/rules/pages.md, no file layout.Checked:
python3 tools/check.py(11 pages, 0 problems),python3 -m unittest tools/review/test_devserver.py, every page at 1440, 390 and 320 px in both themes with no sideways scroll and no console errors.Generated by Claude Code