Skip to content

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

Open
Quratulain-bilal wants to merge 2 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 2 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.

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