Skip to content

Refocus org profile README for builder/diligence audience - #2

Draft
JulioMCruz wants to merge 1 commit into
mainfrom
cursor/readme-second-pass-cfa6
Draft

Refocus org profile README for builder/diligence audience#2
JulioMCruz wants to merge 1 commit into
mainfrom
cursor/readme-second-pass-cfa6

Conversation

@JulioMCruz

Copy link
Copy Markdown
Contributor

Summary

Second pass on the GitHub org profile README, refocusing for builder/diligence visitors rather than SMB café owners.

Changes

Hero image (profile/readme-hero.png)

  • Clean dark landscape (1280×420) with official P logo only
  • Removed wordmark text
  • Removed non-clickable chip CTAs (they competed with markdown links)

README structure (profile/README.md)

  • Preserved locked line: "PerkOS runs AI teams for small businesses."
  • Added infrastructure sentence: "This org is the infrastructure under that product."
  • Rails labeled: Identity · Payments · Coordination · Validation
  • Six start-here repos in the specified order:
    1. PerkOS
    2. Stack
    3. Perkos-Containers
    4. PerkOS-Agent-SDK
    5. PerkOS-Knowledge
    6. PerkOS-Platform-Tools-API
  • Moved MiniPay, EQLTY, pkg-* repos to "More repos" section below the fold
  • Removed "How it works" SMB product-demo section from first screen
  • Product door still points to perkos.xyz

Preview

The first fold now presents:

  1. Clean hero with P mark
  2. Markdown CTAs (Start here + Product)
  3. Locked tagline + infra sentence
  4. Rails
  5. Six core repos table

Everything else (product surfaces, onchain details, MiniPay, EQLTY, pkg-* repos) is below the fold.

Review checklist

  • Hero has official P only, no wordmark, no chips
  • Locked sentence unchanged
  • First fold is infra + rails + six repos
  • No "agentic economy" or "PerkOS AI" terminology
  • No invented metrics or partners
Open in Web Open in Cursor 

- Hero: clean dark landscape with official P logo only, no wordmark or chips
- First fold: infra sentence + rails + six start-here repos in specified order
- Rails: Identity, Payments, Coordination, Validation
- Start-here repos: PerkOS, Stack, Perkos-Containers, PerkOS-Agent-SDK, PerkOS-Knowledge, PerkOS-Platform-Tools-API
- Moved MiniPay, EQLTY, pkg-* to 'More repos' section below the fold
- Removed 'How it works' SMB product-demo section
- Preserved locked line: PerkOS runs AI teams for small businesses.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants