Skip to content

docs: update scaffold AGENTS.md for unified create CLI - #6829

Merged
Vidit-Ostwal merged 2 commits into
crewAIInc:mainfrom
Vidit-Ostwal:docs/agents-md-create-cli
Aug 5, 2026
Merged

docs: update scaffold AGENTS.md for unified create CLI#6829
Vidit-Ostwal merged 2 commits into
crewAIInc:mainfrom
Vidit-Ostwal:docs/agents-md-create-cli

Conversation

@Vidit-Ostwal

Copy link
Copy Markdown
Contributor

Summary

Updates the project template AGENTS.md (copied into new projects by crewai create) to document the unified scaffolding CLI from #6821.

  • Documents canonical crewai create tool, create skill, and create template commands
  • Notes deprecated aliases (tool create, skill create, template add) that still work with warnings
  • Adds tool/skill/template lifecycle commands to the Quick Reference
  • Updates "Patterns to NEVER use" and Installation examples

Test plan

  • Verified markdown edits are limited to lib/cli/src/crewai_cli/templates/AGENTS.md
  • Spot-check Quick Reference and Installation sections read correctly in preview
  • After merge, run crewai create crew test_proj and confirm copied AGENTS.md includes the new commands

@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

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: b707fcab-0c61-4977-b099-28f8add81e95

📥 Commits

Reviewing files that changed from the base of the PR and between e6ffbe7 and 139084d.

📒 Files selected for processing (1)
  • lib/cli/src/crewai_cli/templates/AGENTS.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • lib/cli/src/crewai_cli/templates/AGENTS.md

📝 Walkthrough

Walkthrough

Changes

The CLI template documentation now lists canonical scaffolding commands, deprecated aliases, lifecycle commands, and installation examples for crews, flows, tools, skills, and templates.

CLI scaffolding documentation

Layer / File(s) Summary
Update scaffolding command reference and examples
lib/cli/src/crewai_cli/templates/AGENTS.md
The documentation adds canonical commands, deprecated aliases, lifecycle commands, and installation examples for CLI scaffolding.

Suggested reviewers: lorenzejay

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the documentation update for the unified create CLI in the scaffold AGENTS.md file.
Description check ✅ Passed The description directly explains the documented CLI commands, aliases, lifecycle references, installation examples, and test plan.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

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

Actionable comments posted: 2

🤖 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.

Inline comments:
In `@lib/cli/src/crewai_cli/templates/AGENTS.md`:
- Line 144: Remove the no-op --skip_provider option from the “crewai create flow
<name>” example, leaving the flow command consistent with the create_flow
invocation that only uses name and declarative.
- Around line 42-44: Update the command alias descriptions in AGENTS.md to label
`crewai tool create`, `crewai skill create`, and `crewai template add` as
deprecated rather than removed or outdated. State that each alias remains
supported and emits a deprecation warning, while preserving the recommended
command forms.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 128d984f-b069-4ace-9147-d6575d356659

📥 Commits

Reviewing files that changed from the base of the PR and between fef32f4 and b5c9df3.

📒 Files selected for processing (1)
  • lib/cli/src/crewai_cli/templates/AGENTS.md

Comment thread lib/cli/src/crewai_cli/templates/AGENTS.md Outdated
Comment thread lib/cli/src/crewai_cli/templates/AGENTS.md Outdated

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

Actionable comments posted: 1

🤖 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.

Inline comments:
In `@lib/cli/src/crewai_cli/templates/AGENTS.md`:
- Around line 658-660: Update the `@listen("...")` documentation to state that
string targets may refer to a method name or an event/route label, while
clarifying that the target must not share the decorated handler’s method name.
Preserve the explanation that router return values, route labels, and method
completion events use the same trigger namespace.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 89cf6b93-bb17-400d-8979-80d4f04b5fc0

📥 Commits

Reviewing files that changed from the base of the PR and between b5c9df3 and 2c8a3d2.

📒 Files selected for processing (1)
  • lib/cli/src/crewai_cli/templates/AGENTS.md

Comment thread lib/cli/src/crewai_cli/templates/AGENTS.md

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

Actionable comments posted: 1

🤖 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.

Inline comments:
In `@lib/cli/src/crewai_cli/templates/AGENTS.md`:
- Around line 674-678: Resolve the merge conflict in the paragraph describing
handler names and conversational flows: remove the `<<<<<<< HEAD`, `=======`,
and `>>>>>>> main` markers and retain one complete paragraph, including the
guidance not to name a handler after the route it serves.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: dd8f97f9-1905-4870-a8f6-a78819140781

📥 Commits

Reviewing files that changed from the base of the PR and between 2c8a3d2 and 968e655.

📒 Files selected for processing (1)
  • lib/cli/src/crewai_cli/templates/AGENTS.md

Comment thread lib/cli/src/crewai_cli/templates/AGENTS.md Outdated
Document crewai create tool/skill/template, lifecycle commands, and
deprecated-but-supported scaffolding aliases in the project template
AGENTS.md. Remove the no-op --skip_provider flag from the flow example.
@Vidit-Ostwal
Vidit-Ostwal force-pushed the docs/agents-md-create-cli branch from 968e655 to e6ffbe7 Compare August 5, 2026 19:11
@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

@Vidit-Ostwal

Copy link
Copy Markdown
Contributor Author

/code-rabbit review

@Vidit-Ostwal
Vidit-Ostwal merged commit 319a20c into crewAIInc:main Aug 5, 2026
22 checks passed
@Vidit-Ostwal
Vidit-Ostwal deleted the docs/agents-md-create-cli branch August 5, 2026 19:40
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