Skip to content

Add mage ai: prepare a Magento root for AI assisted development - #1

Closed
allrude wants to merge 1 commit into
mainfrom
feature/ai-setup
Closed

Add mage ai: prepare a Magento root for AI assisted development#1
allrude wants to merge 1 commit into
mainfrom
feature/ai-setup

Conversation

@allrude

@allrude allrude commented Aug 23, 2026

Copy link
Copy Markdown
Member

Brings the local mage ai work into the fork so it is versioned and installable, rather than living only in one machine's ~/bin/mage.

mage ai prepares a Magento root as a disposable test bed for the packages under package-source:

  • Git initialises a local only repository, no remote, and writes a .gitignore covering runtime output, env.php, auth.json and the local packages.
  • Stack asks which frontend the project uses, defaulting to Hyva when it is detected.
  • Context writes stack notes and CONTEXT.md so an agent uses the project's own vocabulary instead of re-deriving it.
  • Packages registers package-source/*/* as a Composer path repository.
  • MCP registers magento2-lsp-mcp at user scope, so one registration serves every project.

No existing command changes behaviour. Everything is additive and each step checks its own state first, so re-running is safe.

Prepares a Magento project for working with an AI coding agent:

- local only git repository with a Magento aware .gitignore, so that
  vendor/, generated/ and app/etc/env.php are never committed
- CLAUDE.md describing the deploy mode, the package-source symlink
  setup, and the selected code stack
- package-source/*/* composer path repository, for roots that did not
  come from mage install
- magento2-lsp MCP server registered at user scope

Magento is the base. The frontend stack (luma, hyva, nft or none) and
the Nebula admin theme are asked separately and default to whatever is
already installed, so nothing project specific is assumed.

Every step is idempotent and reports what it skipped, so the command is
safe to run on an existing project. Also available as an optional prompt
at the end of mage create.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@allrude

allrude commented Aug 23, 2026

Copy link
Copy Markdown
Member Author

Opened against a branch the fork inherited, not against new work. The change it describes already exists upstream as GrimLink#47, in the src/ layout.

@allrude allrude closed this Aug 23, 2026
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.

1 participant