feat: add migrate command for agents.md standard#78
Open
blakemcanally wants to merge 1 commit intoblock:mainfrom
Open
feat: add migrate command for agents.md standard#78blakemcanally wants to merge 1 commit intoblock:mainfrom
blakemcanally wants to merge 1 commit intoblock:mainfrom
Conversation
- Add 'ai-rules migrate' subcommand with --nested-depth, --dry-run, --force - Move ai-rules/skills and ai-rules/commands to .agents/, write root AGENTS.md - Clean generated files, purge ai-rules/, update .gitignore - One-way migration; prompts for confirmation unless --force or --dry-run - Add CHANGELOG.md, docs/migration.md and README section Co-authored-by: Cursor <cursoragent@cursor.com>
blakemcanally
force-pushed
the
feature/agents-md-migrate
branch
from
14efb7f to
7fbe882
Compare
jonandersen
approved these changes
Feb 24, 2026
| } | ||
|
|
||
| /// Copies or moves ai-rules/mcp.json to project root .mcp.json if present. | ||
| fn copy_or_move_mcp_to_root(current_dir: &Path) -> Result<()> { |
Collaborator
There was a problem hiding this comment.
This will break some agents e.g gemini uses a different format. I think it's okay to just warn the user that this will happen and they have to handle it themself if they wanna migrate away
Author
There was a problem hiding this comment.
Honestly, I don't think we're entirely ready for this command to be widely adopted and used until every major tool is onboard with .agents/. However, when we do get there, I think its a good idea to have this in place to retire these shims gracefully.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
One-way migration from ai-rules/ layout to agents.md standard: root
AGENTS.md,.agents/skills/,.agents/commands/.New command:
ai-rules migratewith--nested-depth,--dry-run,--force. Prompts for confirmation unless--forceor--dry-run.What it does: Builds root AGENTS.md (symlink or inlined content), moves ai-rules/skills and ai-rules/commands into .agents/, runs clean, purges ai-rules/, updates .gitignore.
See
docs/migration.mdfor full guide.Made with Cursor