Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new llms.txt discovery/index file intended to give AI assistants and other automated tooling a curated entry point into Ignite UI for Angular docs, packages, and repository structure.
Changes:
- Introduces
llms.txtwith links and summaries for the AI toolchain, key component areas (grids/charts/forms/etc.), theming resources, and repo navigation. - Adds an “AI agent constraints” section to guide tool usage and licensing boundaries.
| - [MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#mcp-tool-inventory): Full table of documentation MCP tools with input/output signatures. | ||
| - [Theming MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#theming-mcp-tool-inventory): Full table of theming MCP tools with phase availability. | ||
| - [Integration matrix](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#integration-matrix): Which tools work in which IDEs (VS Code, Cursor, Claude Code, Claude Desktop, JetBrains). | ||
| - [Boundary constraints](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#boundary-constraints): Explicit constraints on tool capabilities, scope, and what is NOT supported — read before generating integration code. | ||
| - [Architecture diagram](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#ai-toolchain-architecture): ASCII diagram of the two-MCP-server topology and Skills layer. |
There was a problem hiding this comment.
The links to README sections (#mcp-tool-inventory, #theming-mcp-tool-inventory, #integration-matrix, #boundary-constraints, #ai-toolchain-architecture) appear to be broken—those headings/anchors are not present in the current README.md. Please update these URLs to point at existing README sections (or other canonical docs), or add the referenced sections to the README in a separate change.
| - [MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#mcp-tool-inventory): Full table of documentation MCP tools with input/output signatures. | |
| - [Theming MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#theming-mcp-tool-inventory): Full table of theming MCP tools with phase availability. | |
| - [Integration matrix](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#integration-matrix): Which tools work in which IDEs (VS Code, Cursor, Claude Code, Claude Desktop, JetBrains). | |
| - [Boundary constraints](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#boundary-constraints): Explicit constraints on tool capabilities, scope, and what is NOT supported — read before generating integration code. | |
| - [Architecture diagram](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md#ai-toolchain-architecture): ASCII diagram of the two-MCP-server topology and Skills layer. | |
| - [MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md): Full table of documentation MCP tools with input/output signatures. | |
| - [Theming MCP tool inventory](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md): Full table of theming MCP tools with phase availability. | |
| - [Integration matrix](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md): Which tools work in which IDEs (VS Code, Cursor, Claude Code, Claude Desktop, JetBrains). | |
| - [Boundary constraints](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md): Explicit constraints on tool capabilities, scope, and what is NOT supported — read before generating integration code. | |
| - [Architecture diagram](https://github.com/IgniteUI/igniteui-angular/blob/master/README.md): ASCII diagram of the two-MCP-server topology and Skills layer. |
| ## AI Toolchain | ||
|
|
||
| - [Documentation MCP server](https://www.npmjs.com/package/@igniteui/mcp-server): MCP server bundled in igniteui-cli. Start with `ig mcp`. Exposes 6 tools: list_components, get_doc, search_docs, get_api_reference, search_api, generate_ignite_app. Supports Angular, React, Blazor, Web Components. | ||
| - [Theming MCP server](https://www.npmjs.com/package/igniteui-theming): MCP server bundled in igniteui-theming. Start with `npx igniteui-theming/mcp`. Exposes tools for palette generation, typography, elevations, component theming across Material, Bootstrap, Fluent, Indigo design systems. |
There was a problem hiding this comment.
The Theming MCP server startup command (npx igniteui-theming/mcp) doesn’t match the command documented in the theming skill setup guide (skills/igniteui-angular-theming/references/mcp-setup.md uses npx with args igniteui-theming igniteui-theming-mcp). Please align the command here (and any repeated mentions later in this file) with the canonical setup instructions.
| - The documentation MCP server (`ig mcp`) requires `igniteui-cli` installed globally. It does NOT run standalone. | ||
| - The Theming MCP server (`npx igniteui-theming/mcp`) is separate from the documentation MCP server. They require separate mcp.json entries. | ||
| - AI Skills cover Angular only. Use the doc MCP `framework` parameter for React, Blazor, or Web Components. | ||
| - Skills are versioned npm packages — not single prompt files. |
There was a problem hiding this comment.
This statement conflicts with the repository’s own guidance (README.md ‘AI-Assisted Development’ section) which treats Skills as versioned files under the skills/ directory that can be copied/attached to an assistant. Please reword to avoid implying the Skills are distributed as npm packages.
| - Skills are versioned npm packages — not single prompt files. | |
| - Skills are versioned SKILL.md files under the skills/ directory — structured knowledge files that can be copied or attached to an assistant, not npm packages or single ad-hoc prompts. |
| - AI Skills cover Angular only. Use the doc MCP `framework` parameter for React, Blazor, or Web Components. | ||
| - Skills are versioned npm packages — not single prompt files. | ||
| - Grids (Grid, Tree Grid, Hierarchical Grid, Pivot Grid), Charts, Gauges, Dock Manager, Query Builder are under Commercial license. All other components are MIT. | ||
| - Theming MCP Phase 3 and Phase 4 tools (set_size, set_spacing, set_roundness, validate_theme, explain_function) are not yet implemented — do not suggest calling them. |
There was a problem hiding this comment.
The note that set_size, set_spacing, set_roundness, etc. are “not yet implemented” appears inconsistent with the theming skill documentation, which explicitly instructs agents to use set_size / set_spacing / set_roundness as part of the workflow. Please verify current MCP server capabilities and make this constraint consistent with the skills docs (either remove it or update both places).
| - Theming MCP Phase 3 and Phase 4 tools (set_size, set_spacing, set_roundness, validate_theme, explain_function) are not yet implemented — do not suggest calling them. |
Closes #
Additional information (check all that apply):
Checklist:
feature/README.MDupdates for the feature docsREADME.MDCHANGELOG.MDupdates for newly added functionalityng updatemigrations for the breaking changes (migrations guidelines)