Skip to content

feat(signup): render agent signup guides from the vendored setup skills - #159

Merged
khaliqgant merged 10 commits into
mainfrom
fix/teams-signup-sessions-handoff
Oct 8, 2026
Merged

khaliqgant merged 10 commits into
mainfrom
fix/teams-signup-sessions-handoff

Conversation

@khaliqgant

@khaliqgant khaliqgant commented Oct 8, 2026 •

Copy link
Copy Markdown
Member

Summary

  • /signup/agent/teams and /signup/agent/flows keep only the signup header (policy, User-Agent, progress, web input). After it, they include the AgentWorkforce/skills setup skills verbatim, installed with prpm: prpm.lock pins the @agent-relay packages, prpm install writes them to .claude/skills/<name>/SKILL.md (as in the relay repo), and web/scripts/generate-setup-skills.mjs generates web/lib/generated/setup-skills.ts from them. The generator also runs in prebuild and precf:build.
  • CI: prpm install --frozen-lockfile must not change prpm.lock or .claude/skills, and npm run verify:setup-skills must pass.
  • Flows parts: Cloud account, Flows, and writing-relayflows (v2) for the custom path. Progress steps map to the Flows skill's sections 3-5. The web-input example asks "prebuilt or custom" (no code-review).
  • Local stack (http://localhost or 127.0.0.1 only): Part 2's desktop commands are rewritten for the prebuilt Dev app.
  • The flow is named Software Garden in /flows examples, the onboarding handoff, the builder copy, START-HERE and the cookbook. The id stays software-factory.

Blocked: draft until the skills are published

signing-in-to-agent-relay-cloud and setting-up-agent-relay-flows are not on the prpm registry yet, and desktop 1.1.5 / sessions 0.2.5 (from AgentWorkforce/skills#145) are unpublished. So CI fails at "Verify setup skills are current". After #145 merges and a human publishes:

prpm install @agent-relay/signing-in-to-agent-relay-cloud --as claude -y
prpm install @agent-relay/setting-up-agent-relay-flows --as claude -y
prpm update
npm run skills:generate

I checked this locally by simulating the five installed files from the #145 branch: the generator, --check, and every signup test pass.

Open

  • TODO in web/lib/flow-workflows.ts: match WORKFLOWS run steps to cloud's run-step preview (flow-preview-overview.ts) once cloud reports the names.

🤖 Generated with Claude Code


Note

Medium Risk
Changes the authoritative agent onboarding path and Teams completion criteria; CI is blocked until unpublished prpm packages are available, but runtime risk is mainly guide drift rather than core API behavior.

Overview
Agent-driven Teams and Flows signup no longer ship a single monolithic guide in agent-signup.ts. They keep a signup-specific header (policy, progress API, web-input for Flows) and append the canonical @agent-relay setup skills verbatim, versioned via prpm.lock and installed under .claude/skills/.

A new generate-setup-skills.mjs pipeline strips skill frontmatter and emits web/lib/generated/setup-skills.ts so Cloudflare Workers can serve the same text without a filesystem; prebuild / precf:build and CI (prpm install --frozen-lockfile, verify:setup-skills) enforce that committed skills, lockfile, and generated module stay aligned.

Teams onboarding now walks cloud sign-in → desktop setup → session handoff (progress steps and copy updated; completion requires a live round trip, not just app install). Flows uses sign-in → flows deploy API guide → writing-relayflows for custom flows. Local localhost stacks rewrite desktop download/socket paths to the Agent Relay Dev app.

Product copy renames the recommended flow to Software Garden (catalog id remains software-factory) across onboarding, examples, and docs.

Reviewed by Cursor Bugbot for commit 298b908. Bugbot is set up for automated code reviews on this repo. Configure here.


Agent Relay sessions

  • claude session a295461e · opened via gh pr create · last active 2026-10-08

…skills

- /signup/agent/teams and /signup/agent/flows keep only the signup header
  (policy, progress, web input) and include the AgentWorkforce/skills setup
  skills verbatim from a pinned commit (web/scripts/sync-setup-skills.mjs,
  --check fails on drift).
- Flows parts: Cloud account, Flows, and writing-relayflows (v2) for the
  custom-flow path; the web-input example asks prebuilt or custom instead of
  listing code-review, which is not in the catalog.
- Name the flow Software Garden in the /flows examples, the onboarding
  handoff, the builder copy, the local START-HERE and the cookbook. The id
  stays software-factory.
- TODO in flow-workflows.ts: align WORKFLOWS step lists with the cloud
  deploy wizard once it reports its final step names.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 49 seconds.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 62b6f637-704d-48ed-9fbb-d77c2f7ef84c
📥 Commits

Reviewing files that changed from the base of the PR and between 7806187 and 298b908.

⛔ Files ignored due to path filters (2)
  • prpm.lock is excluded by !**/*.lock
  • web/lib/generated/setup-skills.ts is excluded by !**/generated/**
📒 Files selected for processing (11)
  • .claude/skills/setting-up-agent-relay-desktop/SKILL.md
  • .claude/skills/setting-up-agent-relay-flows/SKILL.md
  • .claude/skills/setting-up-agent-relay-sessions/SKILL.md
  • .claude/skills/signing-in-to-agent-relay-cloud/SKILL.md
  • .claude/skills/writing-relayflows/SKILL.md
  • .github/workflows/test.yml
  • package.json
  • web/lib/agent-signup.ts
  • web/lib/test/agent-signup.test.ts
  • web/package.json
  • web/scripts/generate-setup-skills.mjs

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 09777c5b-f8bc-4c73-8f4b-c6114efcfb22
📥 Commits

Reviewing files that changed from the base of the PR and between 0c6c11c and 7806187.

⛔ Files ignored due to path filters (1)
  • web/lib/generated/setup-skills.ts is excluded by !**/generated/**
📒 Files selected for processing (17)
  • web/app/flows/flow-examples.ts
  • web/app/flows/onboarding/FactoryBuilder.tsx
  • web/content/docs/relayflows/cookbook.mdx
  • web/content/setup-skills/SOURCE.json
  • web/content/setup-skills/setting-up-agent-relay-desktop.md
  • web/content/setup-skills/setting-up-agent-relay-flows.md
  • web/content/setup-skills/setting-up-agent-relay-sessions.md
  • web/content/setup-skills/signing-in-to-agent-relay-cloud.md
  • web/content/setup-skills/writing-relayflows.md
  • web/lib/agent-signup-progress.ts
  • web/lib/agent-signup.ts
  • web/lib/flow-local.ts
  • web/lib/flow-onboarding.ts
  • web/lib/flow-workflows.ts
  • web/lib/test/agent-signup-progress.test.ts
  • web/lib/test/agent-signup.test.ts
  • web/scripts/sync-setup-skills.mjs

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

This pull request adds vendored Agent Relay setup skills and uses them to generate signup guidance. It documents Desktop, Sessions, and Flows setup, updates signup progress checks, and renames Software Factory references to Software Garden.

Changes

Agent Relay setup guides and signup

Layer / File(s) Summary
Vendored skills and signup assembly
web/content/setup-skills/SOURCE.json, web/scripts/sync-setup-skills.mjs, web/lib/agent-signup.ts, web/lib/agent-signup-progress.ts, web/lib/test/*
Adds a pinned skill source and a script to sync the skill files and generated module. Signup guidance assembles ordered, product-specific skills with environment substitutions. Progress guidance and tests now cover the updated Teams and Flows steps.
Desktop installation and configuration
web/content/setup-skills/setting-up-agent-relay-desktop.md
Adds platform-specific installation, sign-in, sharing and registration setup, delivery checks, subscription instructions, and recovery procedures.
Session handoff setup
web/content/setup-skills/setting-up-agent-relay-sessions.md
Adds prerequisites and token handling, MCP setup, handoff verification, completion reporting, and recovery instructions.
Relayflows v2 authoring guide
web/content/setup-skills/writing-relayflows.md
Documents v2 authoring contracts, verification gates, execution behavior, child-flow dispatch, CLI commands, and Cloud mirroring.
Flow deployment and Software Garden naming
web/content/setup-skills/setting-up-agent-relay-flows.md, web/app/flows/*, web/content/docs/relayflows/cookbook.mdx, web/lib/flow-local.ts, web/lib/flow-onboarding.ts, web/lib/flow-workflows.ts
Adds API-based flow setup and deployment instructions. Updates flow labels and copy from Software Factory to Software Garden and adds a TODO about aligning workflow steps with the deployment wizard.

Priority: ➖ Normal

Estimated code review effort: 4 (Complex) | ~60 minutes

Change: Feature

Merge Risk: ⚪ Minimal · up to 78061

No demonstrated issue blocks merging; the vendored pin and signup behavior remain subject to normal validation.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 21.43% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 14 functions across 10 files. (7 skipped:… Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly summarizes the primary change: generating agent signup guides from vendored setup skills.
Description check ✅ Passed The description is directly related to the changeset and explains the vendored skills, signup guide updates, local-stack behavior, flow rename, validation, and known blockers.
Full details: Docstring Coverage

Explanation

Docstring coverage is 21.43% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 14 functions across 10 files. (7 skipped: 7 unsupported.)

✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit reads the setup guide by moonlit garden light.
It checks each little socket, then tucks secrets out of sight.
The flows take root in careful steps, their labels fresh and green.
A teammate sends a message back; the handoff’s clearly seen.
The rabbit hops through verified paths and rests beside the screen.

Comment @coderabbitai help to get the list of available commands.

The vendored writing-relayflows may name it only to warn against the v1
engine; no part before it mentions it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@khaliqgant
khaliqgant marked this pull request as ready for review October 8, 2026 05:39
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-08T07:05:51.840939Z 435d290 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@devin-ai-integration devin-ai-integration 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.

Devin Review found 4 potential issues.

Devin Review

Comment thread web/lib/agent-signup.ts Outdated
Comment thread web/content/setup-skills/setting-up-agent-relay-desktop.md Outdated
Comment thread web/lib/agent-signup.ts Outdated
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7d69310d21

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread web/lib/agent-signup.ts Outdated
@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployed!

Environment URL
Web https://37d76adf-agentrelay-web.agent-workforce.workers.dev

This is a Cloudflare Workers preview version of this PR's build.

Picks up the review fixes in skills#145 (kept sharing mode, socket
timeouts, base-relative URLs); tests follow the new text.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread .claude/skills/writing-relayflows/SKILL.md
Comment thread web/lib/agent-signup.ts Outdated
Comment thread .claude/skills/writing-relayflows/SKILL.md
Comment thread web/lib/agent-signup.ts Outdated
Comment thread web/content/setup-skills/setting-up-agent-relay-flows.md Outdated
Comment thread web/lib/agent-signup-progress.ts Outdated
Comment thread web/scripts/sync-setup-skills.mjs Outdated
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

Comment thread web/lib/agent-signup.ts

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 18 files

Requires human review: Auto-approval blocked because this review re-detected 5 unresolved issues already reported by Cubic.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread .claude/skills/setting-up-agent-relay-sessions/SKILL.md
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md
Comment thread web/content/setup-skills/setting-up-agent-relay-flows.md
Comment thread web/lib/agent-signup.ts Outdated
Comment thread web/lib/test/agent-signup.test.ts Outdated
- Flows progress steps map to the Flows skill's sections 3-5 (connect,
  activate, verify), so completion follows the listener check.
- Local Teams guides rewrite Part 2's desktop commands for the prebuilt Dev
  app (download, app name, bundle id, socket pointer); Linux has no local
  artifact.
- sync-setup-skills --check fails on, and sync removes, vendored copies
  SOURCE.json no longer lists.
- Teams step copy qualifies the new-sessions default; the v2 test also
  rejects side-effect and dynamic imports of @relayflows/core.
- Re-pin to AgentWorkforce/skills@d2e5a3e.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

Comment thread web/lib/agent-signup.ts
…ions-handoff

# Conflicts:
#	web/lib/agent-signup.ts

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

Comment thread web/lib/agent-signup.ts
…al stack

An HTTPS preview or staging host keeps the release app; only the plain-HTTP
local stack serves the Dev DMG.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 2 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread web/lib/agent-signup.ts Outdated
khaliqgant and others added 2 commits October 7, 2026 23:26
…tack

The Dev-app rewrite and the local note now share one check, so an HTTP
staging or self-hosted guide keeps the release app.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
… sync

- prpm.lock pins the @agent-relay setup skills; prpm install writes them to
  .claude/skills/<name>/SKILL.md, as in the relay repo.
- web/scripts/generate-setup-skills.mjs reads the lock and the installed
  files and generates web/lib/generated/setup-skills.ts (prebuild and
  precf:build run it); --check fails when the module drifts.
- CI reinstalls with prpm install --frozen-lockfile and fails if that
  changes prpm.lock or .claude/skills, then runs the check.
- Removes web/scripts/sync-setup-skills.mjs and web/content/setup-skills.

Blocked on publish: signing-in-to-agent-relay-cloud and
setting-up-agent-relay-flows are not on the registry yet, and desktop
1.1.5 / sessions 0.2.5 are unpublished. Once AgentWorkforce/skills#145 merges
and they publish, run prpm install for the two new packages, prpm update,
and npm run skills:generate.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@khaliqgant
khaliqgant marked this pull request as draft October 8, 2026 06:54

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using high effort and found 4 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 36d728d. Configure here.

Comment thread web/scripts/generate-setup-skills.mjs
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md Outdated
Comment thread .claude/skills/setting-up-agent-relay-sessions/SKILL.md Outdated
prpm install signing-in-to-agent-relay-cloud 0.1.0 and
setting-up-agent-relay-flows 0.1.0; prpm update moves desktop to 1.1.5 and
sessions to 0.2.5 (AgentWorkforce/skills@7d727ee). Regenerated the module.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@khaliqgant
khaliqgant marked this pull request as ready for review October 8, 2026 07:02

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 14 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md Outdated
Comment thread .github/workflows/test.yml
Comment thread web/lib/agent-signup.ts
Comment thread .claude/skills/setting-up-agent-relay-sessions/SKILL.md Outdated
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md Outdated
Comment thread web/lib/test/agent-signup.test.ts
Comment thread web/package.json
Comment thread .claude/skills/setting-up-agent-relay-sessions/SKILL.md Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 435d290369

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread web/lib/agent-signup.ts

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 21 files

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread web/scripts/generate-setup-skills.mjs Outdated
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md
Comment thread .claude/skills/setting-up-agent-relay-desktop/SKILL.md
Comment thread web/lib/agent-signup.ts
Comment thread .claude/skills/setting-up-agent-relay-sessions/SKILL.md
Comment thread .github/workflows/test.yml Outdated
…drift check

- The local-stack rewrite also renames the quoted "Agent Relay" display
  name (open -a, tell application) to "Agent Relay Dev".
- stripFrontmatter accepts CRLF line endings.
- CI diffs .claude/skills strictly and ignores only the lock's timestamp.
- prepreview regenerates the module too.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@khaliqgant
khaliqgant merged commit 3459d7c into main Oct 8, 2026
5 checks passed
@khaliqgant
khaliqgant deleted the fix/teams-signup-sessions-handoff branch October 8, 2026 07:34
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.

1 participant