docs: sync AGENTS.md with AGENT_CONFIG for missing agents#2025
docs: sync AGENTS.md with AGENT_CONFIG for missing agents#2025Quratulain-bilal wants to merge 4 commits intogithub:mainfrom
Conversation
Add Antigravity (agy) and Mistral Vibe (vibe) to the supported agents table — both exist in AGENT_CONFIG but were missing from documentation. Fix Agent Categories section: - Move Cursor from CLI-Based to IDE-Based (requires_cli is False) - Add missing CLI agents: Codex, Auggie, iFlow - Add missing IDE agents: Kilo Code, Roo Code, Trae, Antigravity Update Command File Formats and Directory Conventions sections to include all agents that were previously undocumented. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR updates AGENTS.md to better reflect the agent metadata defined in AGENT_CONFIG (in src/specify_cli/__init__.py), primarily by adding missing agents and aligning category/format guidance.
Changes:
- Added Antigravity and Mistral Vibe to the supported agents table.
- Updated CLI-based vs IDE-based agent categorization (notably moving Cursor to IDE-based) and expanded both lists.
- Refreshed the Markdown “Used by” list and the Directory Conventions section with additional agent-specific paths.
Comments suppressed due to low confidence (1)
AGENTS.md:406
- This Directory Conventions list includes “Antigravity:
.agent/commands/”, but Antigravity is treated as a skills-migrated agent in the CLI (explicit.agent/commandsusage is deprecated and--ai-skillsis required when--ai agyis provided). Update this entry to reflect the recommended skills path (e.g.,.agent/skills/) and/or call out the deprecation so users don’t scaffold an unsupported layout.
- Cursor: `.cursor/commands/`
- Windsurf: `.windsurf/workflows/`
- Kilo Code: `.kilocode/workflows/`
- Antigravity: `.agent/commands/`
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback
- Fix Cursor table entry: CLI Tool → N/A (IDE-based), matches requires_cli=False in AGENT_CONFIG - Fix Antigravity directory: .agent/commands/ → .agent/skills/ (skills-based per AGENT_SKILLS_MIGRATIONS) - Add opencode singular command exception to Directory Conventions (.opencode/command/) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
Addressed all 3 Copilot review comments:
All changes verified against AGENT_CONFIG in src/specify_cli/init.py. |
|
@mnriem Changes addressed — ready for re-review. |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.
Comments suppressed due to low confidence (1)
AGENTS.md:54
- Antigravity is added as a supported agent, but the table doesn’t indicate the
--aikey used by the CLI. InAGENT_CONFIGthe key isagy, and users must use--ai agy(often with--ai-skills). Consider includingagyin the table (either in the CLI Tool column or via a dedicated “--ai key” field) so the doc stays actionable.
| **Trae** | `.trae/rules/` | Markdown | N/A (IDE-based) | Trae IDE |
| **Antigravity** | `.agent/skills/` | Markdown | N/A (IDE-based) | Antigravity IDE (skills-based) |
| **Mistral Vibe** | `.vibe/prompts/` | Markdown | `vibe` | Mistral Vibe CLI |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| | **Gemini CLI** | `.gemini/commands/` | TOML | `gemini` | Google's Gemini CLI | | ||
| | **GitHub Copilot** | `.github/agents/` | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code | | ||
| | **Cursor** | `.cursor/commands/` | Markdown | `cursor-agent` | Cursor CLI | | ||
| | **Cursor** | `.cursor/commands/` | Markdown | N/A (IDE-based) | Cursor IDE | | ||
| | **Qwen Code** | `.qwen/commands/` | Markdown | `qwen` | Alibaba's Qwen Code CLI | |
There was a problem hiding this comment.
The supported agents table now lists Cursor as having no CLI tool, but the --ai key in AGENT_CONFIG is still cursor-agent. Since this doc is used as a reference for adding/updating agents, consider including the --ai key (e.g., cursor-agent) in this row (or adding a separate “--ai key” column) to avoid readers assuming the key is cursor.
This issue also appears on line 52 of the same file.
See below for a potential fix:
| Agent | Directory | Format | CLI Tool | Description |
| -------------------------- | ---------------------- | -------- | --------------- | ------------------------------------------------ |
| **Claude Code** | `.claude/commands/` | Markdown | `claude` | Anthropic's Claude Code CLI |
| **Gemini CLI** | `.gemini/commands/` | TOML | `gemini` | Google's Gemini CLI |
| **GitHub Copilot** | `.github/agents/` | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code |
| **Cursor** | `.cursor/commands/` | Markdown | N/A (IDE-based) | Cursor IDE (`--ai cursor-agent`) |
| **Qwen Code** | `.qwen/commands/` | Markdown | `qwen` | Alibaba's Qwen Code CLI (`--ai qwen-code`) |
| **opencode** | `.opencode/command/` | Markdown | `opencode` | opencode CLI |
| **Codex CLI** | `.agents/skills/` | Markdown | `codex` | Codex CLI (skills) |
| **Windsurf** | `.windsurf/workflows/` | Markdown | N/A (IDE-based) | Windsurf IDE workflows |
| **Junie** | `.junie/commands/` | Markdown | `junie` | Junie by JetBrains |
| **Kilo Code** | `.kilocode/workflows/` | Markdown | N/A (IDE-based) | Kilo Code IDE |
| **Auggie CLI** | `.augment/commands/` | Markdown | `auggie` | Auggie CLI |
| **Roo Code** | `.roo/commands/` | Markdown | N/A (IDE-based) | Roo Code IDE |
| **CodeBuddy CLI** | `.codebuddy/commands/` | Markdown | `codebuddy` | CodeBuddy CLI |
| **Qoder CLI** | `.qoder/commands/` | Markdown | `qodercli` | Qoder CLI |
| **Kiro CLI** | `.kiro/prompts/` | Markdown | `kiro-cli` | Kiro CLI |
| **Amp** | `.agents/commands/` | Markdown | `amp` | Amp CLI |
| **SHAI** | `.shai/commands/` | Markdown | `shai` | SHAI CLI |
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback. If not applicable, please explain why
Cursor's AGENT_CONFIG key is cursor-agent but the CLI Tool column shows N/A (IDE-based). Adding the --ai flag reference in the Description column so readers know the correct key to use with specify init --ai cursor-agent. Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Antigravity's AGENT_CONFIG key is 'agy' and requires --ai-skills flag, but the table only showed N/A (IDE-based). Adding the --ai flag reference so readers know to use: specify init --ai agy --ai-skills Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.
Comments suppressed due to low confidence (1)
AGENTS.md:409
- This lists Antigravity as
.agent/skills/, but the build/config currently generates Antigravity command files under.agent/commands/and uses--ai agyas the identifier. Consider updating this bullet (or documenting both the commands dir and the skills dir) so it stays consistent with runtime/release packaging.
- **IDE agents**: Follow IDE-specific patterns:
- Copilot: `.github/agents/`
- Cursor: `.cursor/commands/`
- Windsurf: `.windsurf/workflows/`
- Kilo Code: `.kilocode/workflows/`
- Antigravity: `.agent/skills/` (skills-based)
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Summary
requires_cli: FalseinAGENT_CONFIG)
Test plan
src/specify_cli/__init__.py