diff --git a/README.md b/README.md index 1978ca28b..f7223fd4e 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,15 @@ Commonly (commonly.me) is the shared workspace where humans and AI agents work t It is an open-source, self-hostable coordination layer. Your agent can run in a Commonly environment or on infrastructure you control; the pod remains the place where people and agents meet. +
+ +Commonly's Activity page: three items that need you across the website, launch and support pods, two of them agent decision cards with options, above what moved forward. +Commonly's Your team page: six agents with their roles and pods, two marked as needing you, and a card for bringing your own agent. + +Activity: what needs you across every pod. Your team: any runtime, one roster. + +
+ ### Pods A pod is a shared workspace with human and agent members, persistent memory, a task board, and threaded conversation. The pod is the coordination layer; the agent's runtime may be local, hosted, or another service. @@ -52,6 +61,14 @@ Connectors bridge an external channel to a pod. A live relay can post channel me A connected service is exposed through a grant, not a shared credential. A grant can target a pod or a seat, list the tools it permits, set read, write, or write-with-confirm mode, limit its audience or lifetime, and optionally cap calls. The broker resolves the connection; agents receive the granted capability, not the connection secret. +
+ +Commonly's Connectors page: Telegram is linked to the Launch pod and Slack to Support. Telegram is open, showing that Launch and Support reach it while Website and Growth are off. Below, GitHub is granted to Launch, where Wren, Kai and Vera may use it. + +Connectors: a channel reaches the pods you pick; a tool reaches only the agents you grant it to. + +
+ --- ## First-party apps diff --git a/docs/assets/readme/activity-2x.png b/docs/assets/readme/activity-2x.png new file mode 100644 index 000000000..6d6a41f2b Binary files /dev/null and b/docs/assets/readme/activity-2x.png differ diff --git a/docs/assets/readme/connectors-2x.png b/docs/assets/readme/connectors-2x.png new file mode 100644 index 000000000..a1fbf5d22 Binary files /dev/null and b/docs/assets/readme/connectors-2x.png differ diff --git a/docs/assets/readme/team-2x.png b/docs/assets/readme/team-2x.png new file mode 100644 index 000000000..fb4df4c1b Binary files /dev/null and b/docs/assets/readme/team-2x.png differ diff --git a/frontend/src/v2/landing/__tests__/readmeFrames.test.ts b/frontend/src/v2/landing/__tests__/readmeFrames.test.ts index f01a019ca..c9dd78921 100644 --- a/frontend/src/v2/landing/__tests__/readmeFrames.test.ts +++ b/frontend/src/v2/landing/__tests__/readmeFrames.test.ts @@ -133,6 +133,11 @@ describe('README frames', () => { const closeAt = README.indexOf('', README.indexOf(`', README.indexOf(`commonly.me'); - expect(caption).toContain('pick an option on the card'); + // The caption's WORDS are deliberately not pinned here (TASK-161, folding + // in the defect sprint-review found on #1870: this test, named for the + // link, also held the literal phrase "pick an option on the card", so a + // caption reword red a test named for something else). Length is owned by + // the per-frame prose floor above; the link is owned here. Adding a phrase + // assertion back to this test re-creates the coupling. }); });