Feat: pivot the landing page to the project directory by mrsabath · Pull Request #135 · rossoctl/.github

mrsabath · 2026-10-30T19:33:46Z

Summary

Replaces the "Platform primitives / RossoCortex data plane" landing narrative with a project directory that matches the org's current focus. The homepage now leads with a short org-level intro plus three groups of project cards:

Core projects — Moca, Cortex, Eventing, AutoBench, State management (state-lab)
Context & governance — Context Guru, AIAC, Data governance, Context Service
Automation & repo maintenance — Automation, RepoMan

Each card carries a high-level essence of the project — grounded in the current READMEs, epics, and recent PRs of each repo — and links to its repository, where all details, instructions, and examples live. The Cortex card covers today's story (the observability/cost proxy, agentop, tool-definition pruning) including Cortex Local on end-user machines and Cortex Remote, deployed along the harness, as the explored direction. Repo families link the main repo and list public siblings (private siblings are skipped).

Details:

New ProjectCards component (src/components/ProjectCards/) — responsive card grid following the site's design tokens (brand-red title link, 1px emphasis border, muted footer links)
The previous landing page is archived verbatim as a draft backup in ecosystem/welcome-platform-story.mdx (same pattern as welcome-copy.md), not linked in the sidebar
Site tagline updated to reflect the project-focused direction (SEO/social cards)
The hero "Get started" button anchors to the project directory on the page instead of /docs/, which still presents the earlier platform work; every project card also carries an explicit "Get started ↗" footer link to its own repository
The GitHub CTA renders at the same height as "Get started" (single-line Link, avoiding an MDX paragraph-inside-JSX pitfall)
The ecosystem plugin's editUrl points at this repo, so the landing page's "Edit this page" link resolves (it previously 404'd via the archived ecosystem-guide)
Deprecated/archived repos are not listed anywhere on the page

Verification

npm run build passes with no new broken-link warnings
npm run typecheck passes
Rendered homepage verified from the build output: all three groups, all 11 project cards, and every repo/sibling/project-site link resolves correctly
Hero CTA anchor target (id="core-projects") and all 11 "Get started ↗" card links verified in the built HTML

Assisted-By: Claude Code

Replace the 'Platform primitives / RossoCortex data plane' narrative with a project-focused landing page: an org-level intro plus three groups of project cards (core projects, research collaborations, automation & repo maintenance). Each card carries only the essence of the project and links to its repository, where the details, instructions, and examples live. The earlier platform direction stays on the page as a 'Past activities' section: the data-plane functions and services cards return as a historical record (shipped through v0.8), each pointing at the repository where that work lives today (RossoCortex is renamed to cortex throughout). The old landing page is additionally archived as a draft backup (welcome-platform-story.mdx), and the site tagline is updated to match the new focus. Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com> Signed-off-by: Mariusz Sabath <mrsabath@gmail.com>

netlify · 2026-10-30T19:33:52Z

✅ Deploy Preview for animated-crumble-fb8862 ready!

Name	Link
🔨 Latest commit	`1ccf1a4`
🔍 Latest deploy log	https://app.netlify.com/projects/animated-crumble-fb8862/deploys/6ae8ca5766b11d183f750188
😎 Deploy Preview	https://deploy-preview-135--animated-crumble-fb8862.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

evaline-ju

Few minor comments

evaline-ju · 2026-10-30T20:49:25Z

+platform owners can build on. It comes in three parts: RossoCortex, a data plane that mediates
+what agents do, a set of services agents can call and a set of tools and frameworks for observability,
+security, governance and administration. It's open source, framework-neutral,


I'm confused what the "three parts" refer to with the various commas, especially assuming "data plane.." is meant to describe RossoCortex rather than a separate "part"

Good catch — that sentence now only lives in the archived draft: true backup of the old page, which stays verbatim. The live copy in rossoctl/rossoctl#2662 reads "RossoCortex (a data plane); a set of callable services; and tooling …" with the paragraph split (1031f192).

The GitHub button next to Get started rendered taller than its neighbour: MDX parsed the multi-line JSX children as a markdown paragraph inside the link, adding paragraph spacing inside the button. Write the Link on a single line so both CTAs render identically. The ecosystem plugin's editUrl now points at this repo instead of the archived rossoctl/ecosystem-guide, so the landing page's "Edit this page" link resolves (it previously 404'd on a doubled path). Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com> Signed-off-by: Mariusz Sabath <mrsabath@gmail.com>

The historical data-plane/services cards and the archived-repositories table are gone from the page. The pre-pivot narrative remains available in the repo as the draft backup (welcome-platform-story.mdx). Reverts the Accordion now/discontinued extensions, which existed only to render those cards; the component is back to its pre-PR shape. Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com> Signed-off-by: Mariusz Sabath <mrsabath@gmail.com>

The hero's Get started button now anchors to the Core projects section on the landing page instead of /docs/, which still presents the earlier platform work. Each project card always shows an explicit Get started link to its own repository in the footer, so the per-project entry point is unmistakable even before reading the card. Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com> Signed-off-by: Mariusz Sabath <mrsabath@gmail.com>

aslom

Review: pivot the landing page to the project directory

Approving. The pivot is cleanly executed and every verification claim in the
description checks out against the deploy preview. Notes below are follow-ups, not
blockers.

Verified independently against the Netlify preview and the head commit
(5869daa):

id="core-projects" is present and the hero "Get started" anchor resolves to it
all 11 project cards render, across the three expected groups
(core-projects, context--governance, automation--repo-maintenance)
every card repo link and sibling/project-site link returns 200, and all 13 linked
repos are public and un-archived (autobench-claudecode, context-guru project
site, cortex install stats included)
the editUrl fix works: "Edit this page" on the landing page now resolves to
rossoctl/.github/tree/main/ecosystem/welcome.mdx (200), not the archived
ecosystem-guide
draft: true does keep the archived narrative out of the build —
/welcome-platform-story and /welcome-copy both 404 on the preview, matching the
welcome-copy.md precedent exactly (same frontmatter shape, same comment banner)
no deprecated or archived repo is listed anywhere on the page
DCO green, Netlify deploy preview green, no CI/agent/dependency config touched and
no secrets in the diff

Two things worth a follow-up: the moca card's "(Go)" annotation elsewhere in this
series looks inverted relative to the repo's actual stack, and ProjectCards uses raw
<a> where the sibling GitHubStars component uses Docusaurus <Link>. Details
inline.

Nice touch documenting why the editUrl base has no ecosystem/ segment — that
doubling is exactly the kind of thing that gets "fixed" back into a bug later.

aslom · 2026-11-02T15:29:25Z

+      {items.map((item) => (
+        <div className={styles.card} key={item.repo}>
+          <h3 className={styles.name}>
+            <a


[low] Sibling components in this repo use the Docusaurus <Link> for external
hrefs — GitHubStars/index.tsx imports @docusaurus/Link and renders a <Link>
with a https://github.com/... href. ProjectCards uses raw <a> in both places
(title here, footer links below).

Functionally fine — rel="noopener noreferrer" is set correctly on every anchor, so
there's no security gap, and <Link> passes external URLs straight through anyway.
It's purely a consistency note for whoever edits this next.

Also worth noting the repo URL is built twice per card (here and on the footer "Get
started" anchor); hoisting it would remove the duplication:

const repoUrl = `https://github.com/${item.repo}`;

Addressed in 1ccf1a4 — the card title and footer anchors now render through @docusaurus/Link, matching GitHubStars, and the repository URL is built once per card (const repoUrl) instead of twice.

aslom · 2026-11-02T15:29:25Z

 <div className="margin-top--md margin-bottom--lg">
-  {/* Primary CTAs point at the project repos (docs hidden pre-launch). */}
-  <Link className="button button--lg cta-primary margin-right--sm" href="/docs/">Get started</Link>
+  <Link className="button button--lg cta-primary margin-right--sm" href="#core-projects">Get started</Link>


[low] The hero "Get started" now points at #core-projects, an on-page anchor,
while the adjacent GitHub button is a real external link. Both verified working on the
preview.

One consequence worth being deliberate about: /docs/ still exists and returns 200,
but nothing in the hero routes there anymore. That matches the PR's stated intent
(docs still present the earlier platform work), so no change requested — just
flagging that the docs are now reachable only via the navbar, which is easy to forget
when the docs section is eventually refreshed.

Ack, and thanks for flagging the consequence. The remaining funnels into /docs/ (announcement bar, navbar Documentation + version dropdown) are being tracked as a follow-up until the docs themselves catch up with the current focus.

aslom · 2026-11-02T15:29:25Z

+<div className="rosso-intro">
+
+rossoctl is a set of platform primitives for agent security, resilience, reliability and efficiency that
+platform owners can build on. It comes in three parts: RossoCortex, a data plane that mediates


[low] This is the sentence @evaline-ju asked about on the first pass ("confused
what the 'three parts' refer to with the various commas"). The comma-spliced list —
RossoCortex, a data plane that mediates what agents do, a set of services agents can call and a set of tools... — reads as four items rather than three because the
appositive isn't set off.

It's archived, draft: true, build-excluded prose, so it genuinely does not matter
here. Raising it only because the same sentence is being added as live prose in
rossoctl/rossoctl#2662 (INSTALLER.md:3), where it is reader-facing. Fixing it
there is the useful move; semicolons already do the job in the 2662 variant, which is
most of the way there.

Left verbatim on purpose — welcome-platform-story.mdx is the archived draft: true backup of the pre-pivot page, so it stays byte-identical to what was live. The reader-facing variant of this sentence is fixed in rossoctl/rossoctl#2662 (1031f192): the appositive is parenthesized and the intro paragraph is split.

Match the sibling GitHubStars component and render the card anchors through @docusaurus/Link instead of raw <a>, and build the repository URL once per card instead of twice (title and footer Get started anchor), per review feedback. Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com> Signed-off-by: Mariusz Sabath <mrsabath@gmail.com>

rubambiza added this to Rossoctl Issue Prioritization Oct 30, 2026

github-project-automation Bot moved this to New/ToDo in Rossoctl Issue Prioritization Oct 30, 2026

evaline-ju reviewed Oct 30, 2026

View reviewed changes

mrsabath added 2 commits October 30, 2026 18:07

mrsabath mentioned this pull request Oct 31, 2026

Docs: align the org profile repository list with the current focus #136

Merged

aslom approved these changes Nov 2, 2026

View reviewed changes

mrsabath merged commit b61218c into main Nov 2, 2026
5 checks passed

github-project-automation Bot moved this from New/ToDo to Done in Rossoctl Issue Prioritization Nov 2, 2026

Navigation Menu

Repository navigation

Feat: pivot the landing page to the project directory - #135

Feat: pivot the landing page to the project directory#135
mrsabath merged 5 commits into
mainfrom
redesign/project-focus

mrsabath commented Oct 30, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Oct 30, 2026 •

edited

Loading

Uh oh!

evaline-ju left a comment

Uh oh!

evaline-ju Oct 30, 2026

Uh oh!

mrsabath Nov 2, 2026

Uh oh!

Uh oh!

aslom left a comment

Uh oh!

aslom Nov 2, 2026

Uh oh!

mrsabath Nov 2, 2026

Uh oh!

aslom Nov 2, 2026

Uh oh!

mrsabath Nov 2, 2026

Uh oh!

aslom Nov 2, 2026

Uh oh!

mrsabath Nov 2, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

mrsabath commented Oct 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Verification

Uh oh!

netlify Bot commented Oct 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for animated-crumble-fb8862 ready!

Uh oh!

evaline-ju left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

aslom left a comment

Choose a reason for hiding this comment

Review: pivot the landing page to the project directory

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mrsabath commented Oct 30, 2026 •

edited

Loading

netlify Bot commented Oct 30, 2026 •

edited

Loading