mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-09-22 10:56:50 +00:00
6b6a39d503
* feat: scaffold project with assistant instruction files - Updated project creation to include `CLAUDE.md` and `GEMINI.md` that import `AGENTS.md`, ensuring consistent guidance across coding assistants. - Implemented utility functions to copy assistant instruction files during project setup. - Enhanced documentation in `AGENTS.md` to emphasize the importance of keeping telemetry enabled for optimal performance. - Added tests to verify the correct scaffolding of assistant instruction files and their contents. * fix(cli): neutral observability guidance in scaffolded AGENTS.md - State the observability rule as the user's decision, never a fix for console warnings, speed, or a "clean" configuration - Rewrite the AMP section as built-in capabilities: no "free", "proactively", "sales pitch", or scripted pitches - Turn the research mandate into a list of sources to consult when version details matter - Retarget the scaffold tests to the new wording Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * fix(cli): scaffold assistant files for JSON crews and harden telemetry tests - create_json_crew, the default `crewai create crew` path, now copies AGENTS.md, CLAUDE.md and GEMINI.md; AGENTS.md documents the JSON layout - span helper no longer depends on OTEL_SDK_DISABLED being popped by an earlier test; thread-scope test stops its worker before leaving the mock - single import style in the shutdown test Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
70 lines
2.9 KiB
Plaintext
70 lines
2.9 KiB
Plaintext
---
|
||
title: Coding Tools
|
||
description: Use AGENTS.md to guide coding agents and IDEs across your CrewAI projects.
|
||
icon: terminal
|
||
mode: "wide"
|
||
---
|
||
|
||
## Why AGENTS.md
|
||
|
||
`AGENTS.md` is a lightweight, repo-local instruction file that gives coding agents consistent, project-specific guidance. Keep it in the project root and treat it as the source of truth for how you want assistants to work: conventions, commands, architecture notes, and guardrails.
|
||
|
||
## Create a Project with the CLI
|
||
|
||
Use the CrewAI CLI to scaffold a project. `AGENTS.md` is added at the root, together with a `CLAUDE.md` and a `GEMINI.md` that import it, so Claude Code and Gemini CLI read the same guidance as every other assistant.
|
||
|
||
```bash
|
||
# Crew
|
||
crewai create crew my_crew
|
||
|
||
# Flow
|
||
crewai create flow my_flow
|
||
|
||
# Tool repository
|
||
crewai create tool my_tool
|
||
```
|
||
|
||
<Note>
|
||
`crewai tool create` is deprecated and still works with a warning. Use `crewai create tool` instead.
|
||
</Note>
|
||
|
||
## Tool Setup: Point Assistants to AGENTS.md
|
||
|
||
### Codex
|
||
|
||
Codex can be guided by `AGENTS.md` files placed in your repository. Use them to supply persistent project context such as conventions, commands, and workflow expectations.
|
||
|
||
### Claude Code
|
||
|
||
Claude Code reads `CLAUDE.md` and ignores `AGENTS.md`. Scaffolded projects ship a `CLAUDE.md` whose only instruction is the import line `@AGENTS.md`, so the shared guidance is loaded without duplicating it. Add Claude-specific notes under that line and keep shared conventions in `AGENTS.md`.
|
||
|
||
For a project created before `CLAUDE.md` was scaffolded, add the import yourself:
|
||
|
||
```bash
|
||
printf '@AGENTS.md\n' > CLAUDE.md
|
||
```
|
||
|
||
Do not rename `AGENTS.md` to `CLAUDE.md`: Codex and Cursor read `AGENTS.md`, and the rename hides it from them.
|
||
|
||
### Gemini CLI and Google Antigravity
|
||
|
||
Gemini CLI and Antigravity load a project context file (default: `GEMINI.md`) from the repo root and parent directories. Scaffolded projects ship a `GEMINI.md` whose only instruction is the import line `@./AGENTS.md`, so the shared guidance is loaded without duplicating it. Add Gemini-specific notes under that line and keep shared conventions in `AGENTS.md`.
|
||
|
||
For a project created before `GEMINI.md` was scaffolded, add the import yourself:
|
||
|
||
```bash
|
||
printf '@./AGENTS.md\n' > GEMINI.md
|
||
```
|
||
|
||
Alternatively, set `context.fileName` in your Gemini CLI settings to include `AGENTS.md` and Gemini reads it directly. Do not rename `AGENTS.md` to `GEMINI.md`: Codex and Cursor read `AGENTS.md`, and the rename hides it from them.
|
||
|
||
### Cursor
|
||
|
||
Cursor supports `AGENTS.md` as a project instruction file. Place it at the project root to provide guidance for Cursor’s coding assistant.
|
||
|
||
### Windsurf
|
||
|
||
Claude Code provides an official integration with Windsurf. If you use Claude Code inside Windsurf, follow the Claude Code guidance above and import `AGENTS.md` from `CLAUDE.md`.
|
||
|
||
If you are using Windsurf’s native assistant, configure its project rules or instructions feature (if available) to read from `AGENTS.md` or paste the contents directly.
|