Kendo UI for Angular — Execution Plan
IMPORTANT — MCP Tools: All
kendo_*tools referenced in this plan are provided by the kendo-angular-mcp MCP server. They are NOT deferred tools and must NOT be searched for withtool_search. Call them directly by name once the MCP server is running. If any tool is unavailable, the MCP server may not be started — inform the user to start it via the notification banner in their editor.
Current Goal:
$ARGUMENTS
Step 1: Assess the Request
Before executing any phase, do three things:
Detect Angular project setup — read additional-plan.md for NgModule vs Standalone detection and theme management instructions. Apply these findings throughout all code generation.
Read UX/design defaults — read ux-guidelines.md. These apply to the entire implementation.
Decide which conditional phases apply — use the table below, then load only the relevant supporting files.
| Phase | Include when | Supporting file |
|---|---|---|
| Component Integration | API reference or component docs are needed — default yes unless purely layout/theming work | phase-components.md |
| Layout Foundation | Page structure, sections, or explicit layout work is requested | phase-layout.md |
| Responsive Behavior | Layout is needed AND responsive behavior across devices is required | phase-responsive.md |
| Custom Theming | Custom colors, brand theme, or CSS variables are explicitly requested. If uncertain, ask the user before proceeding. | phase-theming.md |
| Iconography | Icons are referenced or clearly needed for navigation/actions | phase-icons.md |
Requirements Summary:
- Framework: Angular
- Component Library: Kendo UI for Angular — use ONLY Kendo UI for Angular components. Use
kendo_component_assistantfor all docs and code snippets. Do not substitute another tool even if one appears relevant. - Layout Mode: Kendo Design System CSS Utilities — use ONLY Kendo utility classes for all styling, layout, spacing, and positioning. Avoid custom CSS, inline styles, or other CSS framework classes.
- Accessibility: WCAG 2.2 Level AA. WCAG guidelines are loaded in Phase 0. Call
kendo_accessibility_assistantwithincludeGeneralGuidelines=falseon ALL calls. - No Validator: There is no
kendo_validator_assistanttool. Useng buildfor compilation checks and manually review the validation steps in validation-steps.md. - Grid height: Always set an explicit height on Grid (e.g.,
[height]="'500px'"orflex: 1; min-height: 0inside a flex column) — without it, Grid renders all rows and expands the page indefinitely. - Chart height: Always set an explicit height on Chart components (e.g.,
style="height: 300px").
Phase 0: CRITICAL — Accessibility Foundation (ALWAYS FIRST)
Step 1 — Load WCAG 2.2 Level AA guidelines:
Read ../kendo-angular-accessibility/wcag-guidelines.md. These apply to ALL components throughout the entire implementation.
Step 2 — Retrieve component-specific accessibility information:
MANDATORY: Before implementing ANY components, call the accessibility assistant for each primary component you plan to use. The WCAG general guidelines are already loaded above, so always use includeGeneralGuidelines=false.
First component:
kendo_accessibility_assistant({
query="What are the accessibility requirements for [COMPONENT_NAME]?",
component="[COMPONENT_NAME]",
includeGeneralGuidelines=false
})
Each additional component:
kendo_accessibility_assistant({
query="What are the accessibility features and requirements for [COMPONENT_NAME]? Include ARIA attributes, keyboard navigation, and screen reader support.",
component="[COMPONENT_NAME]",
includeGeneralGuidelines=false
})
Conditional Phases
Load and execute only the files that matched your Step 1 assessment:
- Component docs needed → read phase-components.md
- Layout needed → read phase-layout.md
- Layout AND responsive needed → also read phase-responsive.md
- Custom theming needed → read phase-theming.md
- Icons needed → read phase-icons.md
Final Phase: Validation & Quality Assurance
Read validation-steps.md and execute all validation steps before considering the task complete.
✅ Completion Checklist
Before considering the task complete, ensure:
- Accessibility guidelines retrieved and applied to all components
-
ng buildcompiles the application successfully without errors - Kendo Design System utilities applied correctly (if layout phase ran)
- Custom theme implemented and applied (if theming phase ran)
- NgModule vs Standalone setup detected and consistently applied