docs(readme): fix the broken logo and state where Stella sits next to Oxagen - #6509
Merged
Conversation
… Oxagen The README header pointed at docs/brand/logo/svg/lockup-color-light.svg, which #6473 (the house-system adoption) deleted along with the rest of the comet kit, so GitHub rendered a broken image above the badges. It now uses the vendored stella-wordmark-{dark,light}.svg pair behind prefers-color-scheme sources, with the light file as the fallback. The copy is brought onto the same position the site and the Oxagen repo already state: - The tagline is the site's h1 ("a terminal coding agent that proves its work finished") in place of "Reference Grade Agent Loop". - A short "Stella and Oxagen" section states the split from ADR-043 and ADR-053 on the Oxagen side: Stella runs the agent, Oxagen governs the run; Stella is the coding agent and the CGP/trace reference implementation, Oxagen is the governance plane with no agent loop; the two meet at the opt-in evidence drain and at stella-serve, which Oxagen's in-app assistant runs on. It also names the shared house brand and the stella* mark. - The workspace-layout paragraph that called crates/stella-tui/src/palette.rs the hand-maintained palette mirrored by tokens.css is replaced with what is true since v5.0 and #6473: design/tokens/stella-tokens.json is normative, gen-tokens.py emits the terminal tokens and the CSS, and sync-brand-assets.mjs vendors the marks from the house kit. Verified: check-doc-links, check-invariants, check-command-docs, check-brand-case, check-line-citations, check-rendering-facts and make tokens all pass; every relative link and image path in the README resolves.
Contributor
|
SCR-003 DoD check waived by the |
Contributor
Reviewer's GuideUpdates README branding and product positioning: fixes the broken logo with responsive vendored wordmarks, explains the Stella/Oxagen split and integration points, and documents the current generated token and brand-asset workflow. File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
macanderson
marked this pull request as ready for review
September 12, 2026 10:05
Contributor
There was a problem hiding this comment.
Sorry @macanderson, you've used your own review budget of 250,000 diff characters for the last 7 days.
You can request another review in 1 day and 12 hours by commenting @sourcery-ai review. Upgrade to get a review now.
…protocol check-prose rejected two words the new section added: 'deliberate' (filler-adverb -- state the reason or say nothing) and 'headless' (interface-jargon). The split sentence now states the consequence, that neither product duplicates the other, and stella-serve is described as driving the engine over a wire protocol, which is what the crate's own README row already says.
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.
docs(readme): fix the broken logo and state where Stella sits next to Oxagen
The README header pointed at docs/brand/logo/svg/lockup-color-light.svg,
which #6473 (the house-system adoption) deleted along with the rest of the
comet kit, so GitHub rendered a broken image above the badges. It now uses
the vendored stella-wordmark-{dark,light}.svg pair behind prefers-color-scheme
sources, with the light file as the fallback.
The copy is brought onto the same position the site and the Oxagen repo
already state:
work finished") in place of "Reference Grade Agent Loop".
ADR-053 on the Oxagen side: Stella runs the agent, Oxagen governs the run;
Stella is the coding agent and the CGP/trace reference implementation,
Oxagen is the governance plane with no agent loop; the two meet at the
opt-in evidence drain and at stella-serve, which Oxagen's in-app assistant
runs on. It also names the shared house brand and the stella* mark.
the hand-maintained palette mirrored by tokens.css is replaced with what is
true since v5.0 and brand: adopt the Oxagen house system — palette, marks, and the face #6473: design/tokens/stella-tokens.json is normative,
gen-tokens.py emits the terminal tokens and the CSS, and
sync-brand-assets.mjs vendors the marks from the house kit.
Verified: check-doc-links, check-invariants, check-command-docs,
check-brand-case, check-line-citations, check-rendering-facts and
make tokens all pass; every relative link and image path in the README
resolves.
Summary by Sourcery
Update the README to restore the logo, accurately position Stella alongside Oxagen, and document the current branding workflow.
Bug Fixes:
Enhancements:
Documentation: