docs: sync AGENTS.md with AGENT_CONFIG for missing agents by Quratulain-bilal · Pull Request #2025 · github/spec-kit

Quratulain-bilal · 2026-03-30T19:04:43Z

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>

Copilot

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.

AGENTS.md

mnriem

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 · 2026-03-30T19:36:15Z

Addressed all 3 Copilot review comments:

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

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

Quratulain-bilal · 2026-03-31T09:54:51Z

@mnriem Changes addressed — ready for re-review.

Copilot

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.

AGENTS.md

mnriem

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>

Copilot

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.

AGENT_CONFIG generates .agent/commands/ by default, but --ai-skills uses .agent/skills/. Document both paths in Directory Conventions. Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Quratulain-bilal · 2026-03-31T16:56:51Z

All Copilot feedback addressed. Every agent row verified against AGENT_CONFIG source of
truth.

@mnriem Ready for re-review.

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

AGENTS.md

Tabnine uses .tabnine/agent/commands/ which has an extra path segment compared to the usual .<agent-name>/commands/ convention. Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

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:410

The Directory Conventions entry for Antigravity says .agent/commands/ is the “default” and .agent/skills/ is used with --ai-skills, but specify init --ai agy exits with a migration error unless --ai-skills is enabled (and interactive selection auto-enables it). Update this bullet to reflect that skills mode is required/recommended, and that .agent/commands/ is deprecated/legacy (and may only exist transiently during extraction).

  - Windsurf: `.windsurf/workflows/`
  - Kilo Code: `.kilocode/workflows/`
  - Antigravity: `.agent/commands/` (default) or `.agent/skills/` (with `--ai-skills`)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

AGENTS.md

mnriem

Please address Copilot feedback

- Add GitHub Copilot to the Markdown format "Used by" list (it uses markdown with .agent.md extension and chat mode frontmatter) - Clarify Antigravity uses .agent/skills/ (requires --ai-skills); .agent/commands/ is deprecated/legacy Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add Roo Code and IBM Bob to the IDE agents list in Directory Conventions so all IDE-based agents are documented. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

AGENTS.md

mnriem · 2026-03-31T19:52:17Z

@Quratulain-bilal Please address Copilot feedback

Codex CLI requires --ai-skills when explicitly selected via specify init --ai codex (exits with migration error otherwise). Updated table, CLI-Based Agents list, and Directory Conventions. Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

AGENTS.md

mnriem · 2026-03-31T20:02:55Z

@Quratulain-bilal Thank you for working through these reviews from Copilot. Please address the ones. And hopefully that will be the last set!

- Antigravity table row: .agent/skills/ → .agent/commands/ (matches AGENT_CONFIG folder + commands_subdir; skills mode via --ai-skills) - Add shared .agents/ folder exception for Amp and Codex - Move Codex from Skills-based to Shared folder section (it shares .agents/ with Amp) Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Quratulain-bilal · 2026-03-31T20:16:04Z

Addressed both comments:

Antigravity table directory fixed to .agent/commands/ (matches AGENT_CONFIG)
Added shared .agents/ folder exception for Amp and Codex

Copilot

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:414

This line suggests .agent/commands/ is the default for Antigravity, but the CLI enforces --ai-skills for --ai agy, so the effective/current location is .agent/skills/ and .agent/commands/ is deprecated. Consider rewording to avoid implying a supported non-skills path.

  - Antigravity: `.agent/commands/` (default) → `.agent/skills/` with `--ai-skills` (required)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Reword to make clear .agent/skills/ is the effective path and .agent/commands/ is deprecated, since CLI enforces --ai-skills. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Quratulain-bilal · 2026-03-31T20:46:31Z

All Copilot feedback addressed — zero comments remaining. @mnriem Ready for re-review.

mnriem · 2026-03-31T21:07:22Z

Thank you!

Quratulain-bilal requested a review from mnriem as a code owner March 30, 2026 19:04

mnriem requested a review from Copilot March 30, 2026 19:11

Copilot started reviewing on behalf of mnriem March 30, 2026 19:12 View session

Copilot AI reviewed Mar 30, 2026

View reviewed changes

AGENTS.md Show resolved Hide resolved

AGENTS.md Outdated Show resolved Hide resolved

AGENTS.md Show resolved Hide resolved

mnriem requested changes Mar 30, 2026

View reviewed changes

Quratulain-bilal requested a review from mnriem March 31, 2026 09:51

mnriem requested a review from Copilot March 31, 2026 11:37

Copilot started reviewing on behalf of mnriem March 31, 2026 11:37 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

AGENTS.md Show resolved Hide resolved

mnriem requested changes Mar 31, 2026

View reviewed changes

mnriem requested a review from Copilot March 31, 2026 13:12

Copilot started reviewing on behalf of mnriem March 31, 2026 13:13 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

mnriem requested a review from Copilot March 31, 2026 17:22

Copilot started reviewing on behalf of mnriem March 31, 2026 17:23 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

AGENTS.md Show resolved Hide resolved

docs: add Tabnine nested path exception to Directory Conventions

0ce0f5f

Tabnine uses .tabnine/agent/commands/ which has an extra path segment compared to the usual .<agent-name>/commands/ convention. Addresses Copilot review feedback. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

mnriem requested a review from Copilot March 31, 2026 17:58

Copilot started reviewing on behalf of mnriem March 31, 2026 17:58 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

AGENTS.md Outdated Show resolved Hide resolved

mnriem self-requested a review March 31, 2026 18:04

mnriem requested changes Mar 31, 2026

View reviewed changes

Quratulain-bilal and others added 2 commits March 31, 2026 23:22

docs: add missing IDE agents to Directory Conventions

315bb3f

Add Roo Code and IBM Bob to the IDE agents list in Directory Conventions so all IDE-based agents are documented. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

mnriem requested a review from Copilot March 31, 2026 19:43

Copilot started reviewing on behalf of mnriem March 31, 2026 19:44 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

AGENTS.md Outdated Show resolved Hide resolved

mnriem requested a review from Copilot March 31, 2026 19:57

Copilot started reviewing on behalf of mnriem March 31, 2026 19:58 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

AGENTS.md Show resolved Hide resolved

AGENTS.md Show resolved Hide resolved

mnriem requested a review from Copilot March 31, 2026 20:15

Copilot started reviewing on behalf of mnriem March 31, 2026 20:16 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

docs: clarify Antigravity skills path is required, not optional

ee1552c

Reword to make clear .agent/skills/ is the effective path and .agent/commands/ is deprecated, since CLI enforces --ai-skills. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

mnriem requested a review from Copilot March 31, 2026 20:35

Copilot started reviewing on behalf of mnriem March 31, 2026 20:36 View session

Copilot AI reviewed Mar 31, 2026

View reviewed changes

mnriem approved these changes Mar 31, 2026

View reviewed changes

mnriem merged commit b8335a5 into github:main Mar 31, 2026
12 checks passed

Conversation

Quratulain-bilal commented Mar 30, 2026

Summary

Test plan

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Quratulain-bilal commented Mar 30, 2026

Uh oh!

Quratulain-bilal commented Mar 31, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Quratulain-bilal commented Mar 31, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

mnriem commented Mar 31, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

mnriem commented Mar 31, 2026

Uh oh!

Quratulain-bilal commented Mar 31, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Quratulain-bilal commented Mar 31, 2026

Uh oh!

Uh oh!

mnriem commented Mar 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects