Skip to content

Info for AI - #1356

Merged
royduin merged 2 commits into
masterfrom
ai-info
Aug 14, 2026
Merged

Info for AI#1356
royduin merged 2 commits into
masterfrom
ai-info

Conversation

@royduin

@royduin royduin commented Aug 14, 2026

Copy link
Copy Markdown
Member

The CLAUDE.md here is just in case you're working directly on the core. The guideline is for Laravel Boost, currently there are no skills. I did create some but it was kind of copy of the docs which didn't felt very maintainable. We could sync the docs automatically to skills but lets see how this is going with a link to https://docs.rapidez.io/llms.txt which was added in: rapidez/docs#127. Also added a new AI page in the docs: rapidez/docs#128

@royduin
royduin requested a review from Jade-GG August 14, 2026 07:10
@royduin
royduin requested a review from indykoning as a code owner August 14, 2026 07:10
Comment thread resources/boost/guidelines/core.blade.php
@royduin
royduin merged commit d6176c0 into master Aug 14, 2026
23 of 25 checks passed
@royduin
royduin deleted the ai-info branch August 14, 2026 08:36

Never treat this as a "normal" Laravel e-commerce package: catalog data is read straight from Magento's database schema via Eloquent, not through Magento's own ORM or REST API — GraphQL is only used for write/transactional actions like cart and checkout.

IMPORTANT!! For all Rapidez specific questions please check the https://docs.rapidez.io/llms.txt and the relevant links first!

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Is this really the best way to make sure any LLM understands this? Is there a standardized way to give "important" context? Isn't everything in this file important enough anyway?

Given the sliding context windows issue, if it's really important it should also probably be all the way at the bottom of the file as a precaution. Especially if we expand this list below eventually.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

  • Not sure, I've seen other packages do it and it seem to work fine.
  • For the second part; I don't understand what you're saying here.

Comment on lines +11 to +12
- Catalog, category, CMS data, etc everything that's we need to read from the Magento → Eloquent models querying the Magento database directly (see `Rapidez\Core\Models\*`)
- Cart, checkout, customer mutations, etc everything that has authentication, is dynamic or need to write to Magento → Magento GraphQL.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

These 2 instructions don't seem particularly clear to me and I could easily see an LLM tripping up and mixing them up. I'm not an expert on this, but I would personally expect a small table to be easier to interpret.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

So far so good, suggestions are welcome

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