A free open source IT asset/license management system
Improve diagrams
Marcus Mooreff9600818a45
diff --git a/.ai/README.md b/.ai/README.mdindex ed55cebf26..bc1106fcdb 100644--- a/.ai/README.md+++ b/.ai/README.md@@ -15,11 +15,17 @@ running Boost themselves.## How it fits together+Two separate things happen at two separate times.++### 1. Regenerating the files — `php artisan boost:install --guidelines`++Boost combines the sources you edit with its own bundled guidance to (re)generate the committed files:+```mermaidflowchart LRG[".ai/guidelines/*.md"]CFG["config/boost.php"]- RR["record-rule<br/>(Boost MCP tool)"]+ V["Boost's bundled<br/>framework and package guidance"]BI(["php artisan<br/>boost:install --guidelines"])@@ -27,30 +33,43 @@ flowchart LRAGENTS["AGENTS.md"]BR[".ai/rules/boost/*.md"]IDX[".ai/rules/index.md"]- TR[".ai/rules/*.md"]-- AI(["AI coding assistant"])G --> BI- CFG -. controls .-> BI+ CFG --> BI+ V --> BIBI --> CLAUDEBI --> AGENTS- BI -. "@scoped blocks<br/>(scoped_guidelines = true)" .-> BR+ BI --> BR+ BI --> IDX++ classDef edit fill:#d5f5e3,stroke:#1e8449,color:#145a32;+ classDef gen fill:#f8d7da,stroke:#c0392b,color:#611;+ classDef vendor fill:#eaecee,stroke:#7f8c8d,color:#2c3e50;+ class G,CFG edit;+ class CLAUDE,AGENTS,BR,IDX gen;+ class V vendor;+```- RR --> TR- RR --> IDX- BR --> IDX+**Green** = you edit these. **Red** = generated, never hand-edit (see below). **Grey** = Boost's own+guidance, shipped inside the package.- CLAUDE -->|always-on| AI- AGENTS -->|always-on| AI- IDX -. "path-scoped,<br/>on demand" .-> AI- TR -. on demand .-> AI+Path-scoped rules that we author (`.ai/rules/*.md`) are written by the `record-rule` tool, which also+updates `.ai/rules/index.md` — see [How to change the guidance](#how-to-change-the-guidance).- classDef generated fill:#f8d7da,stroke:#c0392b,color:#611;- class CLAUDE,AGENTS,BR,IDX generated;-```+### 2. What a coding assistant loads-Nodes shaded red are **generated** — see below.+```mermaid+flowchart LR+ CLAUDE["CLAUDE.md"]+ AGENTS["AGENTS.md"]+ RULES[".ai/rules/**<br/>(via index.md)"]++ AI(["AI coding assistant"])++ CLAUDE -->|"always-on — every request"| AI+ AGENTS -->|"always-on — every request"| AI+ RULES -->|"on demand — when you edit a matching path"| AI+```## What is generated — never hand-edit