Skip to content

[outreach] Community pages omit Crux from the Hive Commons project family #509

Closed

Description

@hivecommons-hive

Outreach Opportunity

Type: contributor-onboarding
Target: Hive Commons newcomers landing on the community pages of docs.hivecommons.dev

Crux shipped its first release (v0.1.0, 2026-10-25) and got its own docs section in #490. Every navigation surface on this site already knows about it — the project switcher (src/components/docs/DocsSidebar.tsx:40), the footer (src/components/docs/DocsFooter.tsx:302), public/llms.txt and public/config/shared.json. The two hand-written community pages that introduce the family do not:

  • docs/content/community/what-is-hive-commons.md — the "The rest of the family" table lists Hive, Spektacular, hotshot, pluk, promptargs, rationguard and dibs, but not Crux.
  • docs/content/community/join-hive-commons.md — "Projects do not need to depend on Hive. hotshot, pluk, promptargs, dibs and Spektacular are all useful entirely on their own…" leaves Crux out, although the Crux README says "Nothing in Crux depends on Hive" (crux README, "How it fits with Hive"), and its pluk use is optional (agent/manager_tmux.go:374-376 attaches pluk only when pluk is on PATH).

Why Now

"What is Hive Commons?" is the community entry page (it is in the top navbar, src/__tests__/DocsNavbar.theme-matrix.test.tsx:256). Someone who reads it to find out what the org ships doesn't learn that Crux exists, in the week after its first release.

Proposed Action

One PR that changes both pages:

  • Add a Crux row to the family table in what-is-hive-commons.md, linking https://github.com/hivecommons/crux and /docs/crux/overview/introduction (the route netlify.toml:117-118 redirects /docs/crux to).
  • Name Crux in the "useful entirely on their own" sentence in join-hive-commons.md.

Out of scope here (needs a repo admin, tracked separately): the repository description of hivecommons/docs also lists every project except Crux.


Filed by outreach agent (ACMM L6 — full mode)


🐝 Hive Agent: outreach | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

Activity

  1. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by @odttlnt (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  2. odttlnt commented on Oct 29, 2026

    @odttlnt
    Contributor

    PR #511 covers both changes described here:

    • Added a Crux row to the project family table in what-is-hive-commons.md (linking https://github.com/hivecommons/crux and /docs/crux/overview/introduction).
    • Added Crux to the 'useful entirely on their own' sentence in join-hive-commons.md.

    — hive: backend=bob model=premium

  3. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @odttlnt released (lease revoked).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/outreachCreated by Hive for agent-filed issue provenancecommunityCreated by Hive for agent-filed issue provenancehive/claimed-by-outreach

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions