Repository navigation
Homepage: consolidate sections and apply design copy edits - #744
Merged
Merged
Conversation
Implements the Homepage.dc.html design from the Claude Design handoff. Structure: - Merge "The README as a CLI." and "Stop hoping the agent reads the instructions." into one compact "Make instructions executable." section with two equal columns. - Delete "The runtime handles the effects." and its Repository/Worktree example; move the component-resolution sentence into "Agents pass values." - Retitle "The nesting is the model." to "The runtime owns the workflow.", replacing the per-line TempDir walkthrough with three runtime-semantic paragraphs. - Lift the star CTA out of the install card into its own section. Copy: - Hero leads with "Turn what you've done before into a program" and drops readability as a product claim. - Hero panel leads with "Markdown describes the workflow." - "Schemas make answers usable." becomes "Schemas make judgment usable.", collapsing the Json/Parse/Elicit walkthrough the example already teaches. Removes README_MD, AGENTS_MD, IMPLEMENTOR_MD and SCOPES_MD, now unused. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_014idQZxeQCcKgtbVwC1pH42
PR #744: Homepage: consolidate sections and apply design copy edits5 files, +240 / -492 Scope🟡 732 lines changed. PRs under 400 receive more thorough review. 🟡 Large PR with no linked issue. Structural✅ No structural bloat detected. Slop✅ Slop indicators look low. Static Analysis✅ Oxlint found no issues. CorrectnessNo extraneous code patterns detected. |
Implements the revised Homepage.dc.html from Claude Design, on top of the
earlier consolidation.
Copy:
- Hero headline is "Minimize agentic work."; the standfirst drops the
prose-vs-program setup and states the thesis directly.
- The hero panel is now just the example. Its release.md is rewritten to a
plain <Prompt> over two <File> reads, replacing the Let/Parse/Json/Publish
schema walkthrough, and runs `npm test` rather than `deno task test`.
- "The point" panel becomes "Use the least autonomy that gets the job done."
- The plan section keeps two paragraphs instead of three.
- The component-resolution sentence moves out of "Agents pass values." into
its own "Build your own components." block.
Structure:
- "Plans are made to be followed." moves ahead of "The runtime composes
intent.", so the plan story lands before the runtime detail.
- Plan panels become titled CLI / XMD source panels with the instruction
wrapping carried in the example, replacing the eyebrow-labelled terminal
slab and its hanging-indent CSS.
Copy-to-clipboard:
- CodeBlock gains an opt-in `copy` affordance. One delegated listener on the
page serves every panel, so 16 panels cost one listener rather than an
island each. Docs and designing-workflows are unaffected.
Also fixes a latent bug: `#plan strong code{font-weight:800}` never applied,
because Term sets font-weight inline and no selector can outrank that. Term
gains a `heavy` variant that puts the weight on the element instead.
External links now carry target="_blank", and the homepage title and
description match the design's.
Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_014idQZxeQCcKgtbVwC1pH42
Applies `deno fmt` to the files touched by the two preceding commits. Formatting only — the rendered markup is byte-identical before and after. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_014idQZxeQCcKgtbVwC1pH42
Both panels now end at a saved artifact rather than at the plan itself: the CLI redirects to release.md, and the XMD form nests <Plan> inside a <File> that names the same path. The two compositions stay equivalent. Instructions, their order and wording, the surrounding copy, and the rest of the page are unchanged. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_014idQZxeQCcKgtbVwC1pH42
The conflict was structural, not semantic: this branch moved the plan section ahead of "The runtime composes intent.", while main (#745) appended to it in its old position, so git saw a delete-vs-modify on the whole section. Resolved by keeping the relocated section and porting main's addition into it — the "A Plan is text, so it composes." paragraph and the `xmd plan | xmd run -` example. The two teach opposite halves of the same point and now sit together: the CLI and XMD panels persist the program to release.md, and main's block covers the case with no file in between. Also retitles the homepage to "xmd — minimize agentic work". Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_014idQZxeQCcKgtbVwC1pH42
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.
Implements the Homepage.dc.html design from the Claude Design handoff.
Structure:
Copy:
Removes README_MD, AGENTS_MD, IMPLEMENTOR_MD and SCOPES_MD, now unused.