Skip to content

docs: add "One Card per Step" Studio page (AGE-107) - #6247

Merged
jessemiller merged 2 commits into
mainfrom
docs/age-107-merged-step-card
Jun 19, 2026
Merged

docs: add "One Card per Step" Studio page (AGE-107)#6247
jessemiller merged 2 commits into
mainfrom
docs/age-107-merged-step-card

Conversation

@jessemiller

@jessemiller jessemiller commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new docs page documenting the merge of the task and agent nodes into one card on the Studio canvas. Intended to be shared with customers a few days before the feature is turned on.

  • Written as evergreen present-tense feature docs so it stays correct for new users after launch.
  • A dated <Note> banner at the top announces the Wednesday, June 24th rollout and the rationale (streamlining the canvas ahead of upcoming functionality). This banner is the only time-bound content — a {/* CLEANUP */} comment flags it for removal after ship.
  • Three screenshots (collapsed canvas card, expanded editor, swap-agent panel).
  • Covers the key behaviors to preserve from the issue: shared/reusable agents, swap-vs-edit distinction, and that no agent fields are removed (just reorganized).

Scope

Added under AMP → Build, directly below Crew Studio, in:

  • Versions: edge and v1.14.7
  • Locales: en, pt-BR, ko, ar

docs.json nav updated for all 8 combos (validated as valid JSON).

Notes for reviewers

  • The pt-BR / ko / ar translations are machine-generated — please have native speakers skim them, especially UI-label terms (e.g. "Swap" rendered as Trocar / 교체 / تبديل). If the product UI isn't localized, those labels should stay in English.
  • After June 24th: delete just the <Note> banner from each file (flagged inline); no other edits needed.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and dependency pin updates only; no runtime product code changes.

Overview
Adds One Card per Step enterprise documentation for the Studio canvas change that merges task and agent into a single step card, aimed at pre-launch customer communication.

New merged-step-card MDX pages land under AMP → Build (below Crew Studio) for edge and v1.14.7, in en, pt-BR, ko, and ar, with matching docs.json nav entries. Content covers collapsed vs expanded card UI, task vs agent sections, Swap vs edit (shared agents), screenshots, a June 24 rollout <Note> flagged for post-ship removal, and links to Crew Studio / Agent Repositories.

The same PR also bumps AWS-related optional deps: boto3 / aiobotocore in lib/crewai and bedrock-agentcore (pinned >=1.7.0,<1.8.0) in lib/crewai-tools, with uv.lock refreshed.

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

Summary by CodeRabbit

  • Documentation
    • Added new enterprise documentation for the Studio “One Card per Step” (merged-step-card) canvas experience.
    • Covers how steps appear on the canvas, what’s shown in the expanded editor (including agent details), and the difference between swapping an agent vs editing a shared agent (with a reuse warning).
    • Included a time-bound release notice and links to related enterprise features, published across edge and v1.14.7 for multiple locales.

Document the merge of the task and agent nodes into a single step card on
the Studio canvas. Written as evergreen present-tense feature docs with a
dated rollout banner (June 24th) for the pre-launch customer announcement;
the banner is the only time-bound content and is flagged for removal after
ship. Added in edge + v1.14.7 across en, pt-BR, ko, and ar, with nav entries
in docs.json and three canvas/editor/swap screenshots.

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

linear Bot commented Jun 19, 2026

Copy link
Copy Markdown

AGE-107

@corridor-security corridor-security 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.

Summary: This PR adds documentation pages and navigation entries for the Studio merged step card feature across versions and locales; no executable application logic, authentication, authorization, data handling, or external integrations are changed.

Risk: Low risk. No exploitable security vulnerabilities were identified because the changes are static documentation content and do not introduce a new attack surface or modify security boundaries.

@mintlify

mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
crewai 🟢 Ready View Preview Jun 19, 2026, 3:16 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Jun 19, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: bc3316f4-0703-42be-9a3d-03ff42877891

📥 Commits

Reviewing files that changed from the base of the PR and between ac7d7ae and e4679d1.

⛔ Files ignored due to path filters (1)
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (2)
  • lib/crewai-tools/pyproject.toml
  • lib/crewai/pyproject.toml

📝 Walkthrough

Walkthrough

Adds eight new MDX documentation pages for the "One Card per Step" / merged-step-card Studio enterprise feature across four locales (English, Arabic, Korean, Portuguese pt-BR) in both the edge and v1.14.7 version tracks, registers all pages in docs.json, and updates AWS/Bedrock optional dependency versions in two pyproject.toml files.

Changes

Merged Step Card Documentation

Layer / File(s) Summary
Navigation registration in docs.json
docs/docs.json
Eight single-line entries added to the pages arrays for all four locales (en, pt-BR, ko, ar) in both edge and v1.14.7 version tracks.
English canonical documentation
docs/edge/en/enterprise/features/merged-step-card.mdx, docs/v1.14.7/en/enterprise/features/merged-step-card.mdx
Adds the English reference pages for both version tracks, covering frontmatter, time-bound rollout <Note> banner (June 24, 2026), Overview, On the canvas, In the editor (task fields + agent summary with collapsible disclosures), Swap vs. editing agent with a reuse <Warning>, and a <CardGroup> Related section.
Localized documentation (ar, ko, pt-BR)
docs/edge/ar/..., docs/edge/ko/..., docs/edge/pt-BR/..., docs/v1.14.7/ar/..., docs/v1.14.7/ko/..., docs/v1.14.7/pt-BR/...
Adds parallel pages in Arabic, Korean, and Portuguese (pt-BR) for both version tracks, each following the same section structure as the English canonical pages translated into the respective language.

AWS and Bedrock Dependency Updates

Layer / File(s) Summary
Bedrock tools dependency
lib/crewai-tools/pyproject.toml
Pins bedrock-agentcore to version range >=1.7.0,<1.8.0 (upgraded from >=0.1.0).
AWS credentials in crewai
lib/crewai/pyproject.toml
Updates boto3 to ~=1.42.90 (from ~=1.42.79) and aiobotocore to ~=3.5.0 (from ~=3.4.0) in both aws and bedrock optional-dependencies.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

  • vinibrsl
  • alex-clawd
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: adding documentation for the 'One Card per Step' Studio feature across multiple locales and versions, which aligns with the primary purpose of this changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/age-107-merged-step-card

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.

@coderabbitai coderabbitai 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.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx (1)

1-88: ⚠️ Potential issue | 🟠 Major

⚠️ Verify PR authorization for v1.14.7 modifications

Per coding guidelines, files under docs/v*/ are frozen release snapshots and cannot be modified except in [docs-freeze] release-cut PRs. This file is being added to the frozen v1.14.7 documentation track.

No [docs-freeze] or release-cut marker appears in the commit history for this change. Confirm this PR is authorized for v1.14.7 edits, or remove this file from v1.14.7 and restrict changes to docs/edge/ only.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx` around lines 1 -
88, This PR is modifying a file in the frozen v1.14.7 documentation directory,
but frozen release snapshots under docs/v*/ cannot be modified unless the PR has
a [docs-freeze] or release-cut marker in the commit history. Verify that this PR
is authorized as a release-cut PR with the appropriate marker in the commit
message. If this is not a release-cut PR, move all changes from
docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx to
docs/edge/ar/enterprise/features/merged-step-card.mdx instead, ensuring the
v1.14.7 version remains frozen and unmodified.

Source: Coding guidelines

docs/v1.14.7/ko/enterprise/features/merged-step-card.mdx (1)

1-88: ⚠️ Potential issue | 🔴 Critical

⚠️ CRITICAL: This file violates the frozen docs policy.

Per coding guidelines, files under docs/v*/ are frozen release snapshots and cannot be modified except in PRs with [docs-freeze] in the title. The commit adding this file to v1.14.7 (a released, frozen version) lacks the required [docs-freeze] prefix.

Required action:

  • Add the file to docs/edge/ko/enterprise/features/merged-step-card.mdx only, OR
  • Ensure the PR title includes [docs-freeze] prefix to authorize the v1.14.7 modification (release-cut only)

The CI guard docs-snapshots will reject writes to docs/v*/ without this prefix.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/v1.14.7/ko/enterprise/features/merged-step-card.mdx` around lines 1 -
88, The file merged-step-card.mdx was added to the frozen docs/v1.14.7/
directory, which is a released snapshot that cannot be modified without explicit
authorization. To fix this, either move the file content to
docs/edge/ko/enterprise/features/merged-step-card.mdx instead (which is the
active development docs), or if this modification is intentional for the v1.14.7
release, add the [docs-freeze] prefix to the PR title to authorize the
modification to a frozen version. The docs-snapshots CI guard will reject the
current state without one of these actions.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx`:
- Around line 1-88: This PR is modifying a file in the frozen v1.14.7
documentation directory, but frozen release snapshots under docs/v*/ cannot be
modified unless the PR has a [docs-freeze] or release-cut marker in the commit
history. Verify that this PR is authorized as a release-cut PR with the
appropriate marker in the commit message. If this is not a release-cut PR, move
all changes from docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx to
docs/edge/ar/enterprise/features/merged-step-card.mdx instead, ensuring the
v1.14.7 version remains frozen and unmodified.

In `@docs/v1.14.7/ko/enterprise/features/merged-step-card.mdx`:
- Around line 1-88: The file merged-step-card.mdx was added to the frozen
docs/v1.14.7/ directory, which is a released snapshot that cannot be modified
without explicit authorization. To fix this, either move the file content to
docs/edge/ko/enterprise/features/merged-step-card.mdx instead (which is the
active development docs), or if this modification is intentional for the v1.14.7
release, add the [docs-freeze] prefix to the PR title to authorize the
modification to a frozen version. The docs-snapshots CI guard will reject the
current state without one of these actions.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c31a9564-eb0b-4e88-b1aa-b999cb9e0fc3

📥 Commits

Reviewing files that changed from the base of the PR and between 854c67d and ac7d7ae.

⛔ Files ignored due to path filters (3)
  • docs/images/enterprise/merged-step-card-canvas.png is excluded by !**/*.png
  • docs/images/enterprise/merged-step-card-editor.png is excluded by !**/*.png
  • docs/images/enterprise/merged-step-card-swap-agent.png is excluded by !**/*.png
📒 Files selected for processing (9)
  • docs/docs.json
  • docs/edge/ar/enterprise/features/merged-step-card.mdx
  • docs/edge/en/enterprise/features/merged-step-card.mdx
  • docs/edge/ko/enterprise/features/merged-step-card.mdx
  • docs/edge/pt-BR/enterprise/features/merged-step-card.mdx
  • docs/v1.14.7/ar/enterprise/features/merged-step-card.mdx
  • docs/v1.14.7/en/enterprise/features/merged-step-card.mdx
  • docs/v1.14.7/ko/enterprise/features/merged-step-card.mdx
  • docs/v1.14.7/pt-BR/enterprise/features/merged-step-card.mdx

@jessemiller
jessemiller merged commit cf04181 into main Jun 19, 2026
59 checks passed
@jessemiller
jessemiller deleted the docs/age-107-merged-step-card branch June 19, 2026 17:10
jessemiller added a commit that referenced this pull request Jun 24, 2026
…r (AGE-107)

The page itself already landed on main via #6247. This rebases onto main
and applies the two remaining changes:

- Nest crew-studio + merged-step-card into a collapsible "Crew Studio"
  nav group (pencil icon), across edge and v1.14.7 in en, pt-BR, ko, ar.
- Remove the temporary "Rolling out" Note banner (feature ships today).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
jessemiller added a commit that referenced this pull request Jun 24, 2026
…r (AGE-107) (#6317)

The page itself already landed on main via #6247. This rebases onto main
and applies the two remaining changes:

- Nest crew-studio + merged-step-card into a collapsible "Crew Studio"
  nav group (pencil icon), across edge and v1.14.7 in en, pt-BR, ko, ar.
- Remove the temporary "Rolling out" Note banner (feature ships today).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants