Skip to content

docs(readme): fix the broken logo and state where Stella sits next to Oxagen - #6509

Merged
macanderson merged 2 commits into
mainfrom
worktree-readme-house-brand
Sep 12, 2026
Merged

docs(readme): fix the broken logo and state where Stella sits next to Oxagen#6509
macanderson merged 2 commits into
mainfrom
worktree-readme-house-brand

Conversation

@macanderson

@macanderson macanderson commented Sep 12, 2026

Copy link
Copy Markdown
Owner

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:

  • 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 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:

  • Fix the README logo rendering by using the vendored dark and light Stella wordmarks with a light-theme fallback.

Enhancements:

  • Clarify Stella’s relationship with Oxagen, including their distinct responsibilities, integration points, and shared branding.
  • Update the workspace documentation to describe the normative token source and generated brand assets accurately.

Documentation:

  • Refresh the README tagline, privacy wording, product positioning, and workspace layout guidance.

… 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.
@github-actions

github-actions Bot commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

SCR-003 DoD check waived by the closes-nothing label — this PR closes no issue by design.

@sourcery-ai

sourcery-ai Bot commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

Reviewer's Guide

Updates 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

Change Details Files
Replace the broken README logo reference with responsive, vendored Stella wordmarks.
  • Use dark and light SVG sources selected by prefers-color-scheme.
  • Provide the light wordmark as the fallback image and update its accessible label.
README.md
Align README positioning and product messaging with the Stella/Oxagen architecture.
  • Update the tagline and privacy wording to match the site.
  • Add the Stella and Oxagen responsibilities, integration seams, branding relationship, and referenced documentation links.
README.md
Correct the README description of the token and brand-asset workflow.
  • Document the normative JSON token source and generated terminal/CSS outputs.
  • Document house-kit asset synchronization and the associated validation commands.
README.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@macanderson
macanderson marked this pull request as ready for review September 12, 2026 10:05

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.
@macanderson macanderson added the closes-nothing Substantial change that closes no issue by design (SCR-003) label Sep 12, 2026
@macanderson
macanderson merged commit 127b7eb into main Sep 12, 2026
23 of 25 checks passed
@macanderson
macanderson deleted the worktree-readme-house-brand branch September 12, 2026 10:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

closes-nothing Substantial change that closes no issue by design (SCR-003)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant