Skip to content

docs: sync AGENTS.md with AGENT_CONFIG for missing agents#2025

Open
Quratulain-bilal wants to merge 4 commits intogithub:mainfrom
Quratulain-bilal:fix-agents-md-missing-agents
Open

docs: sync AGENTS.md with AGENT_CONFIG for missing agents#2025
Quratulain-bilal wants to merge 4 commits intogithub:mainfrom
Quratulain-bilal:fix-agents-md-missing-agents

Conversation

@Quratulain-bilal
Copy link
Copy Markdown

Summary

  • Added missing agents (Antigravity, Mistral Vibe) to the supported agents table
  • Fixed Cursor categorization: moved from CLI-Based to IDE-Based (matches requires_cli: False in
    AGENT_CONFIG)
  • Added missing agents to CLI-Based list (Codex, Auggie, iFlow)
  • Added missing agents to IDE-Based list (Kilo Code, Roo Code, Trae, Antigravity)
  • Updated Markdown Format users list and Directory Conventions sections

Test plan

  • Verified all changes match AGENT_CONFIG in src/specify_cli/__init__.py
  • No code changes, documentation only

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>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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/commands usage is deprecated and --ai-skills is required when --ai agy is 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.

Copy link
Copy Markdown
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

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

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>
@Quratulain-bilal
Copy link
Copy Markdown
Author

Addressed all 3 Copilot review comments:

  1. Fixed Cursor table entry to reflect requires_cli: False (N/A IDE-based)
  2. Updated Antigravity to .agent/skills/ per AGENT_SKILLS_MIGRATIONS
  3. Added opencode singular command exception to Directory Conventions

All changes verified against AGENT_CONFIG in src/specify_cli/init.py.

@Quratulain-bilal Quratulain-bilal requested a review from mnriem March 31, 2026 09:51
@Quratulain-bilal
Copy link
Copy Markdown
Author

@mnriem Changes addressed — ready for re-review.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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 --ai key used by the CLI. In AGENT_CONFIG the key is agy, and users must use --ai agy (often with --ai-skills). Consider including agy in 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.

Comment on lines 31 to 34
| **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 |
Copy link

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

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

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                                         |

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

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

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>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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 agy as 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.

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.

3 participants