adds docs

Author: nunomaduro

README.md

@@ -81,6 +81,25 @@ Laravel Boost includes AI guidelines for the following packages and frameworks.
 | Laravel Folio | core |
 | Enforce Tests | conditional |
 
+### Keeping Guidelines Up-to-Date
+
+You may want to periodically update your local AI guidelines to ensure they reflect the latest versions of the Laravel ecosystem packages you have installed. To do so, you can use the `boost:update` Artisan command.
+
+```bash
+php artisan boost:update
+```
+
+You may also automate this process by adding it to your Composer "post-update-cmd" scripts:
+
+```json
+{
+  "scripts": {
+    "post-update-cmd": [
+      "@php artisan boost:update --ansi"
+    ]
+  }
+}
+```
 
 ## Available Documentation
 
@@ -106,6 +125,29 @@ You can override Boost's built-in AI guidelines by creating your own custom guid
 
 For example, to override Boost's "Inertia React v2 Form Guidance" guidelines, create a file at `.ai/guidelines/inertia-react/2/forms.blade.php`. When you run `boost:install`, Boost will include your custom guideline instead of the default one.
 
+## Third-Party Package AI Guidelines
+
+If you maintain a third-party package and would like Boost to include AI guidelines for it, you can do so by adding a `resources/boost/guidelines/core.blade.php` file to your package. When users of your package run `php artisan boost:install`, Boost will automatically load your guidelines.
+
+AI guidelines should provide a short overview of what your package does, outline any required file structure or conventions, and explain how to create or use its main features (with example commands or code snippets). Keep them concise, actionable, and focused on best practices so AI can generate correct code for your users. Here is an example:
+
+```php
+## Package Name
+
+This package provides [brief description of functionality].
+
+### Features
+
+- Feature 1: [clear & short description].
+- Feature 2: [clear & short description]. Example usage:
+
+@verbatim
+<code-snippet name="How to use Feature 2" lang="php">
+$result = PackageName::featureTwo($param1, $param2);
+</code-snippet>
+@endverbatim
+```
+
 ## Manually Registering the Boost MCP Server
 
 Sometimes you may need to manually register the Laravel Boost MCP server with your editor of choice. You should register the MCP server using the following details: