Skip to content

[AIT] - Support dynamic patterns in generate-guide skill#3218

Open
GregHolmes wants to merge 9 commits intoAIT-108-Framework-language-feature-combos-investigate-and-design-navigationfrom
AIT-489-generate-guide-dynamic-patterns
Open

[AIT] - Support dynamic patterns in generate-guide skill#3218
GregHolmes wants to merge 9 commits intoAIT-108-Framework-language-feature-combos-investigate-and-design-navigationfrom
AIT-489-generate-guide-dynamic-patterns

Conversation

@GregHolmes
Copy link
Contributor

Description

JIRA ticket: https://ably.atlassian.net/browse/AIT-411

  • Updated the generate-guide skill to accept any guide pattern instead of only message-per-token and message-per-response
  • Source files are now discovered dynamically rather than expecting hardcoded filenames (publisher.ts/subscriber.ts)
  • Added Anthropic human-in-the-loop guide as the first guide generated with the updated skill

Usage

/generate-guide guides/ai-transport/anthropic-human-in-the-loop
/generate-guide guides/ai-transport/openai-message-per-token
/generate-guide guides/ai-transport/anthropic-human-in-the-loop branch:AIT-489-Introduce-E2E-testing-for-Guides-code-2

Note on branching

This branch is based on AIT-108 (dual language navigation) rather than main, since the skill and generated guides depend on the dual language infrastructure (client_lang/agent_lang). Once AIT-108 and the AIT-489 example code branches are merged to main, this workflow runs directly from main without the branch: parameter.

- Add Client/Agent dropdowns for separate frontend/backend language selection
- Support fe_/be_ prefixed code blocks in MDX files
- Preserve language params when navigating between guide pages
- Add aiTransport languages (javascript, python, swift, java)
- Add Guides section to AI Transport nav
- Update anthropic-message-per-response guide with dual language code blocks
- Update @ably/ui to 17.13.1-dev.c839343a

URL params: ?fe_lang=xxx&be_lang=yyy
The test mock for layout-context was missing the isDualLanguagePath
function that LeftSidebar imports, causing TypeError during test runs.
Extends the If component to support dual-language page conditionals:
- fe_lang: show content when frontend language matches
- be_lang: show content when backend language matches
- fe_or_be_lang: show content when either matches (with deduplication)

Used in AI Transport guides for language-specific prerequisites and SDK links.
- Add directory references to file creation instructions (e.g., "In your
  ably-anthropic-agent directory, create publisher.mjs")
- Add cd commands to run instructions for publisher and subscriber
- Add directory context to Step 6 rewind instructions
- Fix Swift Package.swift code block to use fe_swift prefix
- Wrap URL code block in Code component with text language
Move "Message per response" before "Message per token" in navigation
for all AI providers (Anthropic, OpenAI, LangGraph, Vercel AI SDK).
…age-per-token guide

- Add multi-language support (Python, Java, Swift) to message-per-token
  guide, matching the structure of message-per-response
- Fix Python code in both guides: use AsyncAnthropic with async/await,
  use Message objects for publish with extras and append_message,
  use transport_params for echo suppression
- Scope "without await" asides to JavaScript only
Move guide files into anthropic/, openai/, langgraph/, and vercel-ai-sdk/
subdirectories with redirect_from entries for old URLs.
@GregHolmes GregHolmes self-assigned this Feb 20, 2026
@GregHolmes GregHolmes added the review-app Create a Heroku review app label Feb 20, 2026
@coderabbitai
Copy link

coderabbitai bot commented Feb 20, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch AIT-489-generate-guide-dynamic-patterns

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

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

@ably-ci ably-ci temporarily deployed to ably-docs-ait-489-gener-grwclb February 20, 2026 14:13 Inactive
Copy link
Contributor

@mschristensen mschristensen left a comment

Choose a reason for hiding this comment

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

Looks great! We can refine and iterate on this over time to improve the quality of the output.

@GregHolmes GregHolmes force-pushed the AIT-489-generate-guide-dynamic-patterns branch from df7159a to 3824dda Compare February 25, 2026 10:14
@GregHolmes GregHolmes temporarily deployed to ably-docs-ait-489-gener-grwclb February 25, 2026 10:14 Inactive
@GregHolmes GregHolmes temporarily deployed to ably-docs-ait-489-gener-grwclb February 25, 2026 10:15 Inactive
@GregHolmes GregHolmes force-pushed the AIT-489-generate-guide-dynamic-patterns branch from 2bed6ac to 1ab9cab Compare February 25, 2026 10:19
@GregHolmes GregHolmes temporarily deployed to ably-docs-ait-489-gener-grwclb February 25, 2026 10:19 Inactive
@GregHolmes GregHolmes force-pushed the AIT-489-generate-guide-dynamic-patterns branch from 1ab9cab to 08fbba1 Compare February 25, 2026 10:21
@GregHolmes GregHolmes force-pushed the AIT-108-Framework-language-feature-combos-investigate-and-design-navigation branch 3 times, most recently from 88f8c70 to d85abb3 Compare February 26, 2026 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-app Create a Heroku review app

Development

Successfully merging this pull request may close these issues.

3 participants